Page tree
Skip to end of metadata
Go to start of metadata

Зелёный - новая сущность в ТМ:МИС.

Синий - новые поля в модели

1.  Метод получения счетов из сервиса ТМ:МИС (deprecated)

метод остался, но нужно перейти на метод получения счетов по номеру

 Описание работы метода

Если тип договора, по которому сформирован счёт "Физическое лицо"
и если статус счёта "Создан"
или статус "Аннулирован" и счёт не получали в кассе (Flags = 0),
или статус "Создан", "Передан в кассу", "Аннулирован", "Частично оплачен", если поиск по ФИО и дате рождения плательщика,
или статус "Создан", "Передан в кассу", "Аннулирован", "Частично оплачен", "Считать оплаченым", если поиск по гуиду счёта

Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic

IdЗаказаТММИСinvoiceGuiduniqueidentifier-

Гуид счета


hlt_Invoice.GUID

FIOvarchar(50)
-/+

ФИО плательщика



Birthday
datetime
-/+

Дата рождения плательщика

Обязательно, если указано ФИО плательщика




Выходные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


Тело:

Модель передачи счетов из ТММИС в 1С

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


cashdeskGuid

uniqueidentifier

-

ГУИД кассы (если идентификатор кассы не передан, то счет доступен для всех касс медицинского учреждения)

hlt_Cashdesk.UGUID


BillFlag

bit

+

Признак оплаты счёта

hlt_Invoice.BillFlag


GetFlag

bit

+

Признак подтверждения получения счёта

hlt_Invoice.GetFlag

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета

По данному полю осуществляется поиск заказа. Документ создается только если в системе не найден такой ID.

hlt_Invoice.GUID

НомерЗаказаТММИС

invoiceNum

varchar(50)

+

Номер счета. Информационное поле выводится на форму

hlt_Invoice.Num

ДатаЗаказаТММИС

date

datetime

+

Дата счета – дата выставления счёта в ТМ:МИС

hlt_Invoice.Date


PayerGUID

uniqueidentifier


+

ГУИД плательщика



По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.


birthdaydatetime+

Дата рождения плательщика



family

varchar(40)

+

Фамилия плательщика

hlt_MKAB.FAMILY


name

varchar(40)

+

Имя плательщика

hlt_MKAB.NAME


ot

varchar(40)

-

Отчество плательщика

hlt_MKAB.OT

КонтактнаяИнформация.Телефон

contactMPhone

varchar(25)

-

Контактный телефон

hlt_MKAB.contactMPhone

КонтактнаяИнформация.Email

contactEmail

varchar(100)

-

Контактный e-mail

hlt_MKAB.contactEmail


Type

int

+

Тип документа (1– Счёт-заказ, 3 – Счёт-возврат)

hlt_Invoice.rf_InvoiceTypeID


ParentInvoiceGuiduniqueidentifier-Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно.hlt_Invoice.GUID

isCancelledbit
Признак аннулирования счетаhlt_Invoice.FLAG

paySumdecimal(18, 2)+

Сумма, подлежащая оплате

(Рассчитывается как сумма счета - сумма оплаты)

hlt_Invoice.paySum

invoiceSumdecimal(18, 2)+Сумма счётаhlt_Invoice.InvoiceSum

Массив «Services»

idУслугиТММИС

smguid

uniqueidentifier

+

Идентификатор услуги

По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются.

oms_ServiceMedical.GUIDSM

кодУслугиТММИС

smCode

varchar(50)

+

Код услуги

oms_ServiceMedical.ServiceMedicalCode

Наименование

smName

varchar(500)

+

Наименование услуги

oms_ServiceMedical.ServiceMedicalName

Ставка НДС

Tax

int

+

Ставка НДС (-1 – Без НДС, 0 – 0%, 10 - 10%, 18 – 18%, 20 – 20%)

oms_Tariff.rf_NDSRateID

