Инструкция по подключению для поставщиков:

Режимы работы с ФармХаб

Ручной режим

Интеграция может выполняться в ручном режиме (загрузка файлов через личный кабинет) и автоматическом режиме (через FTP).

В любом из вариантов необходимо произвести первоначальные настройки интеграции.

Для облегчения ручного режима скачайте и установите приложение интеграции

+7 495 120-01-12

mail@pharmhub.ru

Скачать

Войти

Контакты

Система заказа лекарств для аптек и клиник

Загрузка прайс-листа в ручном режиме доступна в каталоге:

Загрузка накладных доступна на странице заказа. Здесь Вы видите все полученные заказы от клиентов. Новые заказы также будут дублироваться на адрес электронной почты, указанной Вами в профиле организации.

Автоматический режим

Автоматический режим реализуется через FTP сервер, для этого необходимо настроить папки в которых будут прайс-листы, заказы и накладные. Сканирование папок на наличие обновлений производится каждую минуту. После того, как система ФармХаб обработает данные, они будет автоматически удалены с FTP-сервера. Если Вы хотите хранить файлы прайс-листов на своем сервере, то Вам необходимо предоставить нам логин и пароль, чтобы наша система могла автоматически сканировать его и обновлять цены и позиции Вашего каталога.

Работа через FTP-сервер ФармХаб

Структура FTP-сервера

Для того, чтобы система ФармХаб правильно определила тип документа, мы просим соблюдать определенную схему организации корневого каталога сервера:

  • папка “prices” для импорта прайс-листов
  • папка “orders” для экспорта заявок
  • папка “invoices” для импорта электронных накладных

 

Хотим заметить, что предлагаемая структура сервера с папками prices, invoices и orders не является жестко ограниченной. Вы можете создать папки для прайс-листов, накладных и заказов с любыми удобными Вам именами, поскольку это тоже настраивается в личном кабинете. Единственное ограничение — это должны быть три разные папки в корневом каталоге FTP-сервера.

Структура FTP-сервера

Интеграция с ФармХаб состоит из 3 этапов: экспорт прайс листов, импорт заявок и экспорт электронных накладных. Система ФармХаб умеет работать с тремя типами файлов: DBF, XML, CSV.

Настройки

Настройки доступны во разделе «Настройки», вкладка «Интеграция».

В настройках необходимо настроить импорт прайс-листов, экспорт заказов, и импорт электронных накладных в систему ФармХаб. Для этого необходимо, чтобы файлы прайс-листа, электронной накладной и заказа аптеки имели следующий вид:

Импорт прайс-листов в ФармХаб

Возможные форматы файла прайс-листа — DBF, XML и CSV.

 

A) Описание полей файла прайс-листа в форматах DBF и CSV:

  • Уникальный идентификатор товара — ID
  • Артикул (идентификатор партии товара) — ARTICLE
  • Название позиции (товара) — NAME
  • Название производителя — MANUF
  • Штрих-код (ЕАN13) — EAN13
  • Цена по умолчанию — PRICE
  • Остатки на складе — QNT
  • Минимальное количество товара в заказе — MIN_ORDE
  • Срок годности — EXP_DATE
  • Кратность заказа (то есть например если кратность заказа указана как 7, то количество заказываемого товара может быть равно 7, 14, 21 ... данного товара) — MULTI
  • Признак «является ЖНВЛП» — ZHNVLS

 

Скачать пример файла DBF

 

 

Б) Описание полей файла прайс-листа в формате XML:

  • Путь к корню прайс-листа — price/offer
  • Название позиции (товара) — $/title
  • Название производителя — $/manufacturer Штрих-код (EAN-13) — $/ean
  • Уникальный идентификатор товара — $/lotId
  • Артикул (идентификатор партии товара) — $/article
  • Цена по умолчанию — default/_
  • Остатки на складе — $/remainsQuantity
  • Минимальное количество товара в заказе — $/minimalQuantity
  • Срок годности — $/validThrough
  • Кратность заказа (то есть например если кратность заказа указана как 7, то количество заказываемого товара может быть равно 7, 14, 21 ... данного товара) — $/multiplicity
  • Признак «является ЖНВЛП» — $/gnvlp

 

Скачать пример файла XML

Виды прайс-листов

В системе ФармХаб реализована работа с одностраничными (один клиент — один прайс) и многостраничными прайс-листами (один прайс — множество клиентов). Так же есть возможность указать произвольное количество категорий цен, либо отдельными файлами, либо в одном. Для этого необходимо указать структуру прайс-листа

Для многостраничных прайс-листов необходимо внести названия категорий и название столбцов, в которых они хранятся в настройках личного кабинета.

Для одностраничных прайс-листов схема работы несколько иная. Система ожидает наличия на FTP-сервере в папке прайс-листов набор файлов, называющихся по схеме «PRICE_название категории.расширение», а также файл с именем PRICE.расширение, который будет использоваться в качестве базового прайс-листа для еще не подключенных к Вам клиентов. В случае отсутствия файла с именем PRICE необходимо указать название категории, которую следует использовать как базовую, в настройках:

В данном примере система ФармХаб будет ожидать наличия на FTP-сервере файла PRICE_Базовый.dbf.

Экспорт заказов из ФармХаб

Возможные форматы файла заказа — DBF, XML и CSV.

 

A) Описание полей файла заказа в формате DBF.

В квадратных скобках: первая буква — формат поля [N — число, D — дата, C — строка], первая цифра после буквы — размер, вторая цифра — точность.

  • Номер заказа у поставщика — NUM [N, 20]
  • Дата отправки заказа аптекой — DATE [D, 8]
  • Идентификатор позиции — OFFER [C, 20]
  • Количество товара в данной позиции — QNT [N, 10, точность = 2]
  • Цена данной позиции — PRICE [N, 10, точность = 2]
  • Название аптеки/клиники, сделавшей заказ — BUYER [С, 80]
  • Код аптеки/клиники, сделавшей заказ — BUYERID [C, 20]
  • Название товара — NAME [C, 80]

 

Скачать пример файла DBF

 

 

Б) Описание полей файла заказа в формате XML:

  • Имя корневого узла — order
  • Путь к узлу со статичными данными — metadata
  • Путь к узлу с табличными данными — demands
  • Имя единичного узла данных — demand
  • Настройки статичных полей XML-файла:
  • Номер заказа в системе ФармХаб или номер заказа у поставщика — orderId
  • Дата отправки заказа — dateSent
  • Код контрагента — contractorId
  • Название контрагента — contractorTitle
  • Комментарии — comments

 

Скачать пример файла XML

 

В) Формат файла CSV  Необходимо указать символ-разделитель — это

  • запятая ,
  • точка с запятой ;
  • вертикальная черта |

Настройки полей такие же, как для формата DBF.

Импорт электронных накладных в ФармХаб

Возможные форматы файла накладной — DBF, XML и CSV.

 

А) Описание полей файла накладной в формате DBF и CSV:

  • Название поля с идентификатором заказа — может располагаться как в поле внутри файла, так и в имени файла. Если это поле находится внутри файла, то его название — KOD_ZAKAZ
  • Идентификатор позиции — DRUGID
  • Количество — QTY Цена — PRICE

 

Скачать пример файла DBF

 

 

Б) Описание полей файла накладной в формате XML:

  • Название поля с идентификатором заказа — может располагаться как в поле внутри файла, так и в имени файла. Если это поле находится внутри файла, то путь к нему — invoice/metadata/$/orderId
  • Путь к корню списка позиций — invoice/demands/demand
  • Идентификатор позиции — $/lotId
  • Количество — $/quantity
  • Цена позиции — $/price

 

Скачать пример файла XML

Соответствие заказов и электронных накладных

На текущий момент в системе ФармХаб реализовано два сценария соотнесения накладных с заказами:

  • Уникальный идентификатор заказа в системе ФармХаб (UUID) ожидается как имя файла накладной (например, «85ee8b4e-b059-44cf-846f-c4cdb86b472d.dbf»). Этот идентификатор следует добавить в экспортируемый заказ в настройках (название поля — «Идентификатор заказа в системе ФармХаб»).
  • Порядковый номер заказа у поставщика, начинающийся с нуля, ожидается в отдельном поле внутри файла накладной. Это сценарий, предлагаемый складской программой аптек «Аптека-2007» от Регард Софт. В настройках это поле называется «Номер заказа у поставщика».

 Разумеется, мы открыты к диалогу и готовы рассмотреть возможность реализации сценария, устраивающего Вас.

Описание настроек форматов

Настройки DBF файлов

В настройках DBF файлов нужно указать названия полей и формат хранения дат. Наиболее часто встречающиеся варианты хранения дат:

  1. 20150505 → YYYYMMDD
  2. 12/16 → MM/YY
  3. 12.05.2015 →DD.MM.YYYY
  4. 2015-02-02 13:00:00 → YYYY-MM-DD HH:mm:ss

Настройки XML файлов

В настройках XML файлов необходимо указать путь к узлам и атрибутам. Узлы разделяются косой чертой (/), доступ к атрибутам обозначается через $, выборка по значению атрибута указывается в квадратных скобках.

Пример: Orders/Order/[type:sometype]/$/name — будет искаться узел <Order>, являющийся дочерним узлом <Orders>, у которого атрибут «type» равен «sometype». У этого узла будет выбираться значение атрибута «name».

Настройки CSV файлов

Система ФармХаб умеет работать с CSV файлами с заголовком и без. Это можно указать в настройках. Для файлов с заголовком указываются имена столбцов, без — порядковый номер столбца, начинающийся с 0.

Приложение под Windows для интеграции с 1С:Предприятие

Требования к ПО: — Windows Installer 4.5 — Microsoft .NET Framework 4 (x86 и x64) Если эти требования удовлетворены, то вы можете запустить приложение. В противном случае, нажмите на кнопку ниже и установите требуемое ПО автоматически.

Скачать

Система заказа для предприятий

обслуживания и торговли

Сделано в sohomedia.ru

Пользовательское соглашение

Адрес:

Москва, Большой Трехгорный

переулок., 1/26, стр.7

ООО «ФармХаб». 2014–2017 Все права защищены.