README

Бизнес.Ру Онлайн-чеки

关于项目

该库旨在与Бизнес.Ру Онлайн-чеки服务一起使用。

要求

• PHP 7.4及以上
• PHP扩展cURL

安装

composer require business-ru/atol-api-sdk-php

文档：[https://online.atol.ru/files/API_atol_online_v4.pdf](https://online.atol.ru/files/API_atol_online_v4.pdf)

使用

添加到 .env

工作原理

创建用于操作 Atol Api 的文件

<?php
# Подключаем автозагрузку
require 'vendor/autoload.php';
# Подключаем библиотеку Atol Api Client
include 'vendor/business-ru/atol-api-sdk-php/src/AtolClient.php';
# Создание экземпляра класса
$atolApiClient = new AtolClient($this->account, $this->userLogin, $this->integrationPassword);

使用示例

进货

<?php
$params = [
    "timestamp" => date("d.m.Y H:i:s"),
    "external_id" => uniqid('', true),
    "receipt" => [
        "client" => [
            "email" => "test@test.ru"
        ],
        "sno" => "osn",
        "items" => [
            [
                "name" => "Чек Прихода №1",
                "price" => 1,
                "quantity" => 1,
                "sum" => 1,
                "measurement_unit" => "гр.",
                "payment_method" => "full_prepayment",
                "payment_object" => "payment",
                "vat" => [
                    "type" => "vat20",
                ]
            ]
        ],
        "payments" => [
            [
                "type" => 1,
                "sum" => 1
            ]
        ],
        "total" => 1
    ]
];
$sell = $atolApiClient->sell($params);

退货进货

<?php
$params = [
    "timestamp" => date("d.m.Y H:i:s"),
    "external_id" => uniqid('', true),
    "receipt" => [
        "client" => [
            "email" => "test@test.ru"
        ],
        "sno" => "osn",
        "items" => [
            [
                "name" => "Чек Прихода №1",
                "price" => 1,
                "quantity" => 1,
                "sum" => 1,
                "measurement_unit" => "гр.",
                "payment_method" => "full_prepayment",
                "payment_object" => "payment",
                "vat" => [
                    "type" => "vat20",
                ]
            ]
        ],
        "payments" => [
            [
                "type" => 1,
                "sum" => 1
            ]
        ],
        "total" => 1
    ]
];
$sellRefund = $atolApiClient->sellRefund($params);

处理文档的结果

<?php
$uuID = $sellRefund["uuid"];
$atolApiClient->report($uuID);