API

  1. Home
  2. API
  3. Вспомогательные запросы
  4. Получение статуса чека ОФД

Получение статуса чека ОФД

Получить статус чека ОФД можно путем вызова скрипта https://www.platron.ru/get_receipt_status.php. Параметры передаются одним из методов прямого запроса (см. Способы прямого взаимодействия между магазином и Platron). Максимальное время ожидания ответа – 30 секунд.

Список параметров запроса:

Параметр Описание
pg_merchant_id Идентификатор магазина (int)
pg_receipt_id Идентификатор чека полученный в ответе запроса на создание чека
pg_salt Случайная строка
pg_sig Подпись

Пример GET запроса:

https://platron.ru/get_receipt_status.php?pg_merchant_id=82&pg_receipt_id=10000&pg_salt=aaaaaaaaaa&pg_sig=b2c010162d43d2ba98a7f68caee24761

Пример XML запроса (передается POST’ом в параметре pg_xml):

<?xml version="1.0" encoding="utf-8"?>
<request>
	<pg_merchant_id>82</pg_merchant_id>
	<pg_receipt_id>10000</pg_receipt_id>
	<pg_salt>aaaaaaaaaa</pg_salt>
	<pg_sig>b2c010162d43d2ba98a7f68caee24761</pg_sig>
</request>

Ответ на запрос представляет собой XML следующего вида в случае успешного выполнения запроса:

<?xml version="1.0" encoding="utf-8"?>
<response>
	<pg_status>ok</pg_status>
	<pg_receipt_status>ok</pg_receipt_status>
	<pg_fiscal_receipt_number>6</pg_fiscal_receipt_number>
	<pg_shift_number>23</pg_shift_number>
	<pg_receipt_date>2017-04-12 20:16:00</pg_receipt_date>
	<pg_fn_number>1110000100238211</pg_fn_number>
	<pg_ecr_registration_number>0000111118041361</pg_ecr_registration_number>
	<pg_fiscal_document_number>133</pg_fiscal_document_number>
	<pg_fiscal_document_attribute>3449555941</pg_fiscal_document_attribute>
	<pg_salt>aaaaaa</pg_salt>
	<pg_sig>531b7999c74d984fa8c9e1ff029a40d7</pg_sig>
</response>

В случае, если информации по чеку ещё нет:

<?xml version="1.0" encoding="utf-8"?>
<response>
	<pg_salt>9865</pg_salt>
	<pg_status>ok</pg_status>
	<pg_receipt_status>pending</pg_receipt_status>
	<pg_sig>75ed486aa0dfd5363e2e5a87e8e30634</pg_sig>
</response>

В случае ошибки:

<?xml version="1.0" encoding="utf-8"?>
<response>
	<pg_salt>9865</pg_salt>
	<pg_status>error</pg_status>
	<pg_error_code>100</pg_error_code>
	<pg_error_description>Incorrect signature</pg_error_description>
	<pg_sig>4df0f9d237952f56bd05c602d2873ed0</pg_sig>
</response>

Здесь:

pg_status Результат обработки запроса.
pg_error_code Код ошибки
pg_error_description Описание причины ошибки
pg_salt Случайная строка
pg_sig Подпись
pg_receipt_status Статус чека (ok или pending)
pg_fiscal_receipt_number Номер чека в смене.
pg_shift_number Номер смены.
pg_receipt_date Дата и время документа из ФН.
pg_fn_number Номер ФН.
pg_ecr_registration_number Регистрационный номер ККТ.
pg_fiscal_document_number Фискальный номер документа.
pg_fiscal_document_attribute Фискальный признак документа.