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

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

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

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

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

GET: {{url}}/api/paidServices/IntegrationInvoice/v2/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

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

statusint+

Статус счёта

1 - Создан

2 - Передан в кассу

3 - Оплачен

4 - Выполнен

5 - Аннулирован

6 - Частично оплачен

7 - Считать оплаченным

8 - Создан и оказан

9 - Требуется отправка в ОФД

10 - Оплачен и оказан

hlt_Invoice.rf_InvoiceStatusID → hlt_InvoiceStatus.Code

Массив «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 
{
    "cashdeskGuid": "00000000-0000-0000-0000-000000000000",
    "invoiceGuid": "3e72703e-6e67-491c-b5cd-d9c9281dfa2f",
    "invoiceNum": "4328",
    "date": "2024-02-07T15:08:40.887",
    "payerGuid": "2e0f6863-254d-4b3b-907b-7ccef2061133",
    "family": "Васильченко",
    "name": "Анастасия",
    "ot": "Михайловна",
    "birthday": "1976-06-13T00:00:00",
    "contactMPhone": "",
    "contactEmail": "",
    "type": 1,
    "parentInvoiceGuid": "00000000-0000-0000-0000-000000000000",
    "isCancelled": false,
    "invoiceSum": 450.00,
    "paySum": 450.00,
    "services": [
        {
            "smGuid": "c3d19991-0146-4ad6-b03d-3bd4eb6be5e1",
            "smCode": "A01.30.011",
            "smName": "Пальпация терапевтическая",
            "smCount": 1.00,
            "smPrice": 450.00,
            "smCost": 450.00,
            "tax": 1.0
        }
    ]
}

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

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

GET: {{url}}/api/paidServices/IntegrationInvoice/v2/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

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

statusint+

Статус счёта

1 - Создан

2 - Передан в кассу

3 - Оплачен

4 - Выполнен

5 - Аннулирован

6 - Частично оплачен

7 - Считать оплаченным

8 - Создан и оказан

9 - Требуется отправка в ОФД

10 - Оплачен и оказан

hlt_Invoice.rf_InvoiceStatusID → hlt_InvoiceStatus.Code

Массив «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 
{
    "cashdeskGuid": "00000000-0000-0000-0000-000000000000",
    "invoiceGuid": "3e72703e-6e67-491c-b5cd-d9c9281dfa2f",
    "invoiceNum": "4328",
    "date": "2024-02-07T15:08:40.887",
    "payerGuid": "2e0f6863-254d-4b3b-907b-7ccef2061133",
    "family": "Васильченко",
    "name": "Анастасия",
    "ot": "Михайловна",
    "birthday": "1976-06-13T00:00:00",
    "contactMPhone": "",
    "contactEmail": "",
    "type": 1,
    "parentInvoiceGuid": "00000000-0000-0000-0000-000000000000",
    "isCancelled": false,
    "invoiceSum": 450.00,
    "paySum": 450.00,
    "services": [
        {
            "smGuid": "c3d19991-0146-4ad6-b03d-3bd4eb6be5e1",
            "smCode": "A01.30.011",
            "smName": "Пальпация терапевтическая",
            "smCount": 1.00,
            "smPrice": 450.00,
            "smCost": 450.00,
            "tax": 1.0
        }
    ]
}

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

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

GET: {{url}}/api/paidServices/IntegrationInvoice/v2/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

PayerGUID

uniqueidentifier


-

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



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

Параметры:

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

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

statusint+

Статус счёта

1 - Создан

2 - Передан в кассу

3 - Оплачен

4 - Выполнен

5 - Аннулирован

6 - Частично оплачен

7 - Считать оплаченным

8 - Создан и оказан

9 - Требуется отправка в ОФД

10 - Оплачен и оказан

hlt_Invoice.rf_InvoiceStatusID → hlt_InvoiceStatus.Code

Массив «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 
{
    "cashdeskGuid": "00000000-0000-0000-0000-000000000000",
    "invoiceGuid": "3e72703e-6e67-491c-b5cd-d9c9281dfa2f",
    "invoiceNum": "4328",
    "date": "2024-02-07T15:08:40.887",
    "payerGuid": "2e0f6863-254d-4b3b-907b-7ccef2061133",
    "family": "Васильченко",
    "name": "Анастасия",
    "ot": "Михайловна",
    "birthday": "1976-06-13T00:00:00",
    "contactMPhone": "",
    "contactEmail": "",
    "type": 1,
    "parentInvoiceGuid": "00000000-0000-0000-0000-000000000000",
    "isCancelled": false,
    "invoiceSum": 450.00,
    "paySum": 450.00,
    "services": [
        {
            "smGuid": "c3d19991-0146-4ad6-b03d-3bd4eb6be5e1",
            "smCode": "A01.30.011",
            "smName": "Пальпация терапевтическая",
            "smCount": 1.00,
            "smPrice": 450.00,
            "smCost": 450.00,
            "tax": 1.0
        }
    ]
}

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

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

POST: {{url}}/api/paidServices/IntegrationInvoice/v2/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

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

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

POST: {{url}}//api/paidServices/IntegrationInvoice/v2/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

6. Метод обновления статуса счёта в ТМ:МИС

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

POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Status

После обработки счета в статусе "9-Требуется отправка в ОФД" в 1С, статус счета должен быть обновлен на "10-Оплачен и оказан" и передан в ТМ:МИС.

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

Параметры:

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


OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN


OID

varchar(50)

+

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

oms_LPU.Lic

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

invoiceGuid

uniqueidentifier

+

ID Счета.

hlt_Invoice.GUID


statusint+

Статус счета

10 - Оплачен и оказан

 

hlt_Invoice.rf_InvoiceStatusID

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

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

POST: {{url}}/api/paidServices/IntegrationInvoice/v2/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

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

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

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

GET: {{url}}/api/paidServices/IntegrationInvoice/v2/Version

При включении новой версии интеграции метод вернёт "2", иначе "1"

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

Параметры:

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

OGRN

varchar(15)

+

ОГРН ЛПУ

oms_LPU.C_OGRN

OID

varchar(50)

+

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

oms_LPU.Lic


  • Нет меток