Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Все методы возвращают результат в виде объекта OperationResult

Описание ошибок интеграции

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

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

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

Предупреждение

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

Раскрыть
titleОписание метода
Раскрыть
titleОписание работы метода

Если тип договора, по которому сформирован счёт "Физическое лицо"
и если статус счёта "Создан"
или статус "Аннулирован" и счёт не получали в кассе (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
-/+

Тип плательщика

0 - пациент

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

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

...




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

Параметры:

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

...


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN

...


OID

varchar(50)

+

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

oms_LPU.Lic


Тело:

Поле 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


+

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

 


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

...

Тип плательщика

0 - пациент

...


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)

+

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

...

Рассчитывается как smCost/smCount

...


hlt_BillService.discountPrice

...

1.1  Метод

...

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

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

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


Раскрыть
titleОписание работы метода

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

 

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

Параметры:

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


LpuOGRNOGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


LpuOIDOID

varchar(50)

+

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

oms_LPU.Lic

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

+

-

Гуид счетаID Счета.


hlt_Invoice.GUID

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

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

Номер счета


hlt_Invoice.Id


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

Параметры:

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


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN

LpuOID


OID

varchar(50)

+

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

oms_LPU.Lic

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

invoiceGuid

uniqueidentifier

+

ID Счета.

hlt_Invoice.GUID


Тело:

Поле 1С

Тег ТМ:МИС

Тип

Обязат.

Описание

Поле БД МИС


cashdeskGuid

uniqueidentifier

-

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

hlt_Cashdesk.UGUID


BillFlag

bit

+

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

hlt_Invoice.BillFlag

PaymentType


GetFlag

int

bit

+

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

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

hlt_Invoice.

rf_PaymentTypeID

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

checkNum

GetFlag

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

invoiceGuid

uniqueidentifier

+

ID Счета

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

hlt_Invoice.GUID

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

invoiceNum

varchar(50

varchar(250

)

+

Номер

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

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

hlt_Invoice.

checkNum

Num

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

BillDate

date

datetime

+

Дата

чека

счета – дата

оплаты

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

hlt_Invoice

.BillDatepaySumdecimal(20, 5

.Date


PayerGuid

uniqueidentifier


+

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

 


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


birthdaydatetime+

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



family

varchar(40)

+

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

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

hlt_

Invoice.paySum

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

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

Параметры:

...

LpuOGRN

...

varchar(15)

...

+

...

ОГРН ЛПУ

...

oms_LPU.C_OGRN

...

LpuOID

...

varchar(50)

...

+

...

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

...

oms_LPU.Lic

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

1.2 

Тело:

...

Поле 1С

...

Тег ТМ:МИС

...

Тип

...

Обязат.

...

Описание

...

Поле БД МИС

...

CashdeskGuid

...

uniqueidentifier

...

+

...

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

...

hlt_Cashdesk.UGUID

...

CashdeskName

...

varchar(255)

...

+

...

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

...

hlt_Cashdesk.Name

...

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

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

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



Раскрыть
titleОписание работы метода

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

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

Параметры:

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


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN

LpuOID


OID

varchar(50)

+

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

oms_LPU.Lic


FIOvarchar(50)
-/+

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



Birthday
datetime
-/+

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

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




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

Параметры:

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


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN

LpuOID


OID

varchar(50)

+

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

oms_LPU.Lic


Тело:

Поле 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


mkabGUIDPayerGuid

uniqueidentifier


+

ГУИД МКАБплательщика

 hlt_MKAB.UGUID


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


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


услугисчетаТММИСМассив «Services»+

Type

int

+

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

hlt_Invoice.rf_InvoiceTypeID


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

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

paySumdecimal(2018, 52)+

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

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

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

Стоимость

smCostfloat

decimal(18, 2)

+

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

hlt_BillService.ValueTariff

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

smPrice

decimal(2018, 52)

+

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


hlt_BillService.discountPrice


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

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

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



Раскрыть
titleОписание работы метода

Если счёт в статусе "Создан", ему ставится статус "Передан в кассу"
Если счёт в статусе "Аннулирован", ему ставится признак получения в 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


Type

int

+

Тип документа (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
Рассчитывается как smCost/smCount