Описание WS Cтатус строк заказа подробно V2 ver. 1.1.7

 

Описание WS Cтатус строк заказа подробно V2:

1 Сервис, «Подробная информация по номеру заказа (ver. 2) getOrder2», отличия от предыдущей версии выделены шрифтом синего цвета

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

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

VKORG

Сбытовая организация

строка (4)

Да

Настройка параметра находится в "Сервис получения сбытовых организаций клиента".
Пример заполнения VKORG=4000

KUNRG

Покупатель

строка (10)

Да

Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB-KUNNR
Пример заполнения KUNNR_RG=00000000

ORDER

Номер заказа

строка (10)

Да

Номер созданного заказа, созданного покупателем KUNRG.

STATUS

Расшифровка статусов

0,1,или пустая строка (1)

Нет

Если поле STATUS = 1, то в результат сервиса будет добавлено полное описание статусов по позиции

 

            Добавлен новый параметр STATUS

1.2 Ответ сервиса:

  • Таблица (массив) HEADER

 

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

ORDER

Номер заказа

строка (10)

Нет

Номер созданного заказа, созданного покупателем KUNRG.

ORDER_TYPE

Тип заказа

строка (100)

Нет

Тип заказа зависит от места отгрузки (в ЭТП отмечены разными цветами), принимает следующие значения:
Отгрузка с ОСНОВНЫХ складов АРМТЕК
Доставка с БЛИЖНИХ складов АРМТЕК
Доставка с ДАЛЬНИХ складов АРМТЕК
Доставка с ЦЗ

ORDER_STATUS

Статус заказа

строка (100)

Нет

Статус заказа, может принимать следующие значения (в ЭТП значок рядом с номером):
Создан
В работе
Закрыт
Отклонен

ORDER_DATE

Дата заказа

строка (20)

Нет

Формат даты YYYYMMDDHHIISS
Пример заполнения DLVDT=20181005120000

ORDER_SUM

Сумма заказа

строка (20)

Нет

Сумма заказа.
Важно! Относится ТОЛЬКО к Заказу, если Заказ поставлялся частями (см. Поставку), то в отчете будет больше 1-й строки с этим Номером заказа и в каждой строке значение "Сумма заказа" будет одинакова (также как в ЭТП)

CURRENCY

Валюта

строка (4)

Нет

 

KUNRG

Покупатель

строка (10)

Нет

Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB-KUNNR
Пример заполнения KUNNR_RG=00000000

NAMERG

Наименование покупателя

строка (100)

Нет

 

KUNWE

Грузополучатель

строка (10)

Нет

 

NAMEWE

Наименование грузополучателя

строка (100)

Нет

 

KUNZA

Адрес доставки|Пункт выдачи для самовывоза

строка (10)

Нет

Доступные значения возвращает сервис "Сервис получения структуры клиента".
Для доставки - таблица RG_TAB->ZA_TAB-KUNNR
Для самовывоза - таблица RG_TAB->EWX_TAB-ID
Пример заполнения KUNNR_ZA=00000000

NAMEZA

Адрес доставки|Пункт выдачи для самовывоза

строка (10)

Нет

Доступные значения возвращает сервис "Сервис получения структуры клиента".
Для доставки - таблица RG_TAB->ZA_TAB-KUNNR
Для самовывоза - таблица RG_TAB->EWX_TAB-ID
Пример заполнения KUNNR_ZA=00000000

ADDRZA

Адрес доставки

строка (100)

Нет

 

PARNRAP

Код Создателя заказа

строка (10)

Нет

 

NAMEAP

Наименование Создателя заказа

строка (100)

Нет

 

PARNRZP

Контактное лицо

строка (10)

Нет

Доступные значение возвращаются в "Сервис получения структуры клиента". Таблица RG_TAB->CONTACT_TAB-PARNR
Пример заполнения PARNR=00000000

NAMEZP

Наименование Контактного лица

строка (100)

Нет

 

ETDAT

Поставлять товар С

строка (20)

Нет

Формат даты YYYYMMDDHHIISS
Пример заполнения DLVDT=20181005120000

VDATU

Поставлять товар По

строка (20)

Нет

Формат даты YYYYMMDDHHIISS
Пример заполнения DLVDT=20181005120000

DOC_NUM

Номер заказа в учетной системе Клиента

строка (20)

Нет

 

DOC_DATE

Дата заказа в учетной системе Клиента

строка (14)

Нет

 

NUMDOG

Номер договора

строка (100)

Нет

 

COMPL_DLV

Полная поставка

0,1,или пустая строка (1)

Нет

1 - да.
0 - нет.

COMMENT

Комментарий по заказу

строка (100)

Нет

 

COMMENT_EXP

Комментарий к экспедиции

строка (100)

Нет

 

INCOTERMS_TXT

Вид доставки

строка (100)

Нет

Принимает следующие значения:
Доставка до Клиента
Самовывоз

VSTELT

Наименование Пункта выдачи

строка (100)

Нет

 

 

 

  • Таблица (массив) ITEMS

 

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

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
Пример заполнения DLVDT=20181005120000

WRNTD

Гарантированная дата

строка (20)

Нет

Формат даты YYYYMMDDHHIISS
Пример заполнения DLVDT=20181005120000

ABGRU_TXT

Причина отклонения

строка (100)

Нет

Если позиция отклонена, то выводится текст Причины отклонения

MATNR

Материал

строка (18)

Нет

 

COMPL_DLV

Полная поставка

0,1,или пустая строка (1)

Нет

1 - да.
0 - нет.

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)

Нет

При доставке если клиент отказывается забирать весь товар или его часть, то водитель регистрирует «Отказ клиента» и в этом поле отображается количество от которого клиент отказался количество

 

 

2  Сервис работает в 2-х режимах:

2.1 Режим статусов строк заказа, соответствует статусам, отображаемым в ЭТП на странице «Заказ подробно» (URL = etp.armtek.*/order/index/*):

2.2 Новая функциональность "Расшифровка статусов", для получения данных с расшифровкой статусов позиций необходимо в сервисе установит параметр STATUS = 1. В результате в ответ добавляется новая сложная структура (вложенные массивы):

  • STATUSES. На первом уровне таблица (массив), элементы которой ссылаются на строку заказа с полями:

 

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

ORDER

Номер заказа

строка (10)

Да

Номер заказа

POSNR

Номер позиции в заказе

строка (10)

Да

Номер позиции заказа

QUAN

Количество

строка (20)

Да

Количество к расшифровке

VSTELNAME

Наименование Пункта выдачи

строка (100)

Да

Наименование Пункта выдачи с которого будет отгружаться товар

Processing

В обработке

строка (20)

Нет

Количество, которое находится в процессе обработки:

  • Для заказов со складов партнеров (ЦЗ) это количество включает в себя, как обработку на складах партнера (его код находится в поле SUPPLIER), так и обработку на складах АРМТЕК после получения товара.
  • Для заказов со складов АРМТЕК содержит количество в обработке на  складах в логистической цепочке АРМТЕК

Ready

Готов к отгрузке

строка (20)

Нет

Количество, которое находится на складе отгрузки и уже готово к отгрузке клиенту.

Delivered

Отгружено

строка (20)

Нет

Количество, которое уже отгружено клиенту.

 

 

 

 

 

 
  • Расшифровка статусов доступна отдельно для каждого статуса: Processing, Ready и Delivered
  • Расшифровка оформляется в виде таблиц (массивов) на следующих уровнях

2.3 Статус Delivered означает что товар уже отгружен и на это имеются документы фактура. Информация размещается в следующей таблице (массив):

 

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

InvoiceNum

Номер фактуры

строка (10)

Да

Системный Номер фактуры

InvoicePos

Номер позиции в фактуре

строка (10)

Да

Номер позиции фактуры

PrintNum

Печатный номер фактуры

строка (15)

Да

Номер печатного документа по фактуре: УПД/Товчек

Waybill

Номер ТН/ТТН

строка (15)

Нет

Номер ТН/ТТН если есть.

CreateTime

Дата и время создания

Строка (14)

Да

Дата и время создания фактуры ы формате

ГГГГММДДЧЧММСС

Quan

Количество

строка (20)

Да

Количество в строке фактуры

Unit

ЕИ

строка (3)

Да

Единица измерения количества

Cost

Стоимость

строка (20)

Да

Стоимость по строке фактуры

Currency

Валюта

строка (3)

Да

Валюта

ShipedTime

Не используется

-

Нет

Пока Не используется

DeliveryNum

Номер поставки

строка (10)

Да

Номер связанного документа «поставка».

 
  • Если 1 фактура выписана по 2-м и более поставкам, то будет 2 и более элемента с одинаковыми данными, но разными значениями DeliveryNum
  • Если позиция заказа отгружался частями, то то на каждую отгрузку будет своя секция со своим номером фактуры.

2.4 Статус Ready означает что товар готов к отгрузке. Информация размещается в следующей таблице (массив):

 

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

DeliveryNum

Номер поставки

строка (10)

Нет

Номер документа «поставка». Значит на складе отгрузки уже начат процесс сборки.

DeliveryPos

Номер позиции в поставке

строка (6)

Нет

Номер позиции поставки

DeliveryTime

Дата и время создания

строка (14)

Нет

Дата и время создания поставки в формате

ГГГГММДДЧЧММСС

DeliveryQuan

Количество

строка (20)

Нет

Количество в позиции поставки

DeliveryUnit

ЕИ

строка (3)

Нет

Единица изменения количества

WarehouseQuan

Количество на складе отгрузки

строка (20)

Нет

Количество на складе отгрузки, но еще не начало отгружаться.

DateDelNew

Дата получения клиентом

строка (14)

Нет

Расчетная дата получения товара, которая рассчитывается исходя из текущего состояния.

ГГГГММДДЧЧММСС

 

 

  • Если DeliveryQuan = «пусто» значит товар просто находится «На складе отгрузки» в количестве WarehouseQuan
  • Если DeliveryQuan = НЕ «пусто» значит склад уже приступил к отбору товара.

2.5 Статус Processing — самый сложный к расшифровке статус, т.к. отражает как состояние товара у партнера в случае заказа с Центра закупки (ЦЗ), так и состояние товара на всех складах АРМТЕК в соответствии с логистической цепочкой. Данный статус всегда говорит о том, что товар пока не готов к отгрузке. Т.к. статус сложный, то для него введено понятие SubStatus. Информация размещается в следующей таблице (массив):

Параметр

Наименование

Тип(макс.-размер)

Обязательный

Примечание

SubStatus

Субстатус

строка (10)

Да

Может принимать следующие значения:

  • WayQuan — товар находится в пути между пунктами логистической цепочки
  • Planned — запланировано к закупке у партнера, но заказ на закупку еще не размещен
  • Waiting — относится к партнеру, означает ожидание подтверждения по размещенному у партнера заказа на закупку
  • Confirmed — партнер подтвердил готовность отгрузить товар
  • Shipped — партнер отгрузил товар в адрес АРМТЕК

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:

  • Если заполнено поле DateDelNew, то это значит:
    • что последнее событие по товару связано с движением по логистической цепочке АРМТЕК
    • отображают конкретный склад на котором это событие произошло.
    • Также заполняется поле LsegETP в котором поясняется состояние товара, например «На приемке» или «В пути на склад отгрузки».
  • Если поле DateDelNew не заполнено, то это значит:
    • что товар находится в пути со склада партнера до первого в логистической цепочке, склада АРМТЕК, который присутствует в полях Werks и WerksName.
    • В этом случае также имеется полный набор субстатусов партнера: Planned, Waiting, Confirmed и Shipped
    • в LsegETP имеется пояснение «Ожидаем прибытия от поставщика»
    • и самая актуальная  DateDelNew для этой позиции находится в секции с субстатусом =  Shipped