Стандарт электронного взаимодействия системы единого заказа медикаментов ГУП "Столичные аптеки" SANet Order (стр. 1 )

СТАНДАРТ

электронного взаимодействия

системы единого заказа медикаментов

ГУП "Столичные аптеки"

SANet Order

версия 1.37

последние изменения внесены

"15" декабря 2010г.

МОСКВА

2010

СОДЕРЖАНИЕ

1.  ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ

2.  НАЗНАЧЕНИЕ

3.  ФОРМАТЫ

4.  СОГЛАШЕНИЯ О НАИМЕНОВАНИЯХ

5.  Нормативно-справочная информация

6.  ОПЕРАТИВНАЯ информация

6.1. Прайс-листы

6.2 Заказ АПТЕКИ

6.3 ЭЛЕКТРОННАЯ НАКЛАДНАЯ ДИСТРИБЬЮТОРА

6.4 СЧЕТ-ПРОТОКОЛ

6.5 СВОДНАЯ ЭЛЕКТРОННАЯ НАКЛАДНАЯ

6.6 ДЕФЕКТУРА ДИСТРИБЬЮТОРА

6.7 СВОДНАЯ ДЕФЕКТУРА

6.8 СВЕДЕНИЯ О ПРЕПАРАТАХ ОТПУЩЕННЫМ ПО РЕЦЕПТАМ, ВЫДАННЫМ НА ОСНОВАНИИ РОДОВЫХ СЕРТИФИКАТОВ

6.9 НАКЛАДНЫЕ НА ВНУТРЕННЕЕ ПЕРЕМЕЩЕНИЕ (МЕЖАПТЕЧНАЯ ПЕРЕБРОСКА).

АННОТАЦИЯ

Данный документ описывает стандарты электронного взаимодействия между различными автоматизированными информационными системами, участвующими в обмене данными в рамках системы единого заказа медикаментов ГУП города Москвы "Столичные аптеки" (далее Система).

Заказчиком стандартов является ГУП города Москвы "Столичные аптеки". Пользователем стандартов являются ГУП города Москвы "Столичные аптеки", его филиалы (аптеки), дистрибьюторы лекарственных средств и изделий медицинского назначения, а также разработчики программного обеспечения автоматизации учета движения товара в аптеках.

Информация о стандартах является открытой для использования любыми информационными системами. Ссылка на использование данных стандартов не является обязательной.

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

Пользователи стандартов могут присылать свои замечания и предложения по их использованию по адресу: *****@***ru.

Текущая версия стандартов доступна по адресу http://*****/sa/standartofexchange. doc

Перечень изменений

Данный раздел содержит краткий перечень изменений и дополнений, внесенных в документ, начиная с версии 1.07 от "10" ноября 2005г.

Версия 1.37 от 01.01.2001

В выгрузку прайс-листов переоценки PRC_DRUGS внесены изменения, название поля PRC_PRICE изменено на RET_PRICE(см. п.5.11).

Версия 1.36 от 01.01.2001

В выгрузку DRUGS внесены изменения, добавлено два поля (см. п.5.3).

Версия 1.35 от 01.01.2001

Описание загрузки накладных на внутреннее перемещение (см. п.6.9).

Версия 1.34 от 01.01.2001

Изменен формат выгрузки справочника контрагентов (п. 5.5). Поле nk расширено до 250 символов.

Описание выгрузки справочника “Прайс-лист переоценка” (см. п.5.11).

Версия 1.33 от 01.01.2001

Изменен формат накладных – добавлено поле VAL_TYPE (вид валюты) - необходимо для печати «Протокола согласования цен» для ЖНВЛС. Правила для заполнения полей (для ЖНВЛС):

PROD_PRICE - Фактическая отпускная цена производителя в рублях без НДС

IMP_PRICE - Зарегистрированная предельная отпускная цена производителя в иностранной валюте (без НДС)

REG_PRICE - Зарегистрированная предельная отпускная цена производителя в рублях без НДС.

В случае если предельная отпускная цена на ЖНВЛС иностранного производителя зарегистрирована в рублях, то она проставляется в поле REG_PRICE, а если в иностранной валюте (вид валюты и цена указываются в полях IMP_PRICE и VAL_TYPE соответственно) - то пересчитывается организацией-импортером в рубли по курсу Центрального банка Российской Федерации на дату оформления грузовой таможенной декларации и указывается в поле REG_PRICE.

Фактическая отпускная цена (в рублях) на ЖНВЛС иностранного производителя указывается с учетом таможенной пошлины и сборов за таможенное оформление.

Версия 1.32 от 01.01.2001

Изменен расчет накладных при загрузке – для медикаментов из списка ЖНВЛС обязательно для заполнения поле WHS_ADDP (Оптовая надбавка дистрибьютора).

