Cервисы по работе с фактурами ver. 1.1.7

 

Подробная информация по номеру фактуры getInvoice

Метод вызова

GET

Входные параметры

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
VKORGСбытовая организациястрока ( 4 )ДаНастройка параметра находится в "Сервис получения сбытовых организаций клиента".
Пример заполнения VKORG=4000
KUNRGПокупательстрока ( 10 )ДаДоступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB-KUNNR
Пример заполнения KUNRG=00000000
INVOICEНомер фактурыстрока ( 10 )Да, если ZZSF = ПустоНомер фактуры, которая была создана для покупателя из параметра KUNRG.
ZZSFУПД/товчекстрока ( 20 )Да, если INVOICE = ПустоНомер печатного документа фактуры.Обязателен, если INVOICE не заполнено. Если заполнены оба поля и INVOICE и ZZSF то поиск осуществляется по ZZSF
REFLAGДля возврата0,1,или пустая строка ( 1 )НетДля возврата
NOCOLLAPSРазделять по партиям0,1,или пустая строка ( 1 )НетРазделять по партиям

Описание ответа сервиса

общее описание ответа

ответ сервиса
ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
HEADERИнформация по фактуретаблица ( - )Нет
ITEMSТаблица артикуловтаблица ( - )Нет
CASHТип возврата ДС ( )НетТип возврата ДС
AUGRU_OUTPUTПричины возврата ( )НетПричины возврата

Таблица HEADER

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
INVOICEНомер фактурыстрока ( 10 )НетНомер фактуры, которая была создана для покупателя из параметра KUNRG.
INVDATEДата фактурыстрока ( 8 )НетФормат даты YYYYMMDD
Пример заполнения INVDATE=20171005
KUNWEГрузополучательстрока ( 10 )НетДоступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB->WE_TAB-KUNNR
Пример заполнения KUNWE=00000000
KUNZAАдрес доставки|Пункт выдачи для самовывозастрока ( 10 )НетДоступные значения возвращает сервис "Сервис получения структуры клиента".
Для доставки - таблица RG_TAB->ZA_TAB-KUNNR
Для самовывоза - таблица RG_TAB->EWX_TAB-ID
Пример заполнения KUNNR_ZA=00000000
PARNRZPКонтактное лицострока ( 10 )НетДоступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB->CONTACT_TAB-PARNR
Пример заполнения PARNR=00000000
NUMDOGНомер договорастрока ( 100 )Нет
UPDНомер УПД/Товчекастрока ( 10 )НетНомер УПД/Товчека
TORG12ТН/ТТН/Акт выполненных работстрока ( 10 )НетТН/ТТН/Акт выполненных работ
PAYMENTВид оплатыстрока ( 20 )НетВид оплаты (наличный, безналичный)
INCOTERMS_TXTВид доставкистрока ( 100 )НетПринимает следующие значения:
Доставка до Клиента
Самовывоз
SUMMAСуммастрока ( 10 )Нет
CURRENCYВалютастрока ( 4 )Нет
ERDATДата и время создания фактурыстрока ( 14 )НетФормат даты YYYYMMDDHHIISS
Пример заполнения DLVDT=20171005120000
VSTELTНаименование Пункта выдачистрока ( 100 )Нет
MAX_RET_SUMМаксимально-возможная сумма к возвратустрока ( 10 )НетМаксимально-возможная сумма к возврату

Таблица ITEMS

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
POSNRНомер позиции в фактурестрока ( 8 )НетНомер позиции в фактуре
MATNRМатериалстрока ( 18 )Нет
PINНомер артикуластрока ( <40 )НетПИН (строка поиска)
GTDГТДстрока ( 30 )Нет
BRANDБрендстрока ( <18 )НетНаименование бренда
NAMEНаименованиестрока ( 50 )НетОписание способа возврата денег
AMOUNTКоличествочисло ( 10 )Нет
WEIGHTВесстрока ( 10 )НетВес позиции в КГ.
VOLUMОбъемстрока ( 10 )НетОбъем позиции в ДМ3
PRICEЦена за единицустрока ( 20 )НетЦена за единицу Артикула
SUMMAСуммастрока ( 10 )Нет
RETMGКоличество на которое оформлены возвраты по данной позициичисло ( 10 )Нет
NORETВозможность оформления возвратастрока ( 1 )Нет
MINBMМинимальное количествострока ( 10 )Нет
RDPRFКратностьстрока ( 10 )Нет
SCALИндикатор того, что данная позиция закуплена со скидкой по шкальностистрока ( 1 )Нет
DREКоличество дней в течении которых можно вернуть данную позицию после отгрузкистрока ( 10 )Нет
ORDERНомер заказастрока ( 10 )НетНомер созданного заказа, созданного покупателем KUNRG.
ORDER_POSПозиция заказастрока ( 8 )Нет
ORDER_NOTEКомментарий по заказустрока ( 100 )НетКомментарий к заказу (также как в ЭТП)
COUNTRYСтранастрока ( 255 )НетСтрана происхождения
VatRateСтавка НДСстрока ( )Нет
VatAmountСумма НДСстрока ( )Нет
EanКод ЕАНстрока ( )Нет
TnvedКод ТНВЭДстрока ( )Нет

