Download the PHP package orangedata/orangedata-client without Composer
On this page you can find all versions of the php package orangedata/orangedata-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download orangedata/orangedata-client
More information about orangedata/orangedata-client
Files in orangedata/orangedata-client
Download orangedata/orangedata-client
More information about orangedata/orangedata-client
Files in orangedata/orangedata-client
Vendor orangedata
Package orangedata-client
Short Description Example client API class for OrangeData project
License
Package orangedata-client
Short Description Example client API class for OrangeData project
License
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package orangedata-client
PHPOrangeData
PHP integration for OrangeData service
Актуальная версия библиотеки: 4.0.0
Версия PHP: 5.6.6+
Версия протокола взаимодействия с интернет кассой: 2.29.1 от 15.11.2023
Содержание
-
Начало работы
- Подключение библиотеки
- Создание клиента
-
Заказ
-
Создание заказа
- Добавление позиции в заказ
- Добавление оплаты в заказ
- Добавление агента в заказ
- Добавление дополнительного реквизита пользователя
- Добавление дополнительных полей
- Добавление вендинга в заказ
- Добавление курьера в заказ
- Отправка заказа
- Проверка статуса заказа
-
Создание заказа
-
Чек коррекции
- Создание чека коррекции ФФД1.05
- Отправка чека коррекции ФФД1.05
- Создание чека коррекции ФФД1.2
- Отправка чека коррекции ФФД1.2
- Добавление вендинга в чек коррекции
- Добавление курьера в чек коррекции
- Добавление дополнительных аттрибутов, позиции и оплаты в чек коррекции (только для ФФД1.2)
- Проверка статуса чека коррекции
Начало работы
Подключение библиотеки
Для начала работы необходимо подключить файл класса:
Создание клиента
Cвойства клиента
| Имя | Обязательное поле | Описание |
|---|---|---|
| inn | Да | ИНН организации (строка от 1 до 64) |
| api_url | Да | Порт, на который будем отправлять запросы или Адрес API или прокси |
| sign_pkey | Да | Путь к приватному ключу, который используется для подписи "чека" |
| ssl_client_key | Да | Путь к приватному ключу используемому для 2ssl взаимодействия |
| ssl_client_crt | Да | Путь к клиентскому сертификату используемому для 2ssl |
| ssl_ca_cert | Да | Путь к cacert.pem |
| ssl_client_crt_pass | Да | Пароль к клиентскому сертификату |
Для включения записи логов в файл 'curl.log', прописываем:
Заказ
Создание заказа
После того, как создали клиента, можно приступить к созданию заказа.
Cвойства заказа
| Имя | Обязательное поле | Описание |
|---|---|---|
| id | Да | Идентификатор документа (строка от 1 до 64) |
| type | Да | 1 - Приход 2 - Возврат прихода 3 - Расход 4 - Возврат расхода |
| customerContact | Да | Телефон или электронный адрес покупателя (строка от 1 до 64) |
| taxationSystem | Да | 0 - Общая, ОСН 1 - Упрощенная доход, УСН доход 2 - Упрощенная доход минус расход, УСН доход - расход 3 - Единый налог на вмененный доход, ЕНВД 4 - Единый сельскохозяйственный налог, ЕСН 5 - Патентная система налогообложения, Патент |
| key | Да | Название ключа, который должен быть использован для проверки подпись. Для клиентов используется их ИНН, для партнеров и платежных агентов код с маской 301, для вендинга 401 (cтрока от 1 до 32 ) |
| group | Да | Группа устройств, с помощью которых будет пробит чек (строка от 1 до 32 символов), по умолчанию 'Main'. Чтобы работать с ФФД1.2 - 'Main_2' |
| ffdVersion | Нет | Версия ФФД. 2 - ФФД1.05 4 - ФФД1.2 По умолчанию - 2 |
| ignoreItemCodeCheck | Нет | Булево значение, указывающее стоит ли игнорировать проверку КМ. Если флаг не указан, то для формирования чека все КМ должны успешно пройти проверку: в тэге 2106 биты номер 0, 1, 2, 3 имеют состояние «1» Если же флаг не указан и КМ не прошел проверку чек не будет сформирован и запрос статуса будет возвращать статус 422 Unprocessable Entity. По умолчанию - false |
Добавление позиции в заказ
Cвойства позиции
| Имя | Обязательное поле | Описание |
|---|---|---|
| quantity | Да | Количество предмета расчета (десятичное число) |
| price | Да | Цена за единицу предмета расчета с учетом скидок и наценок (десятичное число) |
| tax | Да | Ставка НДС: 1 - ставка НДС 20% 2 - ставка НДС 10% 3 - ставка НДС расч. 20/120 4 - ставка НДС расч. 10/110 5 - ставка НДС 0% 6 - НДС не облагается |
| taxSum | Сумма НДС за предмет расчета (Десятичное число) Параметр актуален дляставок НДС 1-4. Для ставок 5 и 6 данный тэг в предмете расчета не передается, переданное значение игнорируется. |
|
| text | Да | Наименование предмета расчета (строка до 128 символов) |
| paymentMethodType | Да | Признак способа расчета: 1 - Предоплата 100% 2 - Частичная предоплата 3 - Аванс 4 - Полный расчет 5 - Частичный расчет и кредит 6 - Передача в кредит 7 - оплата кредита |
| paymentSubjectType | Да | Признак предмета расчета: 1 - Товар 2 - Подакцизный товар 3 - Работа 4 - Услуга 5 - Ставка азартной игры 6 - Выигрыш азартной игры 7 - Лотерейный билет 8 - Выигрыш лотереи 9 - Предоставление РИД 10 - Платеж 11 - Агентское вознаграждение 12 - Составной предмет расчета 13 - Иной предмет расчета 14 - Имущественное право 15 - Внереализационный доход 16 - Страховые взносы 17 - Торговый сбор 18 - Курортный сбор 19 - Залог 20 – Расход 21 – Взносы на обязательное пенсионное страхование ИП 22 – Взносы на обязательное пенсионное страхование 23 – Взносы на обязательное медицинское страхование ИП 24 – Взносы на обязательное медицинское страхование 25 – Взносы на обязательное социальное страхование 26 – Платеж казино 27 – Выдача денежных средств 30 – АТНМ (не имеющем кода маркировки) 31 – АТМ (имеющем код маркировки) 32 – ТНМ 33 – ТМ |
| nomenclatureCode | Код товарной номенклатуры (строка, содержащая base64 кодированный массив от 1 до 32 байт) | |
| itemCode | Код маркировки (Строка от 1 до 223 символов) | |
| supplierInfo | Данные поставщика (смотреть "Свойства supplierInfo") | |
| supplierINN | ИНН поставщика (строка длиной от 10 до 12 символов) | |
| agentType | Признак агента по предмету расчета (Число от 1 до 127) | |
| agentInfo | Данные агента (смотреть "Свойства agentInfo") | |
| unitOfMeasurement | Единица измерения предмета расчета (строка от 1 до 16) | |
| quantityMeasurementUnit | Мера количества предмета расчета (Число от 0 до 255, если не указан – 0) | |
| additionalAttribute | Дополнительный реквизит предмета расчета (строка от 1 до 64) | |
| manufacturerCountryCode | Код страны происхождения товара (строка длиной от 1 до 3 ) | |
| customsDeclarationNumber | Номер таможенной декларации (строка от 1 до 32) | |
| excise | Акциз (десятичное число) | |
| industryAttribute | Отраслевой реквизит чека (смотреть "Свойства industryAttribute") | |
| unitTaxSum | Размер НДС за единицу предмета расчета (десятичное число) | |
| plannedStatus | Планируемый статус (Число от 0 до 256) 1 Штучный товар, подлежащий обязательной маркировке средством идентификации, реализован 2 Мерный товар, подлежащий обязательной маркировке средством идентификации, в стадии реализации, 3 Штучный товар, подлежащий обязательной маркировке средством идентификации, возвращен, 4 Часть товара, подлежащего обязательной маркировке средством идентификации, возвращена, 255 Статус товара, подлежащего обязательной маркировке средством идентификации, не изменился |
|
| fractionalQuantity | Дробное количество маркированного товара (смотреть "Свойства fractionalQuantity") | |
| barcodes | Штрих-коды предмета расчета (смотреть "Свойства barcodes") |
Параметры nomenclatureCode, unitOfMeasurement используются для ФФД 1.05
Параметры itemCode, quantityMeasurementUnit, industryAttribute, plannedStatus, fractionalQuantity, barcodes используются для ФФД 1.2
Cвойства supplierInfo
| Имя | Обязательное поле | Описание |
|---|---|---|
| phoneNumbers | Номера телефонов поставщика (массив строк длиной от 1 до 19 символов) | |
| name | Наименование поставщика (строка до 239 символов) |
Cвойства agentInfo
| Имя | Обязательное поле | Описание |
|---|---|---|
| paymentTransferOperatorPhoneNumbers | Телефон оператора перевода (массив строк длиной от 1 до 19 символов) | |
| paymentAgentOperation | Операция платежного агента (строка до 24 символов) | |
| paymentAgentPhoneNumbers | Телефон платежного агента (массив строк длиной от 1 до 19 символов) | |
| paymentOperatorPhoneNumbers | Телефон оператора по приему платежей (массив строк длиной от 1 до 19 символов) | |
| paymentOperatorName | Наименование оператора перевода (строка до 64 символов) | |
| paymentOperatorAddress | Адрес оператора перевода (строка до 243 символов) | |
| paymentOperatorINN | ИНН оператора перевода (cтрока длиной от 10 до 12 символов) |
Cвойства industryAttribute
| Имя | Обязательное поле | Описание |
|---|---|---|
| foivId | Идентификатор ФОИВ | |
| causeDocumentDate | Дата документа основания | |
| causeDocumentNumber | Номер документа основания | |
| value | Значение отраслевого реквизита |
Cвойства fractionalQuantity
| Имя | Обязательное поле | Описание |
|---|---|---|
| Numerator | Числитель (Целое беззнаковое число) | |
| Denominator | Знаменатель (Целое беззнаковое число) |
Cвойства barcodes
| Имя | Обязательное поле | Описание |
|---|---|---|
| ean8 | КТ EAN-8 (Строка 8 символов) | |
| ean13 | КТ EAN-13 (Строка 13 символов) | |
| itf14 | КТ ITF-14 (Строка 14 символов) | |
| gs1 | КТ GS1.0 (Строка от 1 до 38 символов) | |
| mi | КТ МИ (Строка 20 символов) | |
| egais20 | КТ ЕГАИС-2.0 (Строка 23 символов) | |
| egais30 | КТ ЕГАИС-3.0 (Строка 14 символов) | |
| f1 | КТ Ф.1 (Строка от 1 до 32 символов) | |
| f2 | КТ Ф.2 (Строка от 1 до 32 символов) | |
| f3 | КТ Ф.3 (Строка от 1 до 32 символов) | |
| f4 | КТ Ф.4 (Строка от 1 до 32 символов) | |
| f5 | КТ Ф.5 (Строка от 1 до 32 символов) | |
| f6 | КТ Ф.6 (Строка от 1 до 32 символов) |
Добавление оплаты в заказ
Cвойства оплаты
| Имя | Обязательное поле | Описание |
|---|---|---|
| type | Да | Тип оплаты: 1 - сумма по чеку наличными, 1031 2 - сумма по чеку безналичными, 1081 14 - сумма по чеку предоплатой (зачетом аванса и (или) предыдущих платежей), 1215 15 - сумма по чеку постоплатой (в кредит), 1216 16 - сумма по чеку (БСО) встречным предоставлением, 1217 |
| amount | Да | Сумма оплаты (десятичное число) |
Добавление агента в заказ
Не поддерживается для ФФД1.2
Cвойства агента
| Имя | Обязательное поле | Описание |
|---|---|---|
| agentType | Признак агента по предмету расчета (число от 1 до 127) | |
| paymentTransferOperatorPhoneNumbers | Телефон оператора перевода (массив строк длиной от 1 до 19 символов) | |
| paymentAgentOperation | Операция платежного агента (строка до 24 символов) | |
| paymentAgentPhoneNumbers | Телефон платежного агента (массив строк длиной от 1 до 19 символов) | |
| paymentOperatorPhoneNumbers | Телефон оператора по приему платежей (массив строк длиной от 1 до 19 символов) | |
| paymentOperatorName | Наименование оператора перевода (строка до 64 символов) | |
| paymentOperatorAddress | Адрес оператора перевода (строка до 243 символов) | |
| paymentOperatorINN | ИНН оператора перевода (cтрока длиной от 10 до 12 символов) | |
| supplierPhoneNumbers | Телефон поставщика (массив строк длиной от 1 до 19 символов) |
Добавление дополнительного реквизита пользователя
Cвойства дополнительного реквизита пользователя
| Имя | Обязательное поле | Описание |
|---|---|---|
| name | Наименование дополнительного реквизита пользователя (строка от 1 до 64 символов) | |
| value | Значение дополнительного реквизита пользователя (строка от 1 до 234 символов) |
Добавление дополнительных полей
Cвойства дополнительных полей
| Имя | Обязательное поле | Описание |
|---|---|---|
| additionalAttribute | Дополнительный реквизит чека(БСО) (строка от 1 до 16 символов) | |
| customer | Покупатель (клиент) (строка от 1 до 243 символов) | |
| customerINN | ИНН покупателя (клиента) (Строка длиной от 10 до 12 символов) | |
| customerInfo | Сведения о покупателе (смотреть "Свойства customerInfo") | |
| senderEmail | Адрес электронной почты отправителя чека (Строка от 1 до 64 символов) | |
| operationalAttribute | Операционный реквизит чека (смотреть "Свойства operationalAttribute") | |
| industryAttribute | Отраслевой реквизит чека (смотреть "Свойства industryAttribute") | |
| totalSum | Сумма расчета, указанного в чеке (БСО) (десятичное число) Форматы Фискальных Документов допускают в данном поле округление в нижнюю сторону. Дословно требование ФФД звучит так: «Значение в рублях, без учета копеек, должно быть равно значению суммы всех реквизитов «стоимость предмета расчета с учетом скидок и наценок» (тег 1043) в рублях, без учета копеек». Во избежание нестыковок рекомендуем использовать точное значение без округлений. |
|
| vat1Sum | Сумма НДС чека по ставке 20% (десятичное число) | |
| vat2Sum | Сумма НДС чека по ставке 10% (десятичное число) | |
| vat3Sum | Сумма расчета по чеку с НДС по ставке 0% (десятичное число) | |
| vat4Sum | Сумма расчета по чеку без НДС (десятичное число) | |
| vat5Sum | Сумма НДС чека по расч. ставке 20/120 (десятичное число) | |
| vat6Sum | Сумма НДС чека по расч. ставке 10/110 (десятичное число) |
Cвойства customerInfo
| Имя | Обязательное поле | Описание |
|---|---|---|
| name | Покупатель (Строка от 1 до 239 символов) | |
| inn | ИНН покупателя (Строка длиной от 10 до 12 символов, формат ЦЦЦЦЦЦЦЦЦЦ) | |
| birthDate | Дата рождения покупателя (Строка 10 символов, формат ДД.ММ.ГГГГ) | |
| citizenship | Гражданство (Строка длиной от 1 до 3 символов, формат ЦЦЦ. Сервис автоматически дополнит строку до 3 символов пробелами) | |
| identityDocumentCode | Код вида документа, удостоверяющего личность (Строка длиной 2 символа, формат ЦЦ) | |
| identityDocumentData | Данные документа, удостоверяющего личность (Строка до 64 символов) | |
| address | Адрес покупателя (Строка от 1 до 239 символов) |
Cвойства operationalAttribute
| Имя | Обязательное поле | Описание |
|---|---|---|
| date | Дата, время операции (Время в виде строки в формате ISO8601) | |
| id | Идентификатор операции (Число от 0 до 255) | |
| value | Данные операции (Строка от 1 до 64 символов) |
Cвойства industryAttribute
| Имя | Обязательное поле | Описание |
|---|---|---|
| foivId | Идентификатор ФОИВ | |
| causeDocumentDate | Дата документа основания | |
| causeDocumentNumber | Номер документа основания | |
| value | Значение отраслевого реквизита |
Для ФФД1.2 Параметры Customer и customerINN изменяется на один параметр customerInfo.
Добавление вендинга в заказ
Cвойства вендинга
| Имя | Обязательное поле | Описание |
|---|---|---|
| automatNumber | Номер автомата (строка от 1 до 20 символов) | |
| settlementAddress | Адрес расчетов (строка от 1 до 243 символов) | |
| settlementPlace | Место расчетов (Строка длиной от 10 до 12 символов) |
Добавление курьера в заказ
Cвойства курьера
| Имя | Обязательное поле | Описание |
|---|---|---|
| settlementAddress | Адрес расчетов (строка от 1 до 243 символов) | |
| settlementPlace | Место расчетов (Строка длиной от 10 до 12 символов) | |
| cashier | Кассир (Строка длиной от 1 до 64 символов) | |
| cashierINN | ИНН кассира (Строка длиной 12 символов) |
Отправка заказа
После того, как заполнены все поля заказа и добавлены все параметры, можно отправлять заказ на обработку:
Проверка статуса заказа
Чек коррекции
Создание чека коррекции ФФД1.05
Cвойства чека коррекции
| Имя | Обязательное поле | Описание |
|---|---|---|
| id | Да | Идентификатор документа (строка от 1 до 64 символов) |
| group | Да | Группа устройств, с помощью которых будет пробит чек (строка от 1 до 32 символов), по умолчанию 'Main' |
| key | Да | Название ключа, который должен быть использован для проверки подписи (строка от 1 до 32 символов) |
| correctionType | Да | Тип коррекции 1173: 0. Самостоятельно 1. По предписанию |
| type | Да | Признак расчета, 1054: 1. Приход 3. Расход |
| description | Да | Описание коррекции (cтрока от 1 до 243 символов. ) |
| causeDocumentDate | Да | Дата документа основания для коррекции (время в виде строки в формате ISO8601) |
| causeDocumentNumber | Да | Номер документа основания для коррекции (строка от 1 до 32 символов) |
| totalSum | Да | Сумма расчета, указанного в чеке (десятичное число) |
| cashSum | Сумма по чеку (БСО) наличными (десятичное число) | |
| eCashSum | Сумма по чеку (БСО) безналичными (десятичное число) | |
| prepaymentSum | Сумма по чеку (БСО) предоплатой (зачетом аванса и (или) предыдущих платежей) (десятичное число) | |
| postpaymentSum | Сумма по чеку (БСО) постоплатой (в кредит) (десятичное число) | |
| otherPaymentTypeSum | Сумма по чеку (БСО) встречным предоставлением (десятичное число) | |
| tax1Sum | Сумма НДС чека по ставке 20% (десятичное число) | |
| tax2Sum | Сумма НДС чека по ставке 10% (десятичное число) | |
| tax3Sum | Сумма расчета по чеку с НДС по ставке 0% (десятичное число) | |
| tax4Sum | Сумма расчета по чеку без НДС (десятичное число) | |
| tax5Sum | Сумма НДС чека по расч. ставке 20/120 (десятичное число) | |
| tax6Sum | Сумма НДС чека по расч. ставке 10/110 (десятичное число) | |
| taxationSystem | Применяемая система налогообложения, 1055: 0. Общая 1. Упрощенная доход 2. Упрощенная доход минус расход 3. Единый налог на вмененный доход 4. Единый сельскохозяйственный налог 5. Патентная система налогообложения |
|
| ignoreItemCodeCheck | Булево значение, указывающее стоит ли игнорировать проверку КМ. Если флаг не указан, то для формирования чека все КМ должны успешно пройти проверку: в тэге 2106 биты номер 0, 1, 2, 3 имеют состояние «1» Если же флаг не указан и КМ не прошел проверку чек не будет сформирован и запрос статуса будет возвращать статус 422 Unprocessable Entity. По умолчанию - false |
Отправка чека коррекции ФФД1.05
Создание чека коррекции ФФД1.2
Cвойства чека коррекции
| Имя | Обязательное поле | Описание |
|---|---|---|
| id | Да | Идентификатор документа (строка от 1 до 64 символов) |
| group | Да | Группа устройств, с помощью которых будет пробит чек (строка от 1 до 32 символов), по умолчанию 'Main_2' |
| inn | Да | ИНН организации, для которой пробивается чек |
| key | Да | Название ключа, который должен быть использован для проверки подписи (строка от 1 до 32 символов) |
| correctionType | Да | Тип коррекции 1173: 0. Самостоятельно 1. По предписанию |
| type | Да | Признак расчета, 1054: 1. Приход 3. Расход |
| customerContact | Да | Телефон или электронный адрес покупателя |
| ffdVersion | Да | Номер версии, по умолчанию - 4 (ФФД1.2). Для ФФД1.05 - используйте create_correction |
| description | Да | Описание коррекции (cтрока от 1 до 243 символов. ) |
| causeDocumentDate | Да | Дата документа основания для коррекции (время в виде строки в формате ISO8601) |
| causeDocumentNumber | Да | Номер документа основания для коррекции (строка от 1 до 32 символов) |
| totalSum | Сумма расчета, указанного в чеке (десятичное число) | |
| vat1Sum | Сумма НДС чека по ставке 20% (десятичное число) | |
| vat2Sum | Сумма НДС чека по ставке 10% (десятичное число) | |
| vat3Sum | Сумма расчета по чеку с НДС по ставке 0% (десятичное число) | |
| vat4Sum | Сумма расчета по чеку без НДС (десятичное число) | |
| vat5Sum | Сумма НДС чека по расч. ставке 20/120 (десятичное число) | |
| vat6Sum | Сумма НДС чека по расч. ставке 10/110 (десятичное число) | |
| taxationSystem | Применяемая система налогообложения, 1055: 0. Общая 1. Упрощенная доход 2. Упрощенная доход минус расход 3. Единый налог на вмененный доход 4. Единый сельскохозяйственный налог 5. Патентная система налогообложения |
|
| ignoreItemCodeCheck | Булево значение, указывающее стоит ли игнорировать проверку КМ. Если флаг не указан, то для формирования чека все КМ должны успешно пройти проверку: в тэге 2106 биты номер 0, 1, 2, 3 имеют состояние «1» Если же флаг не указан и КМ не прошел проверку чек не будет сформирован и запрос статуса будет возвращать статус 422 Unprocessable Entity. По умолчанию - false |
Отправка чека коррекции ФФД1.2
Добавление вендинга в чек коррекции
Cвойства вендинга
| Имя | Обязательное поле | Описание |
|---|---|---|
| automatNumber | Номер автомата (строка от 1 до 20 символов) | |
| settlementAddress | Адрес расчетов (строка от 1 до 243 символов) | |
| settlementPlace | Место расчетов (Строка длиной от 10 до 12 символов) |
Добавление курьера в чек коррекции
Cвойства курьера
| Имя | Обязательное поле | Описание |
|---|---|---|
| settlementAddress | Адрес расчетов (строка от 1 до 243 символов) | |
| settlementPlace | Место расчетов (Строка длиной от 10 до 12 символов) | |
| cashier | Кассир (Строка длиной от 1 до 64 символов) | |
| cashierINN | ИНН кассира (Строка длиной 12 символов) |
Добавление дополнительных аттрибутов, позиции и оплаты в чек коррекции (только для ФФД1.2)
Cвойства функций см. в аналогичных блоках для заказа
Проверка статуса чека коррекции
All versions of orangedata-client with dependencies
PHP Build Version
Package Version
Requires
php Version
>=5.6.0
ext-mbstring Version *
ext-json Version *
ext-curl Version *
ext-openssl Version *
ext-mbstring Version *
ext-json Version *
ext-curl Version *
ext-openssl Version *
The package orangedata/orangedata-client contains the following files
Loading the files please wait ....