README

原始包链接: https://github.com/business-ru/open-api-sdk-php

项目介绍

本库旨在用于操作 Open API。

要求

• PHP 8.1 及以上版本
• PHP 扩展 cURL

安装

composer require gleb-sokolkov/open-api-sdk-php

文档: https://app.swaggerhub.com/apis/Business.Ru/check.business.ru/

工作原理

创建用于操作 Open API 的文件

<?php
# Текущее местоположение проекта
$projectDIR = dirname(__DIR__);

# Подключение автозагрузки
require_once $projectDIR . '/vendor/autoload.php';
# Подключение библиотеки Open Api Client
require_once $projectDIR . '/vendor/business-ru/open-api-sdk-php/src/OpenClient.php';

use BusinessRU\Open\Api\OpenClient;


# Для ФФД /v1/ - 1.05
$accountUrl = 'https://check.business.ru/open-api/v1/';

# Для ФФД /v2/ - 1.2
# $accountUrl = 'https://check.business.ru/open-api/v2/';

# Данные клиента
$appID = '';
$secretKey = '';

# Создание экземпляра класса
$openApiClient = new OpenClient($accountUrl, $appID, $secretKey);

使用示例

系统状态信息

<?php
$openApiClient->getStateSystem();

开启班次

<?php
$openApiClient->openShift();

关闭班次

<?php
$openApiClient->closeShift();

打印收入收据

<?php
$command = [
    "author" => "Тестовый кассир",
    "smsEmail54FZ" => "test@test.ru",
    "c_num" => "1111222333",
    "payed_cashless" => 1000,
    "goods" => [
        [
            "count" => 2,
            "price" => 500,
            "sum" => 1000,
            "name" => "Товар 1",
            "nds_value" => 20,
            "nds_not_apply" => false,
            "payment_mode" => 1,
            "item_type" => 1
        ]
    ]
];
$openApiClient->printCheck($command);

打印收入退货收据

<?php
$command = [
    "author" => "Тестовый кассир",
    "smsEmail54FZ" => "test@test.ru",
    "c_num" => "1111222333",
    "payed_cashless" => 1000,
    "goods" => [
        [
            "count" => 2,
            "price" => 500,
            "sum" => 1000,
            "name" => "Товар 1",
            "nds_value" => 20,
            "nds_not_apply" => false,
            "payment_mode" => 1,
            "item_type" => 1
        ]
    ]
];
$openApiClient->printPurchaseReturn($command);

返回 FR 团队信息

<?php
$commandID = "command_id"
$openApiClient->dataCommandID($commandID);