Page History
...
Веб-сервис предназначен для тех предприятий, которые используют услугу фискализации через АПК Ассист внешних платежей (проводимых на стороне предприятия). Кроме того, веб-сервис может использоваться тогда, когда появляется возможность сформировать чек, оплата по которому через АПК Ассист была проведена ранее. Также с помощью этого веб-сервиса при необходимости можно создать чек коррекции.
| Note |
|---|
Фискализация осуществляется для платежей только в российских рублях (RUB). |
Веб-сервис позволяет предприятию получить уникальный идентификатор сгенерированного в АПК Ассист фискального чека (или чека коррекции) на основе данных, переданных в запросе.
По идентификатору можно в свою очередь запросить фискальные данные чека из АПК Ассист через отдельный веб-сервис fiscalreceipt. Эти данные используются, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.
...
Процесс фискализации является асинхронным, поэтому в ответе веб-сервиса в большинстве случаев будет возращен статус чека New. Это означает, что чек создан и поставлен в очередь на кассу для фискализации. После получения данных о создании фискального чека в статусе New рекомендуется через несколько минут дополнительно запросить данные фискального чека с помощью веб-сервиса fiscalreceipt (о веб-сервисе fiscalreceipt подробнее см. «Получение фискального чека») для того , чтобы убедиться , что создание в успешном завершении создания фискального чека успешно завершено.
Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует проверить текст ошибки, полученный в поле errortext, а также убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), также рекомендуется дополнительно также рекомендуется запросить данные с помощью веб-сервиса fiscalreceipt и проверить полученный в поле errortext текст ошибки, затем можно повторно направить скорректированный запрос на фискализацию.
Если чек находится в статусе New, то отправлять его на фискализацию повторно нельзя.
...
Название | Значение | |
billnumber | Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист | |
cheques | Набор/массив данных чеков | |
Параметры элемента массива чеков | ||
Название | Значение | |
chequeid | Идентификатор чека в массиве | |
fiscalreceipt_ID | Идентификатор созданного фискального чека | |
status | Статус созданного фискального чека (чека коррекции) | |
...
:
|
Процесс фискализации является асинхронным, поэтому для большинства чеков в ответе будет возвращен статус New - чек подготовлен к формированию. Результат фискализации и подробности по каждому отдельному чеку могут быть получены с помощью веб-сервиса получения фискального чека fiscalreceipt.cfm или веб-сервиса получения нескольких фискальных чеков fiscalreceipts.cfm.
Пример запроса с минимальным набором параметров:
| Code Block | ||
|---|---|---|
| Code Block | ||
| ||
{
"merchant":{
"merchant_ID":12345677,
"login":"user",
"password":"password"
},
"billnumber":"123445678899012.1",
"customer":{
"email":"customer@e.mail",
"phone":"1376124761"
},
"cheques":[
{
"chequeid":1,
"type":"sell",
"paymenttype":1,
"chequeitems":[
{
"id":1,
"name":"товар",
"price":3.20,
"quantity":13,
"amount":41.6,
"tax":"vat20",
"fpmode":4
},
{
"id":2,
"name":"услуга",
"price":3.20,
"quantity":13,
"amount":41.6,
"tax":"vat20",
"fpmode":4
}
],
"amount":83.2
},
{
"chequeid":2,
"type":"sell",
"paymenttypes":[
{
"paymenttype":1,
"amount":20
},
{
"paymenttype":21,
"amount":21.6
}
],
"chequeitems":[
{
"id":1,
"name":"товар",
"price":3.20,
"quantity":13,
"amount":41.6,
"tax":"vat20",
"fpmode":4
}
],
"amount":41.6
}
]
} |
...
| Code Block | ||
|---|---|---|
| ||
{
"billnumber":"123445678899012.1",
"cheques":[
{
"chequeid":1,
"fiscalreceiptid":"12123123",
"status":"NEWNew"
},
{
"chequeid":2,
"fiscalreceiptid":"12123124",
"status":"IN_PROGRESSNew"
}
]
} |
Подробности по каждому отдельному чеку могут быть получены с помощью
...