business-ru / check-business-ru-api-lib-php
用于与“Бизнес.Ру ‘Онлайн-чеки’”服务集成的类
dev-master
2021-03-03 06:39 UTC
Requires
- php: >=5.4.0
- ext-curl: *
- ext-json: *
This package is auto-updated.
Last update: 2024-09-23 17:27:22 UTC
README
安装
- 将“OpenApiConnection.php”文件复制到您的服务器上。
- 将类导入到应用程序代码中。
- 如果 app_id 和 secret_key 存储在您的应用程序端,在创建对象时需要通过参数传递它们,否则请将类的相应常量“STATIC_APP_ID”和“STATIC_SECRET_KEY”改为自己的值。
工作原理
类实现了以下方法
- openShift - 执行开启班次操作;
- closeShift - 执行关闭班次操作;
- printBill - 执行打印进货单据;
- printRefundBill - 执行打印退货单据;
- getSystemStatus - 获取系统状态。
使用示例
开启班次
<?php
include "OpenApiConnector.php"; // Импорт файла с классом
use OpenApiConnector as CONNECTOR;
$connector = new CONNECTOR(); // Создание экземпляра класса
$connector->openShift(); // Выполнение открытия смены
关闭班次
<?php
include "OpenApiConnector.php"; // Импорт файла с классом
use OpenApiConnector as CONNECTOR;
$connector = new CONNECTOR(); // Создание экземпляра класса
$connector->closeShift(); // Выполнение закрытия смены
打印进货单据
<?php
include "OpenApiConnector.php"; // Импорт файла с классом.
use OpenApiConnector as CONNECTOR;
$connector = new CONNECTOR(); // Создание экземпляра класса.
$billArray = [ // Массив с данными чека.
"command" => [ // Массив с данными команды.
"author" => "Тестовый кассир", // (String) Имя кассира (Будет пробито на чеке).
"smsEmail54FZ" => "+79173446170", // (String) Телефон или e-mail покупателя.
"c_num" => 1111222333, // (int) Номер чека.
"payed_cash" => 0.00, // (float) Сумма оплаты наличными (Не более 2-х знаков после точки).
"payed_cashless" => 1500.10 , // (float) Сумма оплаты безаличным рассчетом (Не более 2-х знаков после точки).
"goods" => [ // Массив с позициями в чеке.
[
"count" => 2, // (float) Количество товара (Не более 3-х знаков после точки).
"price" => 500, // (float) Стоимость товара (Не более 2-х знаков после точки).
"sum" => 1000, // (float) Сумма товарной позиции (Не более 2-х знаков после точки).
"name" => "Товар 1", // (String) Наименование товара (Будет пробито на чеке).
"nds_value" => 18, // (int) Значение налога.
"nds_not_apply" => false // (bool) Используется ли НДС для товара.
],
[
"count" => 1,
"price" => 500.10,
"sum" => 500.10,
"name" => "Товар 2",
"nds_value" => 18,
"nds_not_apply" => true
]
]
]
];
$connector->printBill($billArray); // Команда на печать чека прихода.
打印退货单据
<?php
include "OpenApiConnector.php"; // Импорт файла с классом.
use OpenApiConnector as CONNECTOR;
$connector = new CONNECTOR(); // Создание экземпляра класса.
$billArray = [ // Массив с данными чека.
"command" => [ // Массив с данными команды.
"author" => "Тестовй кассир", // (String) Имя кассира (Будет пробито на чеке).
"smsEmail54FZ" => "+79173446170", // (String) Телефон или e-mail покупателя.
"c_num" => 1111222333, // (int) Номер чека.
"payed_cash" => 0.00, // (float) Сумма оплаты наличными (Не более 2-х знаков после точки).
"payed_cashless" => 1500.10 , // (float) Сумма оплаты безаличным рассчетом (Не более 2-х знаков после точки).
"goods" => [ // Массив с позициями в чеке.
[
"count" => 2, // (float) Количество товара (Не более 3-х знаков после точки).
"price" => 500, // (float) Стоимость товара (Не более 2-х знаков после точки).
"sum" => 1000, // (float) Сумма товарной позиции (Не более 2-х знаков после точки).
"name" => "Товар 1", // (String) Наименование товара (Будет пробито на чеке).
"nds_value" => 18, // (int) Значение налога.
"nds_not_apply" => false // (bool) Используется ли НДС для товара.
],
[
"count" => 1,
"price" => 500.10,
"sum" => 500.10,
"name" => "Товар 2",
"nds_value" => 18,
"nds_not_apply" => true
]
]
]
];
$connector->printRefundBill($billArray); // Печать чека возврата прихода.