Кипер, подписывающий запросы, должен иметь персональный аттестат или выше.
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <invoice> <orderid></orderid> <customerwmid></customerwmid> <storepurse></storepurse> <amount></amount> <desc></desc> <address></address> <period></period> <expiration></expiration> </invoice> </w3s.request>
| название | назначение | примечание |
|---|---|---|
| reqn | номер запроса | целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса на выписывание счета!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper Classic |
| sign | подпись запроса | формируется из параметров: orderid+customerwmid+storepurse+amount+desc+address+period+expiration+reqn используется только при авторизации с ключами WM Keeper Classic |
| invoice | параметры выписываемого счета | |
| invoice\orderid | номер счета | номер счета в системе учета магазина; любое целое число без знака |
| invoice\customerwmid | WMID покупателя | |
| invoice\storepurse | кошелек для оплаты | номер кошелька, на который необходимо оплатить счет |
| invoice\amount | сумма счета | число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) |
| invoice\desc | описание товара или услуги | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются, кодировка win-1251 |
| invoice\address | адрес доставки товара | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются |
| invoice\period | срок протекции сделки | максимально допустимый срок протекции в днях; при оплате счета целое число от 0 до 255; если 0 – протекция сделки при оплате счета не разрешена. При выписке счета для получения средств на WMD-кошелек – максимальный срок возврата кредита в днях. |
| invoice\expiration | срок оплаты счета | максимально допустимый срок оплаты в днях; целое число от 0 до 255; если 0 – срок оплаты не определен |
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <invoice id="n1" ts="n2"> <orderid></orderid> <customerwmid></customerwmid> <storepurse></storepurse> <amount></amount> <desc></desc> <address></address> <period></period> <expiration></expiration> <state>0</state> <datecrt></datecrt> <dateupd></dateupd> </invoice> </w3s.response>
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения | 0 – запрос выполнен успешно (остальные значения в таблице код выполнения запроса) |
| retdesc | расшифровка кода выполнения | |
| invoice | параметры выписанного счета | атрибут id – уникальный номер счета в системе учета WebMoney; атрибут ts – служебный номер счета в системе учета WebMoney |
| invoice\orderid | номер счета | номер счета в системе учета магазина; любое целое число без знака |
| invoice\customerwmid | WMID покупателя | |
| invoice\storepurse | номер кошелька для оплаты | |
| invoice\amount | сумма счета для оплаты | число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) |
| invoice\desc | описание товара или услуги | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются |
| invoice\address | адрес доставки товара | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются |
| invoice\period | срок протекции сделки | максимально допустимый срок протекции при оплате счета в днях; целое число от 0 до 255; если 0 – протекция сделки при оплате счета не разрешена. При выписке счета для получения средств на WMD-кошелек – максимальный срок возврата кредита в днях. |
| invoice\expiration | срок оплаты счета | максимально допустимый срок оплаты счета в днях; целое число от 0 до 255; если 0 – срок оплаты не определен |
| invoice\state | состояние счета | 0 – не оплачен 1 – оплачен по протекции 2 – оплачен окончательно или без протекции 3 – отказан |
| invoice\datecrt | дата и время создания счета | ГГГГММДД ЧЧ:ММ:СС |
| invoice\dateupd | дата и время изменения состояния счета | ГГГГММДД ЧЧ:ММ:СС |
| код возврата | описание |
| -100 | общая ошибка при разборе команды. неверный формат команды. |
| -9 | неверное значение поля w3s.request/reqn |
| -8 | неверное значение поля w3s.request/sign |
| -1 | неверное значение поля w3s.request/invoice/orderid |
| -2 | неверное значение поля w3s.request/invoice/customerwmid |
| -3 | неверное значение поля w3s.request/invoice/storepurse |
| -5 | неверное значение поля w3s.request/invoice/amount |
| -6 | слишком длинное поле w3s.request/invoice/desc |
| -7 | слишком длинное поле w3s.request/invoice/address |
| -11 | идентификатор, переданный в поле w3s.request/wmid не зарегистрирован |
| -12 | проверка подписи не прошла |
| 102 | не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| 110 | нет прав на использования интерфейса; аттестат не удовлетворяет требованиям |
| 111 | попытка выставление счета для кошелька не принадлежащего WMID, которым подписывается запрос; при этом доверие не установлено. |
| 6 | получатель счета не найден |
| 5,7 | отправитель счета не найден |
| 35 | плательщик не авторизован корреспондентом для выполнения данной операции. Это означает, что магазин пытается выписать счет клиенту, который, либо не добавил ВМИД магазина к себе в список корреспондентов и при этом запретил неавторизованным (не являющимся его корреспондентами) выписывать себе счета (для Кипер Классик – в главном меню вверху – Инструменты – Парметры программы -Ограничения ), либо клиент добавил ВМИД магазина к себе в корреспонденты, но именно для ВМИДа этого магазина запретил выписку себе счетов. Без действий со стороны клиента избежать этой ошибки магазин не может, необходимо показать клиенту ВМИД магазина с инструкцией о том, что ВМИД магахина должен быть добавлен клиентом в список корреспондентов и для ВМИДа должна быть разрешена выписка счета |
| 61 | Превышен лимит долговых обязательств заемщика |
Категория: XML-интерфейсы
This article in other languages: English
RU
EN