oms_NDSRate.Rate_Num

Количество

smCount

decimal(9, 2)

+

Количество услуг

hlt_BillService.Count

Стоимость

smCost

decimal(18, 2)

+

Итоговая сумма по позиции счета с учетом скидки (цена с учетом скидки * количество)

hlt_BillService.ValueTariff

Цена со скидкой

smPrice

decimal(18, 2)

+

Цена за единицу услуги с учётом скидки.


hlt_BillService.discountPrice


Признак оказания услугиisCompletedbit+

Если услуга оказана -1

Если услуга не оказана - 0

Если hlt_smtap ссылается на rf_BillServiceID, то услуга считается оказанной

Если в hlt_smtap нет связанных rf_BillServiceID, то услуга считается не оказанной



Пример модели в формате JSON
 

1.1  Метод получения счетов из сервиса ТМ:МИС по номеру счета или гуиду счета

Адрес запроса

GET: {{url}}/api/paidServices/IntegrationInvoice/ByNumber



 Описание работы метода

Если тип договора, по которому сформирован счёт "Физическое лицо"
и если статус счёта "Создан"или статус "Передан в кассу", "Частично оплачен"

Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic

IdЗаказаТММИСinvoiceGuiduniqueidentifier-

Гуид счета


hlt_Invoice.GUID
IdЗаказаТММИСnumbervarchar()
-

Номер счета


hlt_Invoice.Id


Выходные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


Тело:

Модель передачи счетов из ТММИС в 1С

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


cashdeskGuid

uniqueidentifier

-

ГУИД кассы (если идентификатор кассы не передан, то счет доступен для всех касс медицинского учреждения)

hlt_Cashdesk.UGUID


BillFlag

bit

+

Признак оплаты счёта

hlt_Invoice.BillFlag


GetFlag

bit

+

Признак подтверждения получения счёта

hlt_Invoice.GetFlag

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета

По данному полю осуществляется поиск заказа. Документ создается только если в системе не найден такой ID.

hlt_Invoice.GUID

НомерЗаказаТММИС

invoiceNum

varchar(50)

+

Номер счета. Информационное поле выводится на форму

hlt_Invoice.Num

ДатаЗаказаТММИС

date

datetime

+

Дата счета – дата выставления счёта в ТМ:МИС

hlt_Invoice.Date


PayerGUID

uniqueidentifier


+

ГУИД плательщика



По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.


birthdaydatetime+

Дата рождения плательщика



family

varchar(40)

+

Фамилия плательщика

hlt_MKAB.FAMILY


name

varchar(40)

+

Имя плательщика

hlt_MKAB.NAME


ot

varchar(40)

-

Отчество плательщика

hlt_MKAB.OT

КонтактнаяИнформация.Телефон

contactMPhone

varchar(25)

-

Контактный телефон

hlt_MKAB.contactMPhone

КонтактнаяИнформация.Email

contactEmail

varchar(100)

-

Контактный e-mail

hlt_MKAB.contactEmail


Type

int

+

Тип документа (1– Счёт-заказ, 3 – Счёт-возврат)

hlt_Invoice.rf_InvoiceTypeID


ParentInvoiceGuiduniqueidentifier-Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно.hlt_Invoice.GUID

isCancelledbit
Признак аннулирования счетаhlt_Invoice.FLAG

paySumdecimal(18, 2)+

Сумма, подлежащая оплате

(Рассчитывается как сумма счета - сумма оплаты)

hlt_Invoice.paySum

invoiceSumdecimal(18, 2)+Сумма счётаhlt_Invoice.InvoiceSum

Массив «Services»

idУслугиТММИС

smguid

uniqueidentifier

+

Идентификатор услуги

По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются.

oms_ServiceMedical.GUIDSM

кодУслугиТММИС

smCode

varchar(50)

+

Код услуги

oms_ServiceMedical.ServiceMedicalCode

Наименование

smName

