business-ru/check-business-ru-api-lib-php

用于与“Бизнес.Ру ‘Онлайн-чеки’”服务集成的类

dev-master 2021-03-03 06:39 UTC

This package is auto-updated.

Last update: 2024-09-23 17:27:22 UTC


README

安装

  1. 将“OpenApiConnection.php”文件复制到您的服务器上。
  2. 将类导入到应用程序代码中。
  3. 如果 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); // Печать чека возврата прихода.