Требования к накладным
Для автоматической загрузки накладных для клиентов, использующих ПО "Аптека56", следует выполнять следующие требования:
- файл накладной должен быть в формате xml (подробнее см. описание электронной накладной);
- имя файла должно соответствовать маске <код клиента>_<код грузополучателя>_<№ накладной>.xml, где <код клиента> - код клиента в учётной системе поставщика, <код грузополучателя> - код точки доставки в учётной системе поставщика, <№ накладной> - номер накладной.
Код клиента и код грузополучателя нужно сообщить сотрудникам "Аптека56" для корректной настройки получения накладных клиентом. Для этого достаточно на почту support@mail.apteka56.ru направить письмо следующего содержания:
Новый клиент:
Наименование клиента ...
ИНН ...
Код клиента ...
Код грузополучателя ...
Поставщик ...
Примеры накладных можно скачать с Яндекс Диска по адресу https://disk.yandex.ru/d/EqBUr7Us_IJeBA.
Описание электронной накладной для ПО "Аптека56"
| Имя файла | Должно быть в виде: код клиента_код грузополучателя_номер накладной.xml или код грузополучателя_номер накладной.xml (если кода ЮР лица нет). Примеры: 227990_227992_267195839_001.xml где 227990 – код клиента , 227992 - код грузополучателя, 267195839_001 - номер накладной 166603_C000-163616.xml, где 166603 - код клиента , C000-163616 - номер накладной |
| Структура файла | Электронная накладная представляет собой файл в формате XML со следующей типовой структурой: <?xml version="1.0" encoding="windows-1251" ?> <Документ> <ЗаголовокДокумента> <ТипДок>ПРХ</ТипДок> <НомерДок>...</НомерДок> <ДатаДок>...</ДатаДок> <НомерЗаказа>...</НомерЗаказа> <ДатаОтгрузки>...</ДатаОтгрузки> <ДокументМДЛП ТипСхемы="1">2</ДокументМДЛП> <ИсточникФинансирования>...</ИсточникФинансирования> <ТипДоговора>...</ТипДоговора> <НомерКонтракта>...</НомерКонтракта> <Поставщик МестоДеятельности="...">...</Поставщик> <Получатель МестоДеятельности="...">...</Получатель> <Грузополучатель>...</Грузополучатель> <УсловияОплаты>...</УсловияОплаты> <ТоварнаяГруппа/> <Позиций>..</Позиций> <СуммаОпт>...</СуммаОпт> <СуммаНДС></СуммаНДС> <СуммаОптВклНДС></СуммаОптВклНДС> <РеквизитыПоставщика> <Адрес>...</Адрес> <ИНН>...</ИНН> <Телефоны>...</Телефоны> <РасчетныйСчет>...</РасчетныйСчет> <Город>...</Город> <Банк>...</Банк> <ОтделениеБанка>...</ОтделениеБанка> <БИК>...</БИК> <КорСчет>...</КорСчет> <ЭлПочта>...</ЭлПочта> </РеквизитыПоставщика> </ЗаголовокДокумента> <ТоварныеПозиции> <ТоварнаяПозиция> <Товар>…</Товар> … <Серии> <Серия>…</Серия> <Серия>…</Серия> </Серии> <СписокКиз> <ЗначениеКиз>… <ЗначениеКиз> … </СписокКиз ТипКиз =””> </ТоварнаяПозиция> <ТоварнаяПозиция> … </ТоварнаяПозиция> </ТоварныеПозиции> </Документ> Начальные и конечные теги являются обязательными для всех элементов документа. Если элемент не является обязательным, а его значение не определено, то наличие начального и конечного тегов не обязательно. Если элемент является обязательным, а его значение не определено, то следует указывать начальный и конечный тег. Для пустых значений элементов возможно упрощённое указание: <ЭЛЕМЕНТ />, например, если не определены серии по товарной позиции, то можно указать <Серии />. |
| Формат данных | Текст — текст в кодировке windows-1251 в соответствии с форматом XML. Целое — целое число. Дата — дата в формате ДД.ММ.ГГГГ. Numeric — десятичное с разделителем точка. Четыре символа, встречающиеся в текстовых полях, заслуживают особого внимания, т.к. они используются для экранирования специальных символов: < представляет символ < (левая угловая скобка) > представляет символ > (правая угловая скобка) & представляет символ & (амперсанд) " представляет символ " (двойная прямая кавычка). При необходимости использовать символ «<» следует указывать «<» (десятичный ASCII код 60) для исключения путаницы с символом начала тега (разделитель начала тега). При необходимости использовать символ «>» следует указывать «>» (десятичный ASCII код 62) для исключения путаницы с символом конца тега (разделитель конца тега). Вместо «&» следует указывать «&» (десятичный ASCII код 38) для исключения путаницы с символом начала ссылки на символ (разделитель начала символьной ссылки). Кроме того, «&» следует использовать в значениях атрибутов. В некоторых случаях необходимо использовать «"» для экранирования двойной прямой кавычки ("), т.к. она может являться разделителем значений атрибутов. |
| Типы элементов | Required — обязательный элемент документа. Optional — необязательный элемент документа. |
| Элементы документа | <!ELEMENT ДОКУМЕНТ - - (ЗаголовокДокумента, ТоварныеПозиции)-- корневой элемент Документ --> <!ATTLIST ДОКУМЕНТ Идентификатор %Guid; #Optional -- уникальный идентификатор --Формат %целое; #Optional -- идентификатор формата --> |
| Описание атрибутов | Идентификатор=Guid Optional. Формат=целое Optional. Идентификатор формата электронной накладной: 1 — внешняя приходная накладная поставщика; 2 — приходная накладная для режима работы по кодам с единым (универсальным) товарным справочником. Значение по умолчанию 1. После декларации типа документа всё содержимое электронной накладной заключается в элемент ДОКУМЕНТ. Таким образом, типовая структура электронной накладной выглядит следущим образом: <?xml version="1.0" encoding="windows-1251" ?> <Документ> … здесь следуют ЗаголовокДокумента и ТоварныеПозиции … </Документ>. |
| Название элемента | Тип элемента | Формат | Описание |
| <!ELEMENT ЗаголовокДокумента -- | Required | (НомерДок, ДатаДок, Поставщик, Получатель, Позиций, СуммаОпт, СуммаОптВклНДС) -- шапка электронной накладной -->. Элемент ЗаголовокДокумента содержит общую информацию о данной электронной накладной, такую как номер, поставщик, получатель, сумма, и прочую информацию, не являющуюся содержанием документа. | |
| <!ELEMENT НомерДок -- номер электронной накладной --> | Required | Текстовое поле до 15 символов. | Определяет номер электронной накладной. Обычно совпадает с номером счёт-фактуры. |
| <!ELEMENT ДатаДок -- дата электронной накладной --> | Required | Дата | Элемент ДатаДок определяет дату электронной накладной. |
| <!ELEMENT НомерЗаказа -- номер заказа --> | Optional | Текстовое поле до 15 символов. | Определяет номер заказа на основании которого собрана данная поставка товара (номер входящего заказа). |
| <!ELEMENT Примечание -- примечание к документу --> | Optional. Обязателен для Интернет-заказов | Текстовое поле. | определяет примечание к электронной накладной. Обязательно к заполнению у интернет-заказов (аптека.ру, здравсити, польза) пример заполнения: AM-143936607 apteka.ru +79058991168 Где AM-143936607 - номер заказа, apteka.ru - агрегатор , +79058991168 - телефон клиента |
| <!ELEMENT ДокументМДЛП – Признак Документа МДЛП --> | Optional | Целое. Принимает значения 0, 1 или 2 По умолчанию 0 | Определяет позиции документа, являются ли они МДПЛ товаром (0 – все позиции по документу не является МДЛП товарами, 1- все позиции по документу МДЛП товары, 2 – документ содержит как МДЛП товары, так и не МДЛП товары (смешанная накладная)). |
| Optional. Обязательный, если документ является МДПЛ | Целое. Принимает значения 0, 1 По умолчанию 0 | Определяет тип схемы акцептирования по которой производжится отгрузка товара по данной накладной. Принимает значения 0 – прямая схема или 1 – обратная схема. | |
| <!ELEMENT ТипДоговора – Тип договора --> | Optional | Целое. Принимает значения от 1 до 8 По умолчанию 1 | Определяет тип договора продажи товара по накладной. Может принимать следующие значения: 1 - Купли продажи, 2 – Комиссия (интернет-заказы), 3 – Агентский, 4 – Передача на безвозмездной основе, 5 – Возврат контрактному поизводителю, 6 – государственное лекарственное обеспечение, 7 - договор консигнации, 8 - собственные средства. Тег не обязательный для позиций не МДЛП. |
| <!ELEMENT Поставщик -- наименование организации поставщика --> | Required | Текстовое поле до 50 символов. | Определяет наименование организации поставщика. |
| Optional. Обязательный, если документ является МДПЛ | Текстовое поле до 36 символов | Определяет ИД места деятельности грузоотправителя. | |
| <!ELEMENT Получатель -- наименование организации получателя --> | Required | Текстовое поле до 50 символов. | Определяет наименование организации получателя. |
| Optional. Обязательный, если документ является МДПЛ | Текстовое поле до 36 символов | Определяет ИД места деятельности грузополучателя. | |
| <!ELEMENT Грузополучатель -- наименование точки получателя --> | Optional | Текстовое поле до 50 символов. | Определяет наименование/адрес грузополучателя |
| <!ELEMENT Позиций -- количество позиций поставки --> | Required. | Целое | Позиций определяет количество позиций, входящих в данную поставку. |
| <!ELEMENT СуммаОпт -- сумма поставки без НДС --> | Required | numeric | Определяет сумму поставки без НДС, должна соответствовать сумме по документу утвржденной в ЭДО. Если поставка является БОНУСНОЙ (без оплаты) - значение равно 00,00 |
| <!ELEMENT СуммаНДС -- сумма НДС поставки --> | Optional. Обязательный для организаций применяющих УСН (без НДС, НДС5% или 7%) | numeric | Определяет сумму НДС, должна соответствовать сумме по документу утвржденной в ЭДО. Если поставка является БОНУСНОЙ (без оплаты) - значение равно 00,00 |
| <!ELEMENT СуммаОптВклНДС -- сумма поставки с НДС --> | Required | numeric | Определяет сумму поставки с НДС, должна соответствовать сумме по документу утвржденной в ЭДО. Если поставка является БОНУСНОЙ (без оплаты) - значение равно 00,00 |
| <!ELEMENT СтавкаНДС -- пониженная ставка НДС Поставщика, --> | Optional. Обязательный для организаций применяющих УСН (без НДС, НДС5% или 7%) | numeric | Определяет ставку НДС Поставщика выраженную в процентах (указывают только те кто применяет пониженные ставки НДС 5% или 7%, либо 0% для неплательщиков НДС. Для ОСН и УСН с НДС - не указывается либо пустое значение.) |
| <!ELEMENT ТипДок -- тип электронной накладной --> | Optional. | Текстовое поле. до 15 символов. | определяет тип электронной накладной. Возможные значения: ПРХ, ВНПРХ, ЦЕНПРХ, ОСТПРХ. По умолчанию ПРХ. |
| <!ELEMENT ДатаОтгрузки -- дата отгрузки товара --> | Optional. | Дата | Определяет дату отгрузки товара. |
| <!ELEMENT ДатаОпл -- дата оплаты накладной --> | Required | Дата | Определяет дату оплаты накладной. |
| <!ELEMENT РеквизитыПоставщика --> | Required | является контейнером для элементов, описывающих реквизиты поставщика. | |
| <!ELEMENT Адрес -- почтовый адрес юридического лица --> | Optional | Текстовое | |
| <!ELEMENT ИНН -- индивидуальный номер налогоплательщика юридического лица --> | Required | Целое | |
| <!ELEMENT КПП -- КПП юридического лица --> | Required | Целое | |
| <!ELEMENT Телефоны -- контактные телефоны --> | Optional | Текстовое | |
| <!ELEMENT ОКОНХ -- --> | Optional | Текстовое | |
| <!ELEMENT ОКПО -- --> | Optional | Текстовое | |
| <!ELEMENT РасчетныйСчет -- --> | Optional | Целое | |
| <!ELEMENT Город -- --> | Optional | Текстовое | |
| <!ELEMENT Банк -- --> | Optional | Текстовое | |
| <!ELEMENT ОтделениеБанка -- --> | Optional | Текстовое | |
| <!ELEMENT КорСчет -- --> | Optional | Целое | |
| <!ELEMENT ЭлПочта -- --> | Optional | Текстовое | |
| <!ELEMENT ТоварныеПозиции - - (ТоварнаяПозиция) -- содержимое электронной накладной --> | Required | является контейнером для элементов ТоварнаяПозиция, описывающих товарные позиции, входящие в данную поставку. | |
| <!ELEMENT ТоварнаяПозиция- - Парметры товара -- описание товарной позиции --> | Required | Элемент ТоварнаяПозиция содержит детальную информацию о товаре, такую как наименование, изготовитель, цены, суммы, серии и прочую информацию. | |
| <!ELEMENT Товар -- наименование товарной позиции --> | Required | Текстовое поле до 255 символов. | |
| <!ELEMENT МНН – Международное непатентованное название --> | Required | Текстовое поле до 250 символов. | |
| <!ELEMENT Изготовитель -- наименование предприятия изготовителя --> | Required | Текстовое поле до 255 символов. | |
| <!ELEMENT ДатаОтгрузкиИзготовителем – дата реализации лекарственного препарата производителем на территории Российской Федерации | Required | Дата | |
| <!ELEMENT Количество - количество натуральных единиц поставляемой позиции --> | Required | Целое | |
| <!ELEMENT ЦенаИзг -- отпускная цена предприятия изготовителя без учета НДС--> | Required | numeric | |
| <!ELEMENT ЦенаГР -- цена по государственному реестру --> | Required | numeric | |
| <!ELEMENT НаценОпт -- наценка предприятия поставщика по отношению к цене завода изготовителя, выраженная в процентах --> | Required | numeric | |
| <!ELEMENT ЦенаОпт -- цена предприятия поставщика без учета НДС --> | Required | numeric | |
| <!ELEMENT СуммаОпт -- сумма предприятия поставщика без учета НДС --> | Required | numeric | |
| <!ELEMENT СтавкаНДС -- налоговая ставка НДС, выраженная в процентах --> | Required | numeric. Допустимые значения: 0, 10, 20. | Определяет ставку НДС ТОВАРА, выраженную в процентах. Должна быть указана всеми поставщиками в т.ч. теми кто не платит НДС либо платит по пониженным ставкам. Допустимые значения: 0, 10, 20. |
| <!ELEMENT ЦенаОптНДС -- цена предприятия поставщика с учетом НДС --> | Required | numeric | |
| <!ELEMENT СуммаНДС -- Сумма НДС от цены предприятия поставщика --> | Required | numeric | |
| <!ELEMENT СуммаОптВклНДС -- сумма предприятия поставщика с учётом НДС --> | Required | numeric | |
| <!ELEMENT КодТовара --> | Required | целое или текстовое поле до 40 символов | Код товара в товарном справочнике поставщика. Код товара должен идентифицировать товар с учетом производителя. |
| <!ELEMENT СтранаИзготовителя -- государство предприятия изготовителя --> | Required | текстовое поле до 30 символов. | |
| <!ELEMENT ЦенаКлиента – Рекомендуемая цена продажи. Цена по интернет заказу --> | Optional. Обязателен для Интернет-заказов | numeric. | |
| <!ELEMENT ЕАН13 -- внешний штрих-код формата EAN13 --> | Optional | текстовое поле до 13 символов. | |
| <!ELEMENT ГТД -- номер государственной таможенной декларации --> | Optional | Текстовое поле до 30 символов. | |
| <!ELEMENT Сильнодействующий -- признак --> | Optional | Целое. Принимает значения 0 или 1 По умолчанию 0 | |
| <!ELEMENT Рецептурный -- признак отпуска по рецепту врача --> | Optional | Целое. Принимает значения 0 или 1 По умолчанию 0 | |
| <!ELEMENT Серии - - (Серия) -- контейнер для серий товарной позиции --> | Required | Является контейнером для элементов Серия, описывающих информацию по сериям и сертификатам для данной товарной позиции. | |
| <!ELEMENT Серия - - (СерияТовара, СрокГодностиТовара) -- контейнер для детальной информации о серии и сертификатах --> | Optional | контейнер для детальной информации о серии и сертификатах | |
| <!ELEMENT СерияТовара -- номер серии --> | Required | Текстовое поле до 20 символов. | |
| <!ELEMENT СрокГодностиТовара -- срок годности товарной позиции --> | Required | Дата | |
| <!ELEMENT НомерСертиф -- номер сертификата --> | Optional | Текстовое поле до 50 символов. | |
| <!ELEMENT ОрганСертиф -- орган сертификации --> | Optional | Текстовое поле до 50 символов. | |
| <!ELEMENT ДатаВыдачиСертиф -- дата выдачи сертификата --> | Optional | Дата | |
| <!ELEMENT СрокДействияСертиф -- дата окончания действия сертификата --> | Optional | Дата | |
| <!ELEMENT РегНомер -- региональный номер сертификата --> | Optional | Текстовое поле до 50 символов. | |
| <!ELEMENT РегДатаСертиф -- дата выдачи регионального сертификата --> | Optional | Дата | |
| <!ELEMENT РегОрганСертиф -- региональный орган сертификации --> | Optional | Текстовое поле до 50 символов. | |
| <!ELEMENT МДЛП – признак МДЛП товара --> | Optional. Обязателен для маркированного товара | Целое. Принимает значения 0 или 1 По умолчанию 0 | Обязательное поле для маркированного товара. Если заполнено поле ТипТовара, то значение <МДЛП>0</МДЛП> должно быть 0 Формат: целое. Принимает значения: 0 – группа не определена, 1 - Вода, 2 - БАД, 3 - Антисептики, 4 – Медизделия Значение GTIN должно быть заполнено в поле ELEMENT СписокКиз |
| <!ELEMENT СписокКиз – При прямой схеме акцептирования принимает значение SSCC, либо списка SGTIN. При обратной схеме акцептирования принимает значение GTIN. --> | Optional. Обязателен для маркированного товара | ||
| <!ATRIBUTES ТипКиз -- атрибут ТипКиз может принимать одно из значений GTIN, SGTIN, либо SSCC | Optional. Обязателен для маркированного товара | Элемент СписокКИЗ является контейнером для элементов ЗначениеКиз | |
| <!ELEMENT ЗначениеКиз – значение GTIN, SSCC, либо SGTIN для документа МДПЛ | Optional. Обязателен для маркированного товара | текстовое поле до 36 символов. |