varchar(500)

+

Наименование услуги

oms_ServiceMedical.ServiceMedicalName

Ставка НДС

Tax

int

+

Ставка НДС (-1 – Без НДС, 0 – 0%, 10 - 10%, 18 – 18%, 20 – 20%)

oms_Tariff.rf_NDSRateID

oms_NDSRate.Rate_Num

Количество

smCount

decimal(9, 2)

+

Количество услуг

hlt_BillService.Count

Стоимость

smCost

decimal(18, 2)

+

Итоговая сумма по позиции счета с учетом скидки (цена с учетом скидки * количество)

hlt_BillService.ValueTariff

Цена со скидкой

smPrice

decimal(18, 2)

+

Цена за единицу услуги с учётом скидки.


hlt_BillService.discountPrice


Признак оказания услугиisCompletedbit+

Если услуга оказана -1

Если услуга не оказана - 0

Если hlt_smtap ссылается на rf_BillServiceID, то услуга считается оказанной

Если в hlt_smtap нет связанных rf_BillServiceID, то услуга считается не оказанной



Пример модели в формате JSON
 

1.2  Метод получения счетов из сервиса ТМ:МИС по ФИО и ДР плательщика

Адрес запроса

GET: {{url}}/api/paidServices/IntegrationInvoice/ByPayer



 Описание работы метода

Если тип договора, по которому сформирован счёт "Физическое лицо"
и если статус счёта "Создан"или статус "Передан в кассу", "Частично оплачен"

Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


FIOvarchar(50)
-/+

ФИО плательщика



Birthday
datetime
-/+

Дата рождения плательщика

Обязательно, если указано ФИО плательщика




Выходные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


Тело:

Модель передачи счетов из ТММИС в 1С

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


cashdeskGuid

uniqueidentifier

-

ГУИД кассы (если идентификатор кассы не передан, то счет доступен для всех касс медицинского учреждения)

hlt_Cashdesk.UGUID


BillFlag

bit

+

Признак оплаты счёта

hlt_Invoice.BillFlag


GetFlag

bit

+

Признак подтверждения получения счёта

hlt_Invoice.GetFlag

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета

По данному полю осуществляется поиск заказа. Документ создается только если в системе не найден такой ID.

hlt_Invoice.GUID

НомерЗаказаТММИС

invoiceNum

varchar(50)

+

Номер счета. Информационное поле выводится на форму

hlt_Invoice.Num

ДатаЗаказаТММИС

date

datetime

+

Дата счета – дата выставления счёта в ТМ:МИС

hlt_Invoice.Date


PayerGUID

uniqueidentifier


+

ГУИД плательщика



По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.


birthdaydatetime+

Дата рождения плательщика



family

varchar(40)

+

Фамилия плательщика

hlt_MKAB.FAMILY


name

varchar(40)

+

Имя плательщика

hlt_MKAB.NAME


ot

varchar(40)

-

Отчество плательщика

hlt_MKAB.OT

КонтактнаяИнформация.Телефон

contactMPhone

varchar(25)

-

Контактный телефон

hlt_MKAB.contactMPhone

КонтактнаяИнформация.Email

contactEmail

varchar(100)

-

Контактный e-mail

hlt_MKAB.contactEmail


Type

int

+

Тип документа (1– Счёт-заказ, 3 – Счёт-возврат)

hlt_Invoice.rf_InvoiceTypeID


ParentInvoiceGuiduniqueidentifier-Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно.hlt_Invoice.GUID

isCancelledbit
Признак аннулирования счетаhlt_Invoice.FLAG

paySumdecimal(18, 2)+

Сумма, подлежащая оплате

(Рассчитывается как сумма счета - сумма оплаты)

hlt_Invoice.paySum

invoiceSumdecimal(18, 2)+Сумма счётаhlt_Invoice.InvoiceSum

Массив «Services»

idУслугиТММИС

smguid

uniqueidentifier

