diswebru/business-ru-open-api-sdk-php

SDK для работы с Open API

1.0.12 2023-11-24 06:38 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *
• monolog/monolog: ^3.3
• psr/log: ^3.0
• psr/simple-cache: ^3.0
• symfony/http-client: ^6.2

proprietary

• Denis Romashkov

README

О проекте

Данная библиотека предназначена для работы с Open API. Вношу правки для работы на более поздних версиях библиотек.

Требования

• PHP 7.4 и выше
• PHP extension cURL
• symfony/http-client ^6.2
• psr/simple-cache ^3.0
• psr/log ^3.0
• monolog/monolog ^3.3

Установка

composer require diswebru/business-ru-open-api-sdk-php

Документация: https://app.swaggerhub.com/apis/Business.Ru/check.business.ru/

Принцип работы

Создаем файл для работы с Open Api

<?php
# Подключаем автозагрузку
require_once __DIR__ . '/../vendor/autoload.php';
# Подключаем библиотеку Open Api Client
require_once __DIR__ . '/../vendor/diswebru/business-ru-open-api-sdk-php/src/OpenClient.php';
# Создание экземпляра класса
$openApiClient = new OpenClient($this->account_url,$this->appID,$this->secret_key);
# Пример ссылки
# ФФД /v1/ - 1.05 /v2/ - 1.2
$this->account_url - "https://check.business.ru/open-api/v1/"

Примеры использования

Информация о состоянии системы

<?php
$openApiClient->getStateSystem();

Открытие смены

<?php
$openApiClient->openShift();

Закрытие смены

<?php
$openApiClient->closeShift();

Печать чека прихода

<?php
$command = [
    "author" => "Тестовый кассир",
    "smsEmail54FZ" => "[e-mail]",
    "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" => "[e-mail]",
    "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);

Вернёт информацию о команде ФР

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