business-ru/atol-api-sdk-php

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

1.0.9 2023-05-19 07:18 UTC

Requires

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

proprietary

• Alexandr Nikitin

README

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

О проекте

Данная библиотека предназначена для работы с сервисом Бизнес.Ру Онлайн-чеки.

Требования

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

Установка

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

Документация: 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" => "[e-mail]"
        ],
        "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" => "[e-mail]"
        ],
        "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);