Download the PHP package alekciy/php-ofd-sdk without Composer
On this page you can find all versions of the php package alekciy/php-ofd-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alekciy/php-ofd-sdk
More information about alekciy/php-ofd-sdk
Files in alekciy/php-ofd-sdk
Package php-ofd-sdk
Short Description Библиотека работает с API операторов фискальных данных (ОФД)
License MIT
Informations about the package php-ofd-sdk
Описание
Библиотека предоставляет унифицированный интерфейс (см. ProviderInterface) работы с различными ОФД (оператор фискальных данных) при получении данных о фискальных документах (чеках).
Основная цель - облегчить интеграцию проекта при работе с разными API операторов. Например, при синхронизации данных о выбитых на кассе чеках и данных ушедших в налоговую.
Поддерживаемые ОФД
Установка
Через composer командой: composer require alekciy/php-ofd-sdk
Пример
Ниже приведен пример работы для Такском и Яндекс.ОФД.
Тесты
В библиотеке используются два вида тестов:
- юнит для проверки правильности работы самой библиотеки;
- интеграционные для проверки работы API заданного ОФД.
Юнит тесты
Для запуска тестов нужно:
- выполнить команду
composer test-unit
.
Интеграционные тесты
Для запуска тестов нужно:
- скопировать файл нужного ОФД (например, taxcom)
tests/credentials/ОФД.example.php
в файлtests/credentials/ОФД.php
; - вписать требуемые реквизиты доступа в
tests/credentials/ОФД.php
; - выполнить команду
composer test-integration-ОФД
.
Основные термины
В таблице приведены термины в порядке удобном для понимания.
ОФД | Оператор Фискальных Данных | Сервис принимающий с кассово аппарата данные о выбитых чеках и передающий их в налоговую службу. |
ККТ | Контрольно Кассовая Техника | Кассовый аппарат выбивающий чеки либо на бумаге, либо в электронном виде. |
ККМ | Контрольно Кассовая Машина | Устаревшее название ККТ. |
ФД | Фискальный Документ | Документ отправляемый в налоговую службу. Кассовый чек является частным случаем ФД. Все типы ФД перечисленые в константах DocumentInterface в виде классов документов. |
ФФД | Формат Фискальных Данных | По сути спецификация описывающая свойства (реквизиты) и их значения, которые могут быть у ФД. Регламентируется приказами ФНС России (на основании 54-ФЗ). Например, приказ № ЕД-7-20/662 По состоянию на 2022 год есть три версии ФФД: 1.0, 1.05, 1.1 и 1.2. |
Тег ФД | - | По сути имя свойства (реквизита) ФД которые передаются в ОФД. Например, в теге 1037 касса передает свой регистрационный номер. Поддерживаемые теги находятся в директории tags. |
All versions of php-ofd-sdk with dependencies
ext-json Version *
ext-mbstring Version *
guzzlehttp/guzzle Version ^6.5
vlucas/valitron Version ^1.4