Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Веб-сервис фискализации

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

...

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

Веб-сервис пакетной фискализации

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

...

Параметр

Обязательное поле

Принимаемые значения

Значение по умолчанию

Описание

chequeid

Да

Число


Идентификатор чека в массиве. Используется для указания на чек, при формировании которого произошла ошибка.

Note

Осуществляется проверка на уникальность идентификатора чека.

Type

Да

Строка


Тип фискализируемого платежа:

·          sell – оказание услуг;

·          sell_refund – возврат.

PaymentType




... все остальные параметры сервиса Fiscalize, начиная c PaymentType за исключением параметров Format и Language.




UserRequisites




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

...

Название

...

Значение

billnumber

Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист

cheques

Набор/массив данных чеков






Параметры элемента массива чеков

Название

Значение

chequeid

Идентификатор чека в массиве

fiscalreceipt_ID

Идентификатор созданного фискального чека

status

Статус созданного фискального чека (чека коррекции)

или


Сообщение об ошибке (если переданы некорректные параметры или не все обязательные параметры)

Пример запроса с минимальным набором параметров:

Code Block
languagexml
{ 
xml
{ 
    "merchant":{
        "merchant_ID":12345677,
        "login":"user",
        "password":"password"
    }, 
    "billnumber":"123445678899012.1",
    "customermerchant":{
        "emailmerchant_ID":"customer@e.mail",12345677,
        "phonelogin":"1376124761user",
    },
    "chequespassword":["password"
       }, {
            "chequeidbillnumber":"123445678899012.1",
    "customer":{
        "typeemail":"sellcustomer@e.mail",
            "paymenttypephone":1,"1376124761"
    },
        "chequeitems""cheques":[
        {
        {
    "chequeid":1,
                "idtype":1"sell",
            "paymenttype":1,
            "namechequeitems":"товар",[
                    "price":3.20,{
                    "quantityid":131,
                    "amountname":41.6"товар",
                    "taxprice":"vat20"3.20,
                    "fpmodequantity":413,
                },
                {"amount":41.6,
                    "idtax":2"vat20",
                    "namefpmode":"услуга",4
                    "price":3.20},
                    "quantity":13,{
                    "amountid":41.62,
                    "taxname":"vat20услуга",
                    "fpmodeprice":43.20,
                }
    "quantity":13,
        ],
            "amount":8341.26,
        },
        {
    "tax":"vat20",
        "chequeid":2,
            "typefpmode":"sell",4
            "paymenttypes":[
    }
        {
     ],
            "paymenttypeamount":1,83.2
        },
         "amount":20{
            }"chequeid":2,
            {
    "type":"sell",
            "paymenttypepaymenttypes":21,[
            {
     "amount":21.6
            }
"paymenttype":1,
         ],
        "chequeitemsamount":[20
            {},
                "id":1,{
                "namepaymenttype":"товар"21,
                "priceamount":321.20,6
                "quantity":13,}
        ],
        "amount":41.6chequeitems":[
            {
                "id":1,
                "taxname":"vat20товар",
                "fpmodeprice":43.20,
            }    "quantity":13,
        ],
        "amount":41.6,
                "tax":"vat20",
                "fpmode":4
            }
        ]
}

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

...

Название

...

Значение

...

billnumber

...

Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист

...

cheques

...

Набор/массив данных чеков

...

Параметры элемента массива чеков

...

Название

...

Значение

...

chequeid

...

Идентификатор чека в массиве

...

fiscalreceipt_ID

...

Идентификатор созданного фискального чека

...

status

...

Статус созданного фискального чека (чека коррекции)

...

или

...

,
        "amount":41.6
        }
    ]
}

Ответ в формате JSON содержит либо массив сформированных чеков (включая их статусы и идентификаторы), либо сообщение об ошибке с указанием ID чека, на котором она произошла.

...