Описание XML формата для обмена
Узлы
Document
- AppCreatedDocument - информация о приложении, создавшем файл
-- Module - доп. модули, установленные в приложении, может быть несколько узлов
- Format - описание формата
- Information - реквизиты документа
- Participants - информация по участникам (отправитель\получатель\грузополучатель)
- Articles - информация по товарам
- - Details (для DELFOR) - детализация прогноза по датам
Обозначения для атрибутов:
О - обязательное
Н - необязательное
Формат дата и время
В документах используется формат даты ISO 8601 вида гггг-мм-ддTчч:мм:сс (пример 2019-04-20T13:45:58)
Узел AppCreatedDocument(Обязательный) и вложенный в него узел Module(необязательный)
| Атрибут | Тип | Описание | DELFOR | DELJIT | DESADV |
|---|---|---|---|---|---|
| name | строка | Для узла AppCreatedDocument - версия основного приложения, на котором всё работает. Для узлов Module - имена дополнительных модулей, являющихся частью приложения, в частности для 1С это место для отображения Конфигурации УПП, Бухгалтерия и т.п. В том числе здесь прописывается наименование модуля "Криптэкс EDI+ЭДО" и т.п. см. пример | О | О | О |
| version | строка | Версия программы | О | О | О |
<AppCreatedDocument name="1С:Enterprise" version="8.3">
<Module name="УПП" version="1.3.112.5"/>
<Module name="Криптэкс EDI+ЭДО" version="1.3.112.31"/>
</AppCreatedDocument>
Узел: Document
| Атрибут | Тип | Описание | DELFOR | DELJIT | DESADV |
| VersionFormat | строка, до 4 символов | Версия XML-формата | О | О | О |
| Created | Дата и время | Дата и время генерации XML-файла | О | О | О |
Пример:
<Document VersionFormat="1.0" Created="2018.09.18T16:04:47">
Элемент: Format - по Type прикладное ПО должно определять формат документа
| Атрибут | Тип | Описание | DELFOR | DELJIT | DESADV |
| Type | строка, до 6 символов | Тип EDI документа | О | О | О |
| VersionNumber | строка, до 3 символов | Номер версии: D-Draft | О | О | О |
| ReleaseNumber | строка, до 3 символов | Релизный номер | О | О | О |
| ControllingAgency | строка, до 2 символов | Контролирующее агентство | О | О | О |
| AssociationAssignedCode | строка, до 6 символов | Присвоенный код | О | О | О |
| ReferenceNumber | строка, до 14 символов | Внутренний номер сообщения | О | О | О |
Примеры:
<Format Type="DELFOR" ReferenceNumber="00000000000001" VersionNumber="D" ReleaseNumber="96A" ControllingAgency="UN" AssociationAssignedCode="A09041" /> <Format Type="DELJIT" ReferenceNumber="00000000000154" VersionNumber="D" ReleaseNumber="98B" ControllingAgency="UN" AssociationAssignedCode="A1002" /> <Format Type="DESADV" ReferenceNumber="00000000002561" VersionNumber="D" ReleaseNumber="96A" ControllingAgency="UN" AssociationAssignedCode= "A0105"/>
Узел Information- информация по реквизитам документа:
| Атрибут | Тип | Описание | DELFOR | DELJIT | DESADV |
| DocMsgNumber | строка, до 17символов | Номер сообщения | О | О | О |
| DateTimePreparation | Дата и время | Дата и время создания EDI-документа | О | О | О |
| DocDateTime | Дата и время | Дата и время документа | О | О | О |
| DepartmentOrContact | строка, до 35 символов | Дополнительная информация | Н | Н | Н |
| TypeOfInstructions | строка, до 3 символов | Код инструкций: "2" = "ARRIVAL" - прибытие "10"= "DEPART" - отправление | О | - | - |
| ValidityStartDateTime | Дата и время | Дата и время начала периода в прогнозе | О | - | - |
| ExpiryDateTime | Дата и время | Дата и время завершения периода в прогнозе | О | - | - |
| GrossWeightUnit | строка, до 3 символов | Единица измерения: KGM - Кг. | - | - | Н |
| GrossWeight | число | Вес брутто (используется для печати бирок) | - | - | Н |
| CollectionStart | Дата и время | Дата и время начала сбора | Н | Н | - |
| CollectionEnd | Дата и время | Дата и время завершения сбора | Н | Н | - |
| EstimatedArrivalDateTime | Дата и время | Дата и время ожидаемого прибытия | - | - | О |
| ExpeditionDateTime | Дата и время | Дата и время начала экспедиции | - | - | О |
| DestinationEarliestDeliveryDateTime | Дата и время | Дата и время начала доставки | - | О | - |
| DestinationLatestDeliveryDateTime | Дата и время | Дата и время завершения доставки | - | О | - |
| TransportDepartureDateTime | Дата и время | Дата и время отправки транспорта | - | - | Н (О - если есть CollectionStart в deljit ) |
| TransportIdentifierNumber | строка, до 10символов | Идентификатор транспорта | - | О | О |
| TransportStage | число, max -128 to 127 | Код транспортировки: 1=inland transport - внутренний транспорт 10=pre carrier - предварительный перевозчик 11=at border - на границе 12=at departure - при выезде 13=at destination - в пункте назначения 20=main carriage - основная перевозка 25=delivery carrier all transport - перевозчик доставки весь транспорт 30=on-carriage transport | - | - | Н |
| TransportMode | число, max -128 to 127 | Режим транспортировки: 10=Maritime - морской 20=Rail - рельсовый 30=Road - дорожный 40=Air - воздушный 50=Mail- почтовый 60=Multimodal мультимодальный транспорт 70=Fixed transport installations - Фиксированные транспортные установки 80=Inland water transport - Внутренний водный транспорт 100=courier service (EAN CODE)- курьерская служба | - | - | Н |
| TransportNumber | строка, до 10символов | Регистрационный номер оборудования для перевозки | - | - | Н |
| TransportCode | строка, до 3 символов | Код оборудования для перевозки: CN - Контейнер RR - Вагон TE - Трейлер | Н |
Пример:
<Information DocMsgNumber="0173016" DateTimePreparation="2019-03-11T17:35:00" DocDateTime="2019-03-11T17:35:00" EstimatedArrivalDateTime="2019-03-11T13:25:00" ExpeditionDateTime="2019-03-11T17:35:00" GrossWeight="2563.048" GrossWeightUnit="KGM" TransportIdentifierNumber="P070022205" CodePointUnloading="300PP2" TransportStage="1" TransportMode="30" TransportCode="CN" TransportNumber="N045KR263"/>
Узел Participants- участники обмена
| Элемент | DELFOR | DELJIT | DESADV |
| Sender отправитель файла | есть | есть | есть |
| Recipient получатель файла | есть | есть | есть |
| Seller продавец NAD+SE | есть | есть | есть |
| Buyer покупатель | есть | есть | нет |
| Consignee грузополучатель NAD+CN | есть | есть | есть |
| Consignor грузоотправитель NAD+CZ | нет | есть | есть |
| Атрибут | Тип | Наличие | Описание |
| Id | Строка до 35 символов | О | Идентиификатор участника |
| Code | Число | Н | Код: 10 (ODETTE) или 92 (присвоено покупателем) |
| InternalAccountNumber | Строка до 35 символов | Н | Внутренний номер учетной записи |
| CountryCode | Строка | Н | Код страны. RU - Россия |
| Address | Элемент | Н | Содержит описание - строки с адресом |
Элемент Address - для DESADV
| Элемент | Тип | Описание |
| Line1..5 | Строка до 35 символов | Полный адрес закодированный в 5 строках |
Пример
<Participants> <Sender Id="OEDI6321007249TLT"/> <Recipient Id="OEDI6320002223"/> <Seller Id="0999RU" Code="10"> <Address> <Line1>Tolyatti,Yuzhnoe shosse</Line1> </Address> </Seller> <Consignee Id="094563" Code="10"> <Address> <Line1>445024 TOGLIATTI, SAMARSKAYA OBLAST</Line1> <Line2>YUZHNOYE SHOSSE</Line2> </Address> </Consignee> <Consignor Id="00255" Code="92" InternalAccountNumber="0025"> <Address> <Line1>Tolyatti,Yuzhnoe shosse</Line1> </Address> </Consignor> </Participants>
Элемент Article(вложенный в Articles)
| Атрибут | Тип | Описание | DELFOR | DELJIT | DESADV |
| ArticleNumber | строка, до 10 символов | Артикул товара у покупателя | О | О | О |
| ArticleNumberSA | строка, до 35 символов | Артикул товара у поставщика, опциональный | Н | Н | Н |
| Description | строка, до 20 символов | Описание товара в EDI | О | О | О |
| DescriptionRU | строка, до 500 символов | Описание товара в ЭДО. Справочное, опциональное | Н | Н | Н |
| Description2 | строка, до 35 символов | Описание товара в EDI - дополнительное | Н | Н | Н |
| OrderNumber | строка, до 17 символов | Внутренний номер заказа\договора у покупателя | ?О? | О | О |
| CodeLang | строка, до 3 символов | Код страны | О | О | О |
| CodePointUnloading | строка, до 12 символов | Код точки разгрузки (склад\платформа) | Н | О | Находится в узле Information |
| CodeDestinationPoint | строка, до 10 символов | Код точки назначения (терминал) | О | - | |
| Quantity | число: N10.3 | Количество товара (всего) | О? | О | О |
| QuantityUnit | строка, до 3 символов | Код единицы измерения. PCE - штук | О? | О | О |
| PackType | строка, до 10 символов | Тип тары | О | О(в узле Package) | |
| QuantityPerPackage | число: N10.3 | Количество товара в таре | О | О(в узле Package) | |
| QuantityPerPackageUnit | строка, до 3 символов | Код единицы измерения количества товара в таре. PCE - штук | О | О(в узле Package) | |
| RAN | строка, до 9 символов | Внутренний идентификатор | О | О | |
| UpdatingActionCode | строка, 1 символ | Код действия: 3 - удалить и заменить при еженедельном обмене, 9 - циклическое обновление | О | - | - |
| CalculationDelivery | Дата и время | Дата и время расчетной доставки, опционально | Н | - | - |
| DeadlineDelivery | Дата и время | Дата и время - крайний срок доставки, опционально | Н | - | - |
Элемент Details содержит записи с прогнозами (только для DELFOR) - для конкретного ArticleNumber
| Атрибут | Тип | Описание |
| Start | Дата и время | Дата и время начала поставки |
| Finish | Дата и время | Дата и время завершения поставки |
| Quantity | строка, до 10 символов | Количество к поставке |
| QuantityUnit | строка, до 3 символов | Код единицы измерения. PCE - штук |
| Frequency | строка, 1 символ | Код: частота поставки "W" - еженедельно, "Y" - ежедневно |
Пример DELFOR:
<Article ArticleNumber="278311545R" Description="08-FOOT HEAT,INTERME" OrderNumber="617600" UpdatingActionCode="3" CodePointUnloading="300CK0" CodeLang="FR"> <Details> <Detail Start="2018.10.01T11:45:00" Finish="2018.10.01T18:05:00" Quantity="0" QuantityUnit="PCE" Frequency="Y"/> <Detail Start="2018.10.02T11:25:00" Finish="2018.10.02T18:25:00" Quantity="0" QuantityUnit="PCE"/> <Detail Start="2018.10.02T19:20:00" Finish="2018.10.02T23:59:00" Quantity="0" QuantityUnit="PCE"/> <Detail Start="2018.10.03T11:25:00" Finish="2018.10.03T18:25:00" Quantity="0" QuantityUnit="PCE"/> <Detail Start="2018.10.03T19:20:00" Finish="2018.10.03T23:59:00" Quantity="0" QuantityUnit="PCE"/> <Detail Start="2018.12.17T00:00:00" Finish="2018.12.23T23:59:00" Quantity="200" QuantityUnit="PCE"/> <Detail Start="2019.03.25T00:00:00" Finish="2019.03.31T23:59:00" Quantity="361" QuantityUnit="PCE"/> <Detail Start="2019.04.01T00:00:00" Finish="2019.04.07T23:59:00" Quantity="364" QuantityUnit="PCE"/> <Detail Start="2019.04.08T00:00:00" Finish="2019.04.14T23:59:00" Quantity="366" QuantityUnit="PCE"/> <Detail Start="2019.04.15T00:00:00" Finish="2019.04.21T23:59:00" Quantity="394" QuantityUnit="PCE"/> <Detail Start="2019.04.22T00:00:00" Finish="2019.04.28T23:59:00" Quantity="85" QuantityUnit="PCE"/> <Detail Start="2019.04.29T00:00:00" Finish="2019.05.05T23:59:00" Quantity="48" QuantityUnit="PCE"/> <Detail Start="2019.05.06T00:00:00" Finish="2019.05.12T23:59:00" Quantity="174" QuantityUnit="PCE"/> <Detail Start="2019.05.13T00:00:00" Finish="2019.05.19T23:59:00" Quantity="282" QuantityUnit="PCE"/> <Detail Start="2019.06.24T00:00:00" Finish="2019.06.30T23:59:00" Quantity="196" QuantityUnit="PCE"/> <Detail Start="2019.07.01T00:00:00" Finish="2019.07.07T23:59:00" Quantity="0" QuantityUnit="PCE"/> <Detail Start="2018.10.01T19:20:00" Finish="2018.10.01T23:59:00" Quantity="0" QuantityUnit="PCE"/> </Details> </Article>
DESADV: Описание позиций в уведомлении об отгрузке:
| Атрибут | Тип | Описание | Обязательность |
| Line | n..6 | Порядковый номер в уведомлении (от 1 ... ) | О |
| Quantity | n10,3 | Суммарное количество | О |
| QuantityUnit | строка, до 3 символов | Единица измерения. PCE - штук | О |
| ArticleNumber | строка, до 10 символов | Артикул у покупателя | О |
| ArticleNumberSA | строка, до 15 символов | Артикул товара у поставщика | если известно |
| Description | строка, до 20 символов | Описание товара в EDI (из DELJIT), русские символы - запрещены | О |
| CodeLang | строка, до 2 символов | Код страны артикула | О |
| OrderNumber | строка, до 17 символов | Внутренний номер заказа\договора у покупателя - из DELJIT | О |
Описание пакетов: Packages
| Атрибут | Тип | Описание | Обязательность |
| CountIdenticalPacks | n..6 | Количество идентичных пакетов (с одинаковым количеством товара внутри) | О |
| QuantityPerPackage | n10,3 | Количество внутри каждого пакета | О |
| QuantityPerPackageUnit | n10,3 | Единица измерения. PCE - штук | О |
| PackType | строка, до 10 символов | Тип тары | О |
Описание бирок (на паллету): TransportLabel
| Атрибут | Тип | Описание | Обязательность |
| Number | строка, до 10символов | Уникальный номер большой бирки (на паллету) RFF+AAT | О |
Описание маленьких бирок (на тару) LabelSmall
| Атрибут | Тип | Описание | Обязательность |
| CULabel | строка, до 10символов | Уникальный номер маленькой бирки (на тару) | О |
| BuyerNumber | строка, до 9символов | № реализации - Для складов запасных частей RAN - для CINDI | О |
| KanbanLabel | строка, до 3символов | Kanban | если |
| ProductionDate | Дата и время | Дата и время производства | Н |
| UseDate | Дата и время | Дата и время истечения срока годности | Н |
Пример:
2 тары по 300 + 1 тара по 107,
QuantityTotal = 707 шт.
<?xml version="1.0" encoding="UTF-8"?> <Document VersionFormat="1.0" Created="2019-04-20T13:45:58"> <AppCreatedDocument name="Cryptex.EDI" version="1.0"> <Module name="Cryptex.Converter" version="1.0.1.5"/> <Module name="Cryptex.Converter" version="1.0.1.5"/> </AppCreatedDocument> <Format Type="DESADV" ReferenceNumber="173016" VersionNumber="D" ReleaseNumber="96A" ControllingAgency="UN" AssociationAssignedCode="A01052"/> <Information DocMsgNumber="0173016" DateTimePreparation="2019-03-11T17:35:00" DocDateTime="2019-03-11T17:35:00" EstimatedArrivalDateTime="2019-03-11T13:25:00" ExpeditionDateTime="2019-03-11T17:35:00" GrossWeight="2563.048" GrossWeightUnit="KGM" TransportIdentifierNumber="P070022205" CodePointUnloading="300PP2" TransportStage="1" TransportMode="30" TransportCode="CN" TransportNumber="N045KR263"/> <Participants> <Sender Id="OEDI63210"/> <Recipient Id="OEDI6320002"/> <Seller Id="0999RU" Code="10"> <Address> <Line1>Tolyatti,Yuzhnoe shosse </Line1> </Address> </Seller> <Consignee Id="09456" Code="10"> <Address> <Line1>445000 TOGLIATTI, SAMARSKAYA OBLAST</Line1> <Line2>YUZHNOYE SHOSSE</Line2> </Address> </Consignee> <Consignor Id="0025584303" Code="92" InternalAccountNumber="00255843"> <Address> <Line1>Tolyatti,Yuzhnoe shosse</Line1> </Address> </Consignor> </Participants> <Articles> <Article Line="1" LinePackagingLevel="1" Description="8450101577" Quantity="707" QuantityUnit="PCE" ArticleNumber="8450101577" ArticleNumberSA="8450101577" OrderNumber="617600" CodeLang="RU"> <Packages> <Package CountIdenticalPacks="2" QuantityPerPackage="300" QuantityPerPackageUnit="PCE" PackType="VAZ---0525"> <Labels CountLabels="2"> <TransportLabel Number="1"> <LabelSmall CULabel="052383035" BuyerNumber="LR1TTSTA"/> </TransportLabel> <TransportLabel Number="2"> <LabelSmall CULabel="052383063" BuyerNumber="LR1TTSTA"/> </TransportLabel> </Labels> </Package> <Package CountIdenticalPacks="1" QuantityPerPackage="107" QuantityPerPackageUnit="PCE" PackType="VAZ---0525"> <Labels CountLabels="1"> <TransportLabel Number="3"> <LabelSmall CULabel="052383064" BuyerNumber="LR1TTSTA"/> </TransportLabel> </Labels> </Package> </Packages> </Article> </Articles> </Document>