Таблица CASH

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
KEYКод способа возврата денегстрока ( 1 )НетКод способа возврата денег
NAMEНаименованиестрока ( 50 )НетОписание способа возврата денег

Таблица AUGRU_OUTPUT

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
AUGRUКод причины возвратастрока ( 3 )НетКод причины возврата
BEZEIОписание причины возвратастрока ( 40 )НетОписание причины возврата
TEXTПричина возврата по умолчаниюстрока ( 100 )НетПричина возврата по умолчанию

Пример вызова

http://ws.armtek.by/api/ws_invoice/getInvoice?VKORG=ЗНАЧЕНИЕ_ПАРАМЕТРА&KUNRG=ЗНАЧЕНИЕ_ПАРАМЕТРА&INVOICE=ЗНАЧЕНИЕ_ПАРАМЕТРА&ZZSF=ЗНАЧЕНИЕ_ПАРАМЕТРА&format=json

Эмуляция вызова

 

Создание возврата createReturnInvoice

Описание

Рекомендации по использованию сервиса «Создание возврата createReturnInvoice»
1. Возврат всегда создается по документу «фактура» поэтому непосредственно перед созданием возврата необходимо получить актуальные данные по фактуре, по которой создается возврат. Для этого необходимо вызвать сервис «Подробная информация по номеру фактуры getInvoice» и обязательно с параметром REFLAG = 1
2. В ответе WS «Подробная информация по номеру фактуры getInvoice» перед созданием возврата необходимо проверить возможность его оформления по следующим критериям:
2.1. Параметр MAX_RET_SUM на заголовке ответа (Таблица HEADER) Максимально возможная сумма на которую можно создать возврат.
2.2. Параметр NORET в позиции (Таблица ITEMS). Если NORET="X" то возврат по данной сроке невозможен
2.3. Параметр RETMG в позиции (Таблица ITEMS). Содержит количество, которое уже было возвращено по данной позиции. Соответственно максимальное количество, которое можно вернуть вычисляется как AMOUNT-RETMG.

Метод вызова

POST

Входные параметры

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
VKORGСбытовая организациястрока ( 4 )ДаЗначение из параметров запуска сервиса Подробная информация по номеру фактуры (getInvoice)
KUNRGПокупательстрока ( 10 )ДаНомер покупателя из параметров запуска сервиса Подробная информация по номеру фактуры (getInvoice)
VBELNFНомер Фактурыстрока ( 10 )ДаСоответствующее значение из таблицы HEADER сервиса Подробная информация по номеру фактуры (getInvoice)
AUGRUКод Причины возвратастрока ( 3 )ДаЗначение из таблицы AUGRU_OUTPUT сервиса Подробная информация по номеру фактуры (getInvoice)
RESOLUTIONОписание причины возвратастрока ( 512 )НетЕсли не заполнено, заполняется значением из поля TEXT из таблицы AUGRU сервиса Подробная информация по номеру фактуры (getInvoice)
CASH_BACKКод способа возврата денегстрока ( )НетЗначение поля KEY из таблицы CASH_BACK сервиса Подробная информация по номеру фактуры (getInvoice). Заполняется только для покупателей — физлиц
KUNZAАдрес доставки клиентастрока ( 10 )НетАдрес доставки клиента, откуда забрать этот возврат. Один из адресов доставки клиента из структуры клиента таблица ZA_TAB (Сервис получения структуры клиента getUserInfo)
PARNRКонтактное лицострока ( 10 )НетЕсли есть KUNZA то обязательно заполнить значением PARNR Одно из контактных лиц клиента из структуры клиента, таблица CONTACT_TAB (Сервис получения структуры клиента getUserInfo)
POSITION_INPUTТаблица позицийтаблица ( - )Да

Таблица POSITION_INPUT

ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
POSNRНомер позиции из фактурыстрока ( 6 )ДаНомер позиции из фактуры, которая возвращается
MATNRКод материала из фактурыстрока ( 18 )ДаКод материала из фактуры, который возвращается
KWMENGКоличество для возвратастрока ( 20 )ДаКоличество возвращаемого материала

Описание ответа сервиса

общее описание ответа

ответ сервиса
ПараметрНаименованиеТип(макс.-размер)ОбязательныйПримечание
VBELNRНомер созданного возвратастрока ( 10 )НетНомер созданного возврата

Пример вызова

http://ws.armtek.by/api/ws_invoice/createReturnInvoice?format=json

Эмуляция вызова