Описание WS Cтатус строк заказа подробно V2:
1 Сервис, «Подробная информация по номеру заказа (ver. 2) getOrder2», отличия от предыдущей версии выделены шрифтом синего цвета
1.1 Входные параметры:
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
VKORG |
Сбытовая организация |
строка (4) |
Да |
Настройка параметра находится в "Сервис получения сбытовых организаций клиента". |
KUNRG |
Покупатель |
строка (10) |
Да |
Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB-KUNNR |
ORDER |
Номер заказа |
строка (10) |
Да |
Номер созданного заказа, созданного покупателем KUNRG. |
STATUS |
Расшифровка статусов |
0,1,или пустая строка (1) |
Нет |
Если поле STATUS = 1, то в результат сервиса будет добавлено полное описание статусов по позиции |
Добавлен новый параметр STATUS
1.2 Ответ сервиса:
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
ORDER |
Номер заказа |
строка (10) |
Нет |
Номер созданного заказа, созданного покупателем KUNRG. |
ORDER_TYPE |
Тип заказа |
строка (100) |
Нет |
Тип заказа зависит от места отгрузки (в ЭТП отмечены разными цветами), принимает следующие значения: |
ORDER_STATUS |
Статус заказа |
строка (100) |
Нет |
Статус заказа, может принимать следующие значения (в ЭТП значок рядом с номером): |
ORDER_DATE |
Дата заказа |
строка (20) |
Нет |
Формат даты YYYYMMDDHHIISS |
ORDER_SUM |
Сумма заказа |
строка (20) |
Нет |
Сумма заказа. |
CURRENCY |
Валюта |
строка (4) |
Нет |
|
KUNRG |
Покупатель |
строка (10) |
Нет |
Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB-KUNNR |
NAMERG |
Наименование покупателя |
строка (100) |
Нет |
|
KUNWE |
Грузополучатель |
строка (10) |
Нет |
|
NAMEWE |
Наименование грузополучателя |
строка (100) |
Нет |
|
KUNZA |
Адрес доставки|Пункт выдачи для самовывоза |
строка (10) |
Нет |
Доступные значения возвращает сервис "Сервис получения структуры клиента". |
NAMEZA |
Адрес доставки|Пункт выдачи для самовывоза |
строка (10) |
Нет |
Доступные значения возвращает сервис "Сервис получения структуры клиента". |
ADDRZA |
Адрес доставки |
строка (100) |
Нет |
|
PARNRAP |
Код Создателя заказа |
строка (10) |
Нет |
|
NAMEAP |
Наименование Создателя заказа |
строка (100) |
Нет |
|
PARNRZP |
Контактное лицо |
строка (10) |
Нет |
Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB->CONTACT_TAB-PARNR |
NAMEZP |
Наименование Контактного лица |
строка (100) |
Нет |
|
ETDAT |
Поставлять товар С |
строка (20) |
Нет |
Формат даты YYYYMMDDHHIISS |
VDATU |
Поставлять товар По |
строка (20) |
Нет |
Формат даты YYYYMMDDHHIISS |
DOC_NUM |
Номер заказа в учетной системе Клиента |
строка (20) |
Нет |
|
DOC_DATE |
Дата заказа в учетной системе Клиента |
строка (14) |
Нет |
|
NUMDOG |
Номер договора |
строка (100) |
Нет |
|
COMPL_DLV |
Полная поставка |
0,1,или пустая строка (1) |
Нет |
1 - да. |
COMMENT |
Комментарий по заказу |
строка (100) |
Нет |
|
COMMENT_EXP |
Комментарий к экспедиции |
строка (100) |
Нет |
|
INCOTERMS_TXT |
Вид доставки |
строка (100) |
Нет |
Принимает следующие значения: |
VSTELT |
Наименование Пункта выдачи |
строка (100) |
Нет |
|
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
POSNR |
Номер позиции в заказе |
строка (10) |
Нет |
|
BRAND |
Бренд |
строка (<18) |
Нет |
Наименование бренда |
PIN |
Номер артикула |
строка (<40) |
Нет |
ПИН (строка поиска) |
NAME |
Наименование |
строка (100) |
Нет |
Наименование артикула |
KWMENG |
Количество в заказе |
строка (20) |
Нет |
Количество "В заказе" |
KWMENG_P |
К поставке |
строка (20) |
Нет |
Количество "К поставке" если <> 0 то отображает количество готовое к отгрузке Клиенту |
KWMENG_R |
Отгруженное количество |
строка (20) |
Нет |
Количество "Отгружено" количество УЖЕ отгруженное Клиенту |
KWMENG_REJ |
Отклоненное количество |
строка (20) |
Нет |
Количество "Отклонено" которое было отклонено |
PRICE |
Цена за единицу |
строка (20) |
Нет |
Цена за единицу Артикула |
SUMMA |
Сумма |
строка (10) |
Нет |
|
CURRENCY |
Валюта |
строка (4) |
Нет |
|
STATUS |
Статус позиции |
строка (100) |
Нет |
Принимает значения: |
NOTE |
Примечание |
строка (100) |
Нет |
Примечание к позиции |
DLVRD |
Ожидаемая дата |
строка (20) |
Нет |
Формат даты YYYYMMDDHHIISS |
WRNTD |
Гарантированная дата |
строка (20) |
Нет |
Формат даты YYYYMMDDHHIISS |
ABGRU_TXT |
Причина отклонения |
строка (100) |
Нет |
Если позиция отклонена, то выводится текст Причины отклонения |
MATNR |
Материал |
строка (18) |
Нет |
|
COMPL_DLV |
Полная поставка |
0,1,или пустая строка (1) |
Нет |
1 - да. |
POSEX |
Ссылка на "Родительскую позицию" |
строка (6) |
Нет |
Номер родительской позиции с которой произведен перезаказ, или перевод артикула в некондицию. Позиции нумеруются последовательно при нескольких перезаказах, образуя цепочку перезаказов |
POSROOT |
Ссылка "На корневую позицию" |
строка (6) |
Нет |
Номер корневой позиции. На это номер ссылаются все созданные зависимые позиции |
CHARG |
Признак некондиции |
строка (10) |
Нет |
Если НЕ пусто, то в данной позиции находится некондиционный товар. В ЭТП по нему можно посмотреть фото |
CHARG_BLK |
Признак блокировки некондиции к отгрузке |
bool (1) |
Нет |
Если = True то данная позиция некондиционного товара блокирована к отгрузке и по ней требуется принять решение отгружать или нет. Разблокировать можно в ЭТП при редактировании заказа или надо связаться с менеджером |
SUPPLIER |
Код склада партнера АРМТЕК |
число (10) |
Нет |
Если товар со склада партнера (ЦЗ), то в данном поле отображается код склада партнера |
ZZKWMENG |
Изначально заказанное количество |
строка (20) |
Нет |
1. При заказе со складов партнеров, если невозможно поставить требуемое количество полностью, то значение в поле KWMENG может быть уменьшено, но в данном поле значение останется неизменным. 2. При невозможности поставить все количество, система отклоняет всю позицию и перезаказывет артикул у другого поставщика, создавая новые строки в заказе, которые ссылаются на родительскую позицию. При перезаказе может быть несколько строк, но общее количество хранится в данном поле родительской позиции. 3. Соответствует полю «Заказано» в ЭТП в «Заказе подробно» |
REJECTED |
Суммарно-отклоненное количество |
строка (20) |
Нет |
1. Общее отклоненное количество, которое уже не сможет быть поставлено. Если это позиция заказа с ЦЗ (со складов партнеров), которая была перезаказана, то во всех связанных позициях у которых одна корневая позиция (одно и то-же значение в поле POSROOT), значение в этом поле будет одно и то-же. При использовании, нельзя суммировать для связанных позиций! 2. Соответствует полю «Отклонено» в ЭТП в «Заказе подробно» |
PROCESSING |
Количество, которое находится «В работе» |
строка (20) |
Нет |
То количество, которое: 1. Находится в работе, но еще не готово к отгрузке 2. Не включает в себя значение из поля REJECTED 3. Соответствует полю «В работе» в ЭТП в «Заказе подробно» |
READY |
Количество, которое «Готово к отгрузке» |
строка (20) |
Нет |
Включает в себя то количество, которое: 1. Находится на складе отгрузки клиенту и ожидает отгрузки в соответствии со способом и условиями отгрузки клиенту. 2. Находится в «поставке», т.е., то количество которое уже начало комплектоваться складом для отгрузки клиенту. 3. Соответствует полю «Готов к отгрузке» в ЭТП в «Заказе подробно» |
REJ_MENGE |
Количество от которого отказался клиент |
строка (20) |
Нет |
При доставке если клиент отказывается забирать весь товар или его часть, то водитель регистрирует «Отказ клиента» и в этом поле отображается количество от которого клиент отказался количество |
ReadyToIssue |
Готов к выдаче |
строка (20) |
Нет |
|
Issued |
Выдано |
строка (20) |
Нет |
2 Сервис работает в 2-х режимах:
2.1 Режим статусов строк заказа, соответствует статусам, отображаемым в ЭТП на странице «Заказ подробно» (URL = etp.armtek.*/order/index/*):
2.2 Новая функциональность "Расшифровка статусов", для получения данных с расшифровкой статусов позиций необходимо в сервисе установит параметр STATUS = 1. В результате в ответ добавляется новая сложная структура (вложенные массивы):
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
ORDER |
Номер заказа |
строка (10) |
Да |
Номер заказа |
POSNR |
Номер позиции в заказе |
строка (10) |
Да |
Номер позиции заказа |
QUAN |
Количество |
строка (20) |
Да |
Количество к расшифровке |
VSTELNAME |
Наименование Пункта выдачи |
строка (100) |
Да |
Наименование Пункта выдачи с которого будет отгружаться товар |
Processing |
В обработке |
строка (20) |
Нет |
Количество, которое находится в процессе обработки:
|
Ready |
Готов к отгрузке |
строка (20) |
Нет |
Количество, которое находится на складе отгрузки и уже готово к отгрузке клиенту. |
Delivered |
Отгружено |
строка (20) |
Нет |
Количество, которое уже отгружено клиенту. |
|
|
|
|
|
2.3 Статус Delivered означает что товар уже отгружен и на это имеются документы фактура. Информация размещается в следующей таблице (массив):
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
InvoiceNum |
Номер фактуры |
строка (10) |
Да |
Системный Номер фактуры |
InvoicePos |
Номер позиции в фактуре |
строка (10) |
Да |
Номер позиции фактуры |
PrintNum |
Печатный номер фактуры |
строка (15) |
Да |
Номер печатного документа по фактуре: УПД/Товчек |
Waybill |
Номер ТН/ТТН |
строка (15) |
Нет |
Номер ТН/ТТН если есть. |
CreateTime |
Дата и время создания |
Строка (14) |
Да |
Дата и время создания фактуры ы формате ГГГГММДДЧЧММСС |
Quan |
Количество |
строка (20) |
Да |
Количество в строке фактуры |
Unit |
ЕИ |
строка (3) |
Да |
Единица измерения количества |
Cost |
Стоимость |
строка (20) |
Да |
Стоимость по строке фактуры |
Currency |
Валюта |
строка (3) |
Да |
Валюта |
ShipedTime |
Не используется |
- |
Нет |
Пока Не используется |
DeliveryNum |
Номер поставки |
строка (10) |
Да |
Номер связанного документа «поставка». |
2.4 Статус Ready означает что товар готов к отгрузке. Информация размещается в следующей таблице (массив):
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
DeliveryNum |
Номер поставки |
строка (10) |
Нет |
Номер документа «поставка». Значит на складе отгрузки уже начат процесс сборки. |
DeliveryPos |
Номер позиции в поставке |
строка (6) |
Нет |
Номер позиции поставки |
DeliveryTime |
Дата и время создания |
строка (14) |
Нет |
Дата и время создания поставки в формате ГГГГММДДЧЧММСС |
DeliveryQuan |
Количество |
строка (20) |
Нет |
Количество в позиции поставки |
DeliveryUnit |
ЕИ |
строка (3) |
Нет |
Единица изменения количества |
WarehouseQuan |
Количество на складе отгрузки |
строка (20) |
Нет |
Количество на складе отгрузки, но еще не начало отгружаться. |
DateDelNew |
Дата получения клиентом |
строка (14) |
Нет |
Расчетная дата получения товара, которая рассчитывается исходя из текущего состояния. ГГГГММДДЧЧММСС |
2.5 Статус Processing — самый сложный к расшифровке статус, т.к. отражает как состояние товара у партнера в случае заказа с Центра закупки (ЦЗ), так и состояние товара на всех складах АРМТЕК в соответствии с логистической цепочкой. Данный статус всегда говорит о том, что товар пока не готов к отгрузке. Т.к. статус сложный, то для него введено понятие SubStatus. Информация размещается в следующей таблице (массив):
Параметр |
Наименование |
Тип(макс.-размер) |
Обязательный |
Примечание |
---|---|---|---|---|
SubStatus |
Субстатус |
строка (10) |
Да |
Может принимать следующие значения:
|
Werks |
Код склада АРМТЕК |
строка (4) |
Нет |
Код склада АРМТЕК на котором фиксируется текущий SubStatus |
WerksName |
Наименование склада АРМТЕК |
строка (60) |
Нет |
Наименование склада АРМТЕК на котором фиксируется текущий SubStatus |
Lgort |
Не используется |
строка (20) |
Нет |
Не используется |
LsegETP |
Описание |
строка (60) |
Нет |
Пояснение к текущему SubStatus |
Quan |
Количество |
строка (20) |
Да |
Количество которое находится в соответствующем SubStatus. |
Bldat |
Дата последнего события |
строка (8) |
Нет |
Дата когда произошло изменение SubStatus. Может быть пустым если SubStatus информационный. |
Cputm |
Время последнего события |
строка (6) |
Нет |
Время когда произошло изменение SubStatus. Может быть пустым если SubStatus информационный. |
Unit |
ЕИ |
строка (3) |
Да |
Единица измерения количества |
DateDelNew |
Дата получения клиентом |
строка (14) |
Нет |
Расчетная дата получения товара, которая рассчитывается исходя из текущего состояния (даты и времени последнего события для SubStatus). ГГГГММДДЧЧММСС |
2.6 Если поля Werks WerksName не заполнены, то это значит, что субстсатус относится к складам партнера: Planned, Waiting, Confirmed и Shipped
2.7 Субстатус WayQuan: