Формат импорта накладных в Заказ on-line ЛОГИСТИКА
- Наименование файла
- Пример структуры файла
- Комментарии к структуре файла
- Описание структуры
- Пример файлов обмена для загрузки обновленных данных по накладной
Для организации процесса автоматической загрузки заявок в систему «on-line» используется международный стандарт обмена структурированной информацией XML
1. Наименование файла (параметр необязательный, но рекомендуемый):
CompanyName_ГГГГММДД.xml
Где:
- CompanyName – Краткое наименование компании на латинице без пробелов,
- ГГГГ – Год,
- ММ – месяц,
- ДД – день формирования файла
2. Пример структуры файла(не все реквизиты обязательны)
<?xml version="1.0" encoding="UTF-8" ?>
<Order ClientId=”000001”>
<Invoice
CityId ="000000151"
ShipperID="000000222"
PointId="00000666"
PointName="Квартал 18 Рогожский вал"
PointAddress="109544, г. Москва, ул. Рогожский вал, д. 6, стр. 1, корп. 2, (499) 553-82-03"
Sum="6064.46"
PackQnt="3"
Weight="18.65"
NetWeight="18.00"
SupplyDate="2011-06-16"
Date="2011-06-16"
DocNo="42174"
DocNoNew="45212"
TtnNo="45212"
TtnDate="2011-06-16"
TrnNo="45212"
TrnDate="2011-06-16"
PalletQnt="2"
LegalName="ЗАО "Топас""
LegalINN="7725141504\782501001"
Comment="Приемка с 07-00 до 21-00. Вернуть в офис 1 экз Акта с печатью, 2 экз. ТОРГ-12 со штампом об Акте"
Barcode="00000000001"
PackBarcodes="00000000001, 00000000002, 00000000003"
DeliveryDate="2011-06-16"
DeliveryTime="09:30"
WhNum="2D-33-1СБ; 2D-34-1СБ" >
<Documents>
<Document Kind="ТН" Num="404853" Date="2015-05-05" Cnt="3" />
<Document Kind="СчетФактура" Num="1575" Date="2015-05-05" Cnt="2" />
<Document Kind="ТРН" Num="3575" Date="2015-05-05" Cnt="1" />
</Documents>
</Invoice>
<Return
PointId="00005758"
ShipperID="000000232"
PointName="Буторина Н.В. Герцена"
PointAddress="г. Москва"
Sum="1038.40"
PackQnt="1"
Weight="5.26"
SupplyDate="2011-06-16T00:00:00"
Date="2011-06-16T00:00:00"
DocNo="ЗВ-7720"
DocNoNew="ВН-8634"
PalletQnt="1"
LegalName="ИП Буторина Н.В."
LegalINN="352515573888">
<Documents>
<Document Kind="ТН" Num="404854" Date="2015-05-05" Cnt="3" />
<Document Kind="СчетФактура" Num="1576" Date="2015-05-05" Cnt="2"/>
<Document Kind=" Доверенность " Num="7747" Date="2015-05-05" Cnt="1" />
</Documents>
</Return>
</Order>
3. Комментарии к структуре файла
Атрибут ClientId должен соответствовать коду Заказчика в системе «on-line» после его заведения – сообщается Заказчику и должен быть во всех его файлах обмена. Параметр необязательный.
Задание на прямую доставку грузополучателю– узел «Invoice».
Задание на возврат – узел «Return».
В заказе может быть неограниченное количество узлов Invoice и Return.
Атрибут DocNo выступает в роли первичного ключа уникальности задания. При повторной загрузке файла обмена выполняется поиск уже загруженных заданий по значению DocNo. Если задание найдено, происходит обновление информации, если нет – добавляется новое задание.
Если атрибут DocNoNew не заполнен, номер товарной накладной принимается как пустое значение.
Узел «Documents», дочерний к узлам «Invoice» и «Return», содержит в себе перечень передаваемой товарно-сопроводительной документации (ТСД). Узел является необязательным для заполнения. Узел «Document», дочерний к узлу «Documents», содержит информацию о виде, номере, дате и количестве ТСД.
Если информация о ТСД не передается, узел «Documents» добавлять в XML файл не обязательно.
4. Описание структуры:
Узлы «Invoice» и «Return»
Узел «Document»
Название | Описание | Обязательно для заполнения | Тип данных | Размер поля | Формат или константа или варианты |
---|---|---|---|---|---|
Kind |
Вид передаваемой ТСД |
|
Символьный |
< 50 |
«ТН» - Товарная накладная, «ТРН» - Транспортная накладная, «ВНК» - возвратная накладная, «СФ» - счет-фактура, «ДОВ» - доверенность |
Num |
Номер документа |
|
Символьный |
< 15 |
|
Date |
Дата документа |
|
Символьный |
10 |
YYYY-MM-DD |
Cnt |
Количество копий |
|
Числовой |
8 |
|
5. Пример файлов обмена для загрузки обновленных данных по накладной
Первичный файл обмена
<?xml version="1.0" encoding="UTF-8" ?>
<Order ClientId=”000001”>
<Invoice
PointId="00000666"
PointName="Квартал 18 Рогожский вал"
PointAddress="109544, г. Москва, ул. Рогожский вал, д. 6, стр. 1, корп. 2, (499) 553-82-03"
Sum="6064.46" PackQnt="3"
Weight="18.00"
SupplyDate="2011-06-16"
Date="2011-06-16T00:00:00"
DocNo="42174"
DocNoNew="45200"
PalletQnt="0.5"
LegalName="ЗАО "Торкас""
LegalINN="7725141594\772501001"
Comment="Приемка с 07-00 до 21-00. Вернуть в офис 1 экз Акта с печатью, 2 экз. ТОРГ-12 со штампом об Акте"
DeliveryDate="2011-06-16" DeliveryTime="09:30" />
</Order>
В результате будет создано задание на кросс-докинг с номером заказа 42174 и номером накладной 45200.
Файл обмена с обновлениями
<?xml version="1.0" encoding="UTF-8" ?>
<Order ClientId=”000001”>
<Invoice
PointId="00000666"
PointName="Квартал 18 Рогожский вал" PointAddress="109544, г. Москва, ул. Рогожский вал, д. 6, стр. 1, корп. 2, (499) 553-82-03"
Sum="6064.46"
PackQnt="3"
Weight="18.00"
SupplyDate="2011-06-16"
Date="2011-06-16T00:00:00"
DocNo="42174"
DocNoNew="45212"
PalletQnt="0.5"
LegalName="ЗАО "Торкас""
LegalINN="7725141594\772501001"
Comment="Приемка с 07-00 до 21-00. Вернуть в офис 1 экз Акта с печатью, 2 экз. ТОРГ-12 со штампом об Акте"
DeliveryDate="2011-06-16"
DeliveryTime="09:30" />
</Order>