+

Идентификатор услуги

По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются.

oms_ServiceMedical.GUIDSM

кодУслугиТММИС

smCode

varchar(50)

+

Код услуги

oms_ServiceMedical.ServiceMedicalCode

Наименование

smName

varchar(500)

+

Наименование услуги

oms_ServiceMedical.ServiceMedicalName

Ставка НДС

Tax

int

+

Ставка НДС (-1 – Без НДС, 0 – 0%, 10 - 10%, 18 – 18%, 20 – 20%)

oms_Tariff.rf_NDSRateID

oms_NDSRate.Rate_Num

Количество

smCount

decimal(9, 2)

+

Количество услуг

hlt_BillService.Count

Стоимость

smCost

decimal(18, 2)

+

Итоговая сумма по позиции счета с учетом скидки (цена с учетом скидки * количество)

hlt_BillService.ValueTariff

Цена со скидкой

smPrice

decimal(18, 2)

+

Цена за единицу услуги с учётом скидки.


hlt_BillService.discountPrice


Признак оказания услугиisCompletedbit+

Если услуга оказана -1

Если услуга не оказана - 0

Если hlt_smtap ссылается на rf_BillServiceID, то услуга считается оказанной

Если в hlt_smtap нет связанных rf_BillServiceID, то услуга считается не оказанной



Пример модели в формате JSON
 


1.3  Метод получения счетов из сервиса ТМ:МИС со статусом "требует отправки в ОФД"

Адрес запроса

GET: {{url}}/api/paidServices/IntegrationInvoice/ofd
 Описание работы метода

Для получения оплаченных счетов с оказанными услугами, требующих отправки в ОФД

Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic

IdЗаказаТММИСinvoiceGuiduniqueidentifier-

Гуид счета


hlt_Invoice.GUID
IdЗаказаТММИСnumbervarchar()
-

Номер счета


hlt_Invoice.Id


Выходные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


Тело:

Модель передачи счетов из ТММИС в 1С

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


cashdeskGuid

uniqueidentifier

-

ГУИД кассы (если идентификатор кассы не передан, то счет доступен для всех касс медицинского учреждения)

hlt_Cashdesk.UGUID


BillFlag

bit

+

Признак оплаты счёта

hlt_Invoice.BillFlag


GetFlag

bit

+

Признак подтверждения получения счёта

hlt_Invoice.GetFlag

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета

По данному полю осуществляется поиск заказа. Документ создается только если в системе не найден такой ID.

hlt_Invoice.GUID

НомерЗаказаТММИС

invoiceNum

varchar(50)

+

Номер счета. Информационное поле выводится на форму

hlt_Invoice.Num

ДатаЗаказаТММИС

date

datetime

+

Дата счета – дата выставления счёта в ТМ:МИС

hlt_Invoice.Date


PayerGUID

uniqueidentifier


+

ГУИД плательщика



По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.


birthdaydatetime+

Дата рождения плательщика



family

varchar(40)

+

Фамилия плательщика

hlt_MKAB.FAMILY


name

varchar(40)

+

Имя плательщика

hlt_MKAB.NAME


ot

varchar(40)

-

Отчество плательщика

hlt_MKAB.OT

КонтактнаяИнформация.Телефон

contactMPhone

varchar(25)

-

Контактный телефон

hlt_MKAB.contactMPhone

КонтактнаяИнформация.Email

contactEmail

varchar(100)

-

Контактный e-mail

hlt_MKAB.contactEmail


Type

int

+

Тип документа (1– Счёт-заказ, 3 – Счёт-возврат)

hlt_Invoice.rf_InvoiceTypeID


ParentInvoiceGuiduniqueidentifier-Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно.hlt_Invoice.GUID

isCancelledbit
Признак аннулирования счетаhlt_Invoice.FLAG

paySumdecimal(18, 2)+

Сумма, подлежащая оплате

