business-ru/open-api-sdk-php

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

1.0.12 2023-10-25 20:07 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *
• monolog/monolog: ^2.6
• psr/log: ^1.0
• psr/simple-cache: ^1.0
• symfony/http-client: ^5.3

proprietary

• Alexandr Nikitin

README

О проекте

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

Требования

• PHP 7.4 и выше
• PHP extension cURL

Установка

composer require 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/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://base-url/open-api/v2/"

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

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

<?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);