Формат импорта накладных в Заказ 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="ЗАО &quot;Топас&quot;"
      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»

Название

Описание

Обязательно для заполнения

Тип данных

Размер поля

Формат или константа или варианты

DocNo

Номер заказа в системе Заказчика

Да

Символьный

< 50

 

DocNoNew

Номер товарной накладной

Да

Символьный

< 50

 

Date

Дата товарной накладной

Да

Символьный

10

DateTime.TZ

TtnNo

Номер ТТН

Да

Символьный

< 50

 

TtnDate

Дата ТТН

Да

Символьный

10

DateTime.TZ

TrnNo

Номер ТрН

Да

Символьный

< 50

 

TrnDate

Дата ТрН

Да

Символьный

10

DateTime.TZ

PointName

Наименование грузополучателя в системе клиента для визуальной идентификации

Да

Символьный

 < 255

 

PointAddress

Адрес грузополучателя

Да

Символьный

 < 255

 

LegalName

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

Да

Символьный

 < 255

 

LegalINN

ИНН юр. лица грузополучателя

 

Символьный

< 12

 

PointContactInfo

Контактная информация грузополучателя

 

Символьный

 < 255

 

Comment

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

 

Символьный

 < 255

 

Barcode

Баркод, штрихкод, QR-код накладной

 

Символьный

< 255

 

PackBarcodes

Список Баркодов, штрихкодов, QR-кодов для каждой коробки накладной

 

Символьный

< 255

С разделителем «запятая»

SupplyDate

Дата передачи груза

 

Символьный

10

YYYY-MM-DD

DeliveryDate

Дата планируемой доставки грузополучателю

 

Символьный

10

YYYY-MM-DD

DeliveryTime

Время планируемой доставки грузополучателю

 

Символьный

5

hh:mm

(час:минута)

Avisale

Необходимость авизации

 

Числовой

 

0 – нет необходимости

1 – авизация экспедитора

2 – авизация Поставщика

3 – авизация Грузополучателя

PalletQnt

Количество паллет

 

Числовой

8

 

PackQnt

Количество коробок

Да

Числовой

8

 

Weight

Вес брутто, кг

Да

Числовой

13.2

 

NetWeight

Вес нетто, кг

 

Числовой

13.2

 

Volume

Объем груза

Да

Числовой

13.2

 

Sum

Стоимость товара по накладной

Да

Символьный

15.2

 

Tmpr

Температурный режим

Да

Числовой

1

0 - не определен

1 - «+2+60С»

2 - «+12+190С»

3 - «без режима»

4 - «-18 0С»

WhId

Id номер склада передачи груза, выдается Экспедитором

 

Символьный

9

Если склад не указан, то по умолчанию склад Экспедитора

WhAddress

Адрес склада передачи груза

 

Символьный

< 50

 

ClientOrderNo

Номер заказа Грузополучателя

 

Символьный

< 50

Нужен для идентификации груза в системе Грузополучателя, например, номер заказа Агроторга

ClientOrderDate

Дата заказа Грузополучателя

 

Символьный

10

YYYY-MM-DD

ClientContractNo

Номер договора клиента в системе заказчика

 

Символьный

< 50

 

ClientContractDate

Дата договора клиента в системе заказчика

 

Символьный

10

YYYY-MM-DD

OrderNoRC

Номер заявки РЦ

 

Символьный

< 50

 

OrderNoGM

Номер заявки ГМ

 

Символьный

< 50

 

WhNum

Ячейка хранения на складе

 

Символьный

<100

Список ячеек на складе, разделенных «;»

Узел «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="ЗАО &quot;Торкас&quot;"
      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="ЗАО &quot;Торкас&quot;"
    LegalINN="7725141594\772501001"
    Comment="Приемка с 07-00 до 21-00. Вернуть в офис 1 экз Акта с печатью, 2 экз. ТОРГ-12 со штампом об Акте"
    DeliveryDate="2011-06-16"
    DeliveryTime="09:30"   />
</Order>

Все статьи