(Рассчитывается как сумма счета - сумма оплаты)

hlt_Invoice.paySum

invoiceSumdecimal(18, 2)+Сумма счётаhlt_Invoice.InvoiceSum

Массив «Services»

idУслугиТММИС

smguid

uniqueidentifier

+

Идентификатор услуги

По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются.

oms_ServiceMedical.GUIDSM

кодУслугиТММИС

smCode

varchar(50)

+

Код услуги

oms_ServiceMedical.ServiceMedicalCode

Наименование

smName

varchar(500)

+

Наименование услуги

oms_ServiceMedical.ServiceMedicalName

Ставка НДС

Tax

int

+

Ставка НДС (-1 – Без НДС, 0 – 0%, 10 - 10%, 18 – 18%, 20 – 20%)

oms_Tariff.rf_NDSRateID

oms_NDSRate.Rate_Num

Количество

smCount

decimal(9, 2)

+

Количество услуг

hlt_BillService.Count

Стоимость

smCost

decimal(18, 2)

+

Итоговая сумма по позиции счета с учетом скидки (цена с учетом скидки * количество)

hlt_BillService.ValueTariff

Цена со скидкой

smPrice

decimal(18, 2)

+

Цена за единицу услуги с учётом скидки.


hlt_BillService.discountPrice


Признак оказания услугиisCompletedbit+

Если услуга оказана -1

Если услуга не оказана - 0

Если hlt_smtap ссылается на rf_BillServiceID, то услуга считается оказанной

Если в hlt_smtap нет связанных rf_BillServiceID, то услуга считается не оказанной



Пример модели в формате JSON
 


2. Метод передачи подтверждения получения счёта в ТМ:МИС

Адрес запроса

POST: {{url}}/api/paidServices/IntegrationInvoice/Receive



 Описание работы метода

Если счёт в статусе "Создан", ему ставится статус "Передан в кассу"
Если счёт в статусе "Аннулирован", ему ставится признак получения в 1С (Flags = 1)


Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета.

hlt_Invoice.GUID


3. Метод передачи признака оплаты счёта в ТМ:МИС

Адрес запроса

POST: {{url}}//api/paidServices/IntegrationInvoice/Pay



Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic

IdЗаказаТММИС

invoiceGuid

uniqueidentifier

+

ID Счета.

hlt_Invoice.GUID

Тело:

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС

НомерЧекаККМ

checkNum

varchar(250)

+

Номер чека в кассовой смене

hlt_Invoice.checkNum


BillDate

datetime

+

Дата чека – дата оплаты

hlt_Invoice.BillDate


cashdeskGuid
uniqueidentifier+Гуид кассыhlt_Cashdesk.UGUID

Typeint+Тип документа (1– Счёт-заказ, 3 – Счёт-возврат)hlt_Invoice.rf_InvoiceTypeID
Массив «Payments»

paySumdecimal(18, 2)+

Сумма платежа

hlt_Invoice.paySum

PaymentTypeint+Форма оплаты (1- Наличный расчет, 3 - Банковская карта)hlt_Invoice.rf_PaymentTypeID

4. Метод передачи справочника касс в ТМ:МИС

Адрес запроса

POST: {{url}}/api/paidServices/IntegrationInvoice/CashDesk


Входные данные.

Параметры:

Поле 1СТег ТМ:МИСТипОбязат.ОписаниеПоле БД МИС


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

OID структурного подразделения

oms_LPU.Lic


Тело:

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


Guid

uniqueidentifier

+

ГУИД кассы в 1С

hlt_Cashdesk.UGUID


Name

varchar(255)

+

Наименование кассы

hlt_Cashdesk.Name


Codevarchar(255)-Код кассыhlt_Cashdesk.Code

DateBegindatetime-Дата начала действияhlt_Cashdesk.DateBegin

DateEnddatetime-Дата окончания действияhlt_Cashdesk.DateEnd
  • No labels