Версия 1.31 от 01.01.2001

Изменен формат выгрузки справочника контрагентов(п 5.5). Поле nam_k расширено до 80 символов. Добавлено поле LASTDATE - дата и время последнего изменения информация о контрагенте.

Описание выгрузки справочника “Сопутствующие товары.”(см. п.5.10).

Версия 1.30 от 01.01.2001

В содержимое прейскурантов цен (Выгрузка для СУДТ «Aптека 2000») добавлено поле ELT_ID (тип накладной) (п.6.4.3). Возможные варианты значений: 1 – прием товара, -1 – возврат товара, 2 – внутренняя накладная на прием товара, 3 – излишки, -2 – внутренняя накладная на возврат товара, 4 – прием товара для «Мелкого опта ЛПУ», 5 - Хозтовары.

Версия 1.29 от 01.01.2001

В содержимое электронных накладных и прейскурантов цен (счет-протокол) добавлены поля GL_ID (ссылка на таблицу GLTYPE) и RET_SUMS (сумма по товару с НДС в розничных ценах по строке) (п.6.3.1, 6.4.2, 6.4.3). Изменен порядок расчета Розничных сумм в зависимости от содержимого поля GL_ID (п. 6.4.2).

Добавлено описание структуры таблицы GLTYPE (п.5.9).

Версия 1.28 от 01.01.2001

В прайс-лист (PD. DBF) дистрибьютора добавлено поле SERIES (Серия) (п.6.1).

В заказ (QD. DBF) добавлены два поля: LAST_DATE (Срок годности) и SERIES (Серия). Данные поля заполняются в случае заказа с PLW_ID > 1 (п.6.2.1)

Версия 1.27 от 01.01.2001

Внесены уточнения по заполнению полей «Цена производителя» и «Контрактная цена иностранного производителя». Данные поля должны заполняться значениями без НДС (п. п. 6.3.1, 6.4.2, 6.4.3, 6.5.2)

Изменено правило заполнения дефектуры поставщиков. Поле «ИД заказа» стало обязательным для заполнения.(пункт 6.6.1)

Версия 1.26

Изменено описание файла импорта реестра препаратов отпущенных по рецептам, выданным на основании родовых сертификатов (см. п.6.8). Добавлено поле PD_PRICE. Изменено правило заполнения поля WHS_PRICE – оно должно заполняться значением без НДС. Приведены правила заполнения некоторых полей.

Версия 1.25

Добавлено:

В прейскурант цен в формате A2000 (SP. DBF) добавлена колонка IMP_PRICE Numeric(12,2) – Контрактная цена иностранного производителя (п. п. 6.4.3);

Версия 1.24

Добавлено:

В электронных накладных (ED. DBF) и в прейскуранты цен (SD. DBF) добавлена колонка IMP_PRICE Numeric(12,2) – Контрактная цена иностранного производителя (п. п. 6.3,6.4,6.5);

Версия 1.23

Добавлено:

Описание выгрузки справочника “Женские консультации” (см. п.5.8).

Описание файла импорта реестра препаратов отпущенных по рецептам, выданным на основании родовых сертификатов (см. п.6.8).

Версия 1.22

Добавлено:

Описание выгрузки «Экспортируемых складских групп» (см. п.5.7).

Версия 1.21

Изменено: В электронных накладных (ED. DBF) добавлена колонка QL_ID Numeric(16) – код заказа;

Версия 1.20

Изменено: В заказе (QD. DBF) добавлена колонка SAO_ID Numeric(3) – источник заказа: 1 – Аптека, 2 – Дистрибьютор(заказ по дефектуре), 3 - ЦЕЗ;

Версия 1.19

Изменено: В описании файла PQ. DBF – файла розничного прайс-листа.

Формат поля PACK_QTTY изменён с Numeric(4) на Numeric(10)

Версия 1.18

Добавлено: Описание нового файла PQ. DBF – файл розничного прайс-листа.

Версия 1.17

Изменено: В дефектуре (DDXXXX. DBF) добавлена колонка QL_ID Numeric(16) – код заказа;

В прайс-листе (PD. DBF) изменен тип поля WHS_QTTY на Numeric(14,5).

Добавлено: Описание нового файла QI. DBF – файл импорта заказа из системы УДТ и файл QE. DBF файл ответов на заказ.

Версия 1.16

Изменено: В электронных накладных изменен тип поля GTD на CHAR(30).

Версия 1.15

Изменено: В заказах, электронных накладных и дефектуре изменен тип поля QTTY на Numeric(14,5).

Версия 1.14

Добавлено: В заголовок электронной накладной добавлено поле ELT_ID (тип накладной) Numeric (3). Возможные варианты значений :

