| Правильная ссылка на эту статью: |
Интерфейс X23
Интерфейс X23. Отказ от оплаты счета или аннулирование выставленного счета.¶
Кипер, подписывающий запросы, должен иметь персональный аттестат или выше.
- URL для передачи запроса с авторизацией по ключам WM Keeper WinPro - https://w3s.web.money/asp/XMLInvoiceRefusal.asp
- URL для передачи запроса с авторизацией по ключам [[WM Keeper WebPro] - https://w3s.wmtransfer.com/asp/XMLInvoiceRefusalCert.asp
- метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<invoicerefuse>
<wmid></wmid>
<wminvid></wminvid>
</invoicerefuse>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака (Integer), макс. количество цифр - 15; всегда должен быть больше номера запроса на выписывание счета!!! Максимальное значение данного типа данных 140737488355328 |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
| sign | подпись запроса | формируется из параметров: invoicerefuse/wmid+invoicerefuse/WMInvId+reqn используется только при авторизации с ключами WM Keeper WinPro |
| invoicerefuse | параметры аннулируемого счета | |
| invoicerefuse\wmid | WMID выписавшего счет или получателя счета | |
| invoicerefuse\wminvid | номер счета | уникальный номер счета в системе учета WebMoney; соответствует атрибуту "id" параметра "invoice" ответа на запрос по интерфейсу X1 (выписывание счета) |
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<ininvoice id="n1" ts="n2">
<state>3</state>
<dateupd></dateupd>
</ininvoice>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения | 0 - запрос выполнен успешно (остальные значения в таблице код выполнения запроса) |
| retdesc | расшифровка кода выполнения | |
| ininvoice | параметры аннулируемого счета | атрибут id - уникальный номер счета в системе учета WebMoney; атрибут ts - служебный номер счета в системе учета WebMoney |
| ininvoice\state | состояние счета | 0 - не оплачен 1 - оплачен по протекции 2 - оплачен окончательно или без протекции 3 - отказан |
| ininvoice\dateupd | дата и время изменения состояния счета | ГГГГММДД ЧЧ:ММ:СС UTC+3 |
- код выполнения запроса:
| код возврата | описание |
| -100 | общая ошибка при разборе команды. неверный формат команды. |
| -9 | неверное значение поля w3s.request/reqn |
| -8 | неверное значение поля w3s.request/sign |
| -1 | неверное значение поля w3s.request/invoicerefuse/wmid |
| -2 | неверное значение поля w3s.request/invoicerefuse/wminvid |
| -11 | идентификатор, переданный в поле w3s.request/wmid не зарегистрирован |
| -12 | проверка подписи не прошла |
| 102 | не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| 110 | нет прав на использования интерфейса; аттестат не удовлетворяет требованиям |
| 111 | попытка аннулирования счета выставленного не на WMID, которым подписывается запрос, при этом доверие не установлено. Или попытка аннулирования счета выписанного не WMID указанном в параметре invoicerefuse\wmid. |
| 6 | получатель счета не найден |
| 5,7 | отправитель счета не найден |
| 21 | счет не найден |
см. также
Интерфейс X1 — выписывание счета от одного участника другому