Получение фискального чека

Получение стандартного чека

Веб-сервис получения фискального чека позволяет предприятию получить сгенерированный в АПК Ассист фискальный чек. Такая возможность используется, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.

Для обращения к веб сервису необходимо отправить запрос на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fiscalreceipt.cfm. 

Параметры передаются методом POST в теле запроса в формате «ключ=значение», SOAP запросом, либо в формате JSON (swagger описание: https://docs.assist.ru/swagger/). 

Входные параметры сервиса:

*должен быть передан либо параметр Billnumber (тогда в ответе будет возвращен чек реальной операции), либо параметр Payment_ID (тогда в ответе будет возвращен чек внешней операции, созданный через веб-сервис фискализации внешних операций fiscalize), либо Fiscalreceipt_ID (если он известен), несколько параметров одновременно передавать нельзя.

Если фискальный чек для указанной в запросе операции существует, то в ответе передаются параметры этого фискального чека (см. табл. «Перечень возвращаемых параметров»).

Перечень возвращаемых параметров:

*дополнительные параметры для полного набора данных чека.

Если запрос на получение фискального чека не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.

Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), затем повторно направить скорректированный запрос на фискализацию с помощью используемого сервиса.

Примеры ошибок, которые могут быть получены в поле errortext:

• Ошибка в сумме позиции или сумме чека.
• Ошибка в заполнении способа расчета.
• Ошибка при работе с чеком.
• Ошибка в описании позиций чека.
• Идентификатор (id) позиции чека не является уникальным.
• Неправильные значения сумм по способам оплаты.
• Ошибка в параметре системы налогообложения.
• Некорректное значение ставки налога.
• Не получен статус фискального чека.
• Неверный тип данных.
• Ошибка формата ввода данных или незаполненное поле.
• Неверный терминал.
• Ошибка при работе со сменами.
• Аппаратная ошибка ККТ или ФН.

Получение нескольких чеков при пакетной фискализации

Веб-сервис получения нескольких фискальных чеков позволяет предприятию получить сгенерированные в АПК Ассист фискальные чеки в случае пакетной фискализации.

Для обращения к веб сервису необходимо отправить запрос методом JSON (swagger описание: https://docs.assist.ru/swagger/) на сервер ASSIST по адресу: https://<SERVER_NAME>/fiscal/fiscalreceipts.cfm.

Входные параметры сервиса:

* необходимо передать либо login и password, любо token.

** необходимо передать либо параметр billnumber, либо оба параметра, определяющих период - startdate и enddate.

Если фискальные чеки для указанной в запросе операции существуют, то в ответе передаются параметры этих фискальных чеков (см. табл. «Перечень возвращаемых параметров»).

Перечень возвращаемых параметров:

^*Текст ошибки возвращается в том в случае, если в запросе был передан параметр Billnumber, в противном случае возвращается ID ошибки.

Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, или ID полученной ошибки, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), затем повторно направить скорректированный запрос на фискализацию с помощью используемого сервиса.

Если запрос на получение фискального чека не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.

Пример запроса по параметрам login и password:

{ 
    "merchant":{
        "merchant_ID":12345677,
        "login":"user",
        "password":"password"
    }, 
    "billnumber":"123445678899012.1",
    },

Пример запроса по параметру token:

{ 
    "merchant":{
        "merchant_ID":12345677,
        "token":"144FB671-62A0-48E9-1048-0DDA319E8B6D"
    }, 
    "billnumber":"123445678899012.1",
    },

Пример запроса по периоду:

{
    "merchant":{
         "merchant_ID":960400,
         "login":"user", 
         "password":"password"     
    },
    "startdate":"2021-02-16T10:55",
    "enddate":"2021-02-16T11:00"
}

Пример ответа:

{"cheques":[
        [{"fiscalreceipt_id": 630362,
           "fiscal_document_attribute": "1555826222",
           "fiscal_document_number": "445",
           "created":"2021-02-16T10:55:24",
           "chequeitems": [  {"id": 0,"name": "Товар","price": 11,"quantity": 1,"amount": 11,"tax": "vat20","fpmode": 1},  {"id": 1,"name": "Товар","price": 22,"quantity": 1,"amount": 22,"tax": "vat20","fpmode": 1}],
           "fn_number": "9999078900011438",
           "status": "Success",
           "url": "http://s.t.assist.ru/e/YDT-8Mf4c",
           "shift_number": "110",
           "errortext": " ",
           "payment_id": " ",
           "ecr_registration_number": "0000000001046274",
           "total": 33,
           "receipt_datetime": "2021-02-16T14:01:00",
           "fiscal_receipt_number": 1,
           "billnumber": "5635459249850000.1",
           "taxationsystem": 0,
           "operation": "sell",
           "taxsystemname": "ОСН"},
         {"fiscalreceipt_id": 630363,
           "fiscal_document_attribute": "1437895935",
           "fiscal_document_number": "446",
           "created":"2021-02-16T10:55:24",
           "chequeitems": [  {"id": 2,"name": "Товар","price": 33,"quantity": 1,"amount": 33,"tax": "vat20","fpmode": 1}],
           "fn_number": "9999078900011438",
           "status": "Success",
           "url": "http://s.t.assist.ru/e/LMh8qKKVd",
           "shift_number": "110",
           "errortext": " ",
           "payment_id": " "l,
           "ecr_registration_number": "0000000001046274",
           "total": 33,
           "receipt_datetime": "2021-02-16T14:01:00",
           "fiscal_receipt_number": 2,
           "billnumber": "5635459249850000.1",
           "taxationsystem": 0,
           "operation": "sell",
           "taxsystemname": "ОСН"}],
}

Наверх