1 – накладная на отгрузку,

2 – внутренняя накладная на отгрузку,

3 – излишки,

-1 – накладная на возврат поставщику,

-2 – внутренняя накладная на возврат.

Версия 1.12

Добавлено:

Описание выгрузки медикаментов, относящихся к складской группе «Обязательный ассортимент»

Версия 1.11.

Исправлено:

1.  Алгоритм расчета WHS_SUM0 (WHS_SUM1, WHS_SUM2),

2.  Тип колонки QTTY вернули на N 6,0

3.  Кодировка в DBF файлах – DOS

Версия 1.10.

Добавлено:

1.  Связь между накладными и заказами – поле QL_ID в таблице EL.

2.  Добавлены поля WHS_SUMS, WHS_NDSS в таблицы ED, SD

3.  Описаны правила расчетов некоторых полей в ED и EL, если они не заполнены.

Версия 1.07.

Добавлено:

1. Введено понятие дефектуры у дистрибьютора, которое реализуется следующим образом. В случае отсутствия у дистрибьютора или самой упаковки медикамента, полученной им в заказе, или необходимого (заказанного аптекой) количества, он должен сформировать электронный документ в соответствии с форматами и правилами, описанными в п. 6.6, где перечислить дефектурные позиции и отказанное количество.

Версия 1.06.

Изменено:

1. Тип поля CLIENT_ID в таблице CLIENTS изменен с N6 на С7.

1. ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ

В настоящем документе применяются следующие термины и определения:

a.  Информационная система – совокупность программных средств вместе с базами данных, которыми манипулируют эти программные средства.

b.  База данных – совокупность данных, организованных по определенным правилам, предусматривающим общие принципы описания, хранения и манипулирования данными, независимая от прикладных программ

c.  Данные – информация, представленная на электронном носителе в форме, пригодной для обработки программными средствами.

d.  Система – распределенная информационная система электронного заказа медикаментов ГУП города Москвы «Столичные аптеки».

e.  «Единый городской классификатор лекарственных средств и изделий медицинского назначения» (ЕГК) – база данных, описывающая весь аптечный ассортимент, включая: лекарственные средства, лекарственные растения, гомеопатические препараты, биологически-активные добавки, косметические средства, медицинская технику, предметы ухода за больными. Ведется Разработчиком. Подмножество данных ЕГК, необходимое для работы данной Системы, распространяется бесплатно. Обновление информации происходит еженедельно. База данных ЕГК доступна в виде копии в формате DBF или в виде открытого журнала транзакций по адресу ftp://ftp. *****/EGK/Light (еженедельно выкладывается очередная версия ЕГК, файлы имеют вид LIG_0916.ARJ – это означает, что он сформирован 19 сентября текущего года). Все права на ЕГК, включая Интернет, принадлежат XXI» Если по каким-либо причинам в ЕГК отсутствуют необходимые для работы в «Единой Системе Заказа» медикаменты, то следует связаться с Клюевой Еленой Викторовной по телефону +7(499).

f.  Упаковка медикамента – детализированное описание объекта из ЕГК, необходимое для учета движения товара в розничном аптечном предприятии, включающее в себя:

Параметр	Пример
Торговое наименование	5-НОК
Лекарственная форма	р-р д/и 2%
Форма выпуска	амп 10мл
Фасовка (первичная и вторичная)	№ 50х1
Производитель	Варшавский ФЗ Польфа
Страна	Польша

g.  Медикамент – обобщенное описание объекта из ЕГК, используемое для облегчения интерфейса пользовательских приложений при поиске упаковок медикаментов, включающее в себя:

Параметр	Пример
Торговое наименование	5-НОК
Лекарственная форма	р-р д/и 2%
Форма выпуска	амп 10мл

h.  Офис – центральный офис ГУП «Столичные аптеки».

i.  Аптека – государственное аптечное предприятие, входящее в ГУП «Столичные аптеки».

j.  Дистрибьютор – оптовый поставщик упаковок медикаментов для аптек.

k.  Прайс-лист дистрибьютора – структурированные данные, передаваемые дистрибьютором в офис и содержащие текущий ассортимент упаковок медикаментов.

l.  Клиент дистрибьютора – клиентское программное обеспечение, которое может быть установлено у дистрибьютора для облегчения приема/передачи данных между ним и офисом. Функции клиента-дистрибьютора сводятся к авторизированному доступу и передаче на FTP-сервер офиса прайс-листов и электронных накладных, а также приему с FTP-сервера поступивших заявок от аптек.

m.  Клиент аптеки – программное обеспечение, являющееся частью Системы, установленное в аптеке.

n.  Заявка аптеки – перечень упаковок медикаментов из прайс-листов с указанием необходимого количества. Передается дистрибьютору из офиса.

o.  Электронная накладная – электронный документ, формируемый дистрибьютором и передаваемый им в офис. Содержит данные об отгруженных дистрибьютором упаковках медикаментов в аптеку.

p.  УДТ – программное обеспечение автоматизированной системы учета движения товара в аптеке.

q.  Счет-протокол – электронный документ, формируемый аптекой, на основании полученной от дистрибьютора электронной накладной. Используется аптекой при приеме поставок упаковок медикаментов и постановки их на товар. Выгружается клиентом аптеки для последующей загрузки в УДТ.

r.  Идентификатор (ИД) – уникальный код объекта данного класса, позволяющий однозначно идентифицировать его в ряду других объектов данного класса.

2.  НАЗНАЧЕНИЕ

Стандарты электронного взаимодействия единой системы заказа медикаментов ГУП города Москвы «Столичные аптеки» (далее стандарты) предназначены для унификации регламентов и форматов представления данных обо всех бизнес-процессах на этапе от выставления прайс-листа дистрибьютором до постановки товара на учет в аптеке.

Стандарты обеспечивают унификацию следующих процессов:

1.  Получение офисом прайс-листов дистрибьюторов.

2.  Передача заявок аптек из офиса дистрибьюторам.

3.  Получение дистрибьютором заявок аптек.

4.  Получение офисом электронных накладных от дистрибьюторов.

5.  Выгрузка счетов-протоколов для систем автоматизации учета движения товара.

3.  ФОРМАТЫ

Любое взаимодействие различных информационных субъектов в рамках Системы происходит через файловую систему путем импорта/экспорта данных. Стандартами поддерживается формат представления данных - DBF. В DBF файлах используется кодировка DOS.

4.  СОГЛАШЕНИЯ О НАИМЕНОВАНИЯХ

Данные в формате DBF хранятся в файлах с расширением DBF. Структура DBF-файлов описана в данном документе.

Все информационные потоки, описываемые в стандартах (прайс-лист, заявка, электронная накладная и счет-протокол), имеют двухуровневую структуру представления данных: заголовок и содержимое.

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

5.  Нормативно-справочная информация

В стандартах используется следующая нормативно-справочная информация:

5.1  Сведения об организациях, входящих в ГУП «Столичные аптеки». Хранятся в файле RET. DBF. Примеры файлов с последней версией структуры доступны по адресу http://*****/sa. Предоставляются бесплатно.

Структура файла RET. DBF:

Содержание поля	Тип	Ключ	Имя поля
ИД организации	N 6,0	PK	RET_ID
Ссылка на родителя	N 6,0	FK	RET_PAR
Новый номер аптеки	C 7		NEW_NUM
Наименование организации (аптека, филиал, отдел)	C 78		RET_NAME
Адрес	C 78		RET_ADR
Проезд	C 254		RET_PATH
Контактные телефоны	C 64		RET_PHONE

5.2 Сведения о дистрибьюторах, работающих в Системе. Хранятся в файле WHS. DBF. Примеры файлов с последней версией структуры доступны по адресу http://*****/sa. Предоставляются бесплатно.

Структура файла WHS. DBF:

Содержание поля	Тип	Ключ	Имя поля
ИД организации	N 6,0	PK	WHS_ID
Наименование организации	C 78		WHS_NAME
Адрес	C 78		WHS_ADR
Контактные телефоны	C 64		WHS_PHONE

5.3  В качестве справочника медикаментов используется городской стандарт представления данных о лекарственных средствах и изделиях медицинского назначения – Единый Городской Классификатор ЛС и ИМН. ЕГК поставляется в объеме, достаточном для функционирования всех субъектов Системы (соответствует публикации ЕГК для версии Light). Последняя версия ЕГК доступна в виде копии базы данных (набор файлов в формате DBF, кодировка Windows) либо в виде открытого журнала транзакций (формат CSV, кодировка Windows) по адресу ftp://ftp. *****/EGK/Light. Предоставляется бесплатно.

Для работы достаточно иметь актуальные копии следующих файлов:

·  OBJ_TYPE. DBF – список типов объектов, описываемых ЕГК.

Содержание поля	Тип	Ключ	Имя поля
ИД объекта	N 6,0	PK	OBJ_ID
Имя объекта	C 78		OBJ_NAME
Краткое имя объекта	C 4		OBJ_RSN

·  FIRM. DBF – список фирм-производителей.

Содержание поля	Тип	Ключ	Имя поля
ИД фирмы	N 6,0	PK	FIRM_ID
Русское полное наименование	C 128		FIRM_RFN
Русское краткое наименование	C 16		FIRM_RSN

·  COUNTRY. DBF – список стран.