| Примечание |
|---|
Описание ошибок интеграции |
| Информация |
|---|
Зелёный - новая сущность в ТМ:МИС. Синий |
...
- новые поля в модели |
1.
...
Метод получения счетов из сервиса ТМ:МИС по номеру счета или гуиду счета
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| GET: {{url}}/api/paidServices/IntegrationInvoice/v2/ByNumber |
| Раскрыть | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Если тип договора, по которому сформирован счёт "Физическое лицо" и если статус счёта "Создан", "Создан и оказан", "Передан в кассу", "Частично оплачен"
|
...
|
...
|
...
|
...
|
...
...
ФИО плательщика
...
|
Дата рождения плательщика
...
|
...
|
...
|
...
Поле 1С
|
2. Метод получения счетов из сервиса
...
ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
cashdeskGuid
...
uniqueidentifier
...
-
...
ГУИД кассы (если идентификатор кассы не передан, то счет доступен для всех касс медицинского учреждения)
...
hlt_Cashdesk.UGUID
по ФИО и ДР плательщика
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| GET: {{url}}/api/paidServices/IntegrationInvoice/v2/ByPayer |
...
BillFlag
...
bit
...
+
...
Признак оплаты счёта
...
hlt_Invoice.BillFlag
...
GetFlag
...
bit
...
+
...
Признак подтверждения получения счёта
...
hlt_Invoice.GetFlag
...
IdЗаказаТММИС
...
invoiceGuid
...
uniqueidentifier
...
+
...
ID Счета
По данному полю осуществляется поиск заказа. Документ создается только если в системе не найден такой ID.
...
hlt_Invoice.GUID
...
НомерЗаказаТММИС
...
invoiceNum
| Раскрыть | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
Если тип договора, по которому сформирован счёт "Физическое лицо" и если статус счёта "Создан", "Создан и оказан", "Передан в кассу", "Частично оплачен"
|
|
...
Номер счета. Информационное поле выводится на форму
...
hlt_Invoice.Num
...
ДатаЗаказаТММИС
...
date
...
datetime
...
+
...
Дата счета – дата выставления счёта в ТМ:МИС
...
hlt_Invoice.Date
...
PayerGUID
uniqueidentifier
...
+
ГУИД плательщика
...
По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.
|
3. Метод получения счетов из сервиса ТМ:МИС со статусом "Требует отправки в ОФД"
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| GET: {{url}}/api/paidServices/IntegrationInvoice/v2/Ofd |
| Раскрыть | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Для получения оплаченных счетов с оказанными услугами, требующих отправки в ОФД
|
4. Метод передачи подтверждения получения счёта в ТМ:МИС
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/v2/Receive |
...
Дата рождения плательщика
...
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
...
Сумма, подлежащая оплате
(Рассчитывается как сумма счета - сумма оплаты)
...
Массив «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
...
2. Метод передачи подтверждения получения счёта в ТМ:МИС
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
Если счёт в статусе "Создан" или "Создан и оказан", ему ставится статус "Передан в кассу"
|
|
...
|
...
|
...
5. Метод передачи признака оплаты счёта в ТМ:МИС
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Pay |
| Раскрыть | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
|
...
|
...
|
...
| |||||||||||||||||||||||||||||||
...
6. Метод
...
обновления статуса счёта в ТМ:МИС
| Якорь |
|---|
Входные данные.
Параметры:
...
LpuOGRN
...
varchar(15)
...
+
...
ОГРН ЛПУ
...
oms_LPU.C_OGRN
...
LpuOID
...
varchar(50)
...
+
...
OID структурного подразделения
...
oms_LPU.Lic
Тело:
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
|
Адрес запроса
| POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Status |
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
После обработки счета в статусе "9-Требуется отправка в ОФД" в 1С, статус счета должен быть обновлен на "10-Оплачен и оказан" и передан в ТМ:МИС.
|
...
Guid
...
uniqueidentifier
...
+
...
ГУИД кассы в 1С
...
hlt_Cashdesk.UGUID
...
Name
...
varchar(255)
...
+
...
Наименование кассы
...
hlt_Cashdesk.Name
...
|
...
|
...
|
...
|
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
|
...
Num
...
varchar(50)
...
|
...
|
...
|
...
|
...
|
...
Дата начала действия
...
hlt_DogovorPaying.Date_B
...
DateE
...
datetime
...
Дата окончания действия
...
hlt_DogovorPaying.Date_E
...
Dogovor
...
uniqueidentifier
...
Идентификатор прейскуранта
...
hlt_DogovorPaying.rf_DOGOVORID
...
Payer
...
int
...
Плательщик
...
hlt_DogovorPaying.rf_PayerID
...
ProfitType
...
int
...
Вид оплаты (1-ОМС, 2-Бюджет, 3-Платные услуги, 4-ДМС, 5-Другие)
...
hlt_DogovorPaying.rf_kl_ProfitTypeID
...
|
7. Метод передачи справочника касс в ТМ:МИС
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/v2/CashDesk |
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
|
...
|
...
|
...
|
...
|
...
int
...
Тип плательщика. В зависимости от типа плательщика определяется набор обязательных полей. (1-Физическое лицо, 2-Представитель плательщика, 3-Юридическое лицо, 4-ДМС)
...
hlt_Payer.rf_PayerTypeID
|
...
PayerGUID
...
family
...
varchar(40)
...
Фамилия плательщика
...
hlt_MKAB.FAMILY
...
name
...
varchar(40)
...
Имя плательщика
...
hlt_MKAB.NAME
...
ot
...
varchar(40)
...
Отчество плательщика
...
hlt_MKAB.OT
...
contactMPhone
...
varchar(25)
...
Контактный телефон
...
hlt_MKAB.contactMPhone
...
|
...
SMOGUID
...
uniqueidentifier
...
Идентификатор СМО
...
OrganisationGUID
...
uniqueidentifier
...
Идентификатор Организации
...
OrganisationFullName
...
OrganisationINN
...
OrganisationOGRN
...
OrganisationOKATO
...
7. Метод передачи прейскурантов
Входные данные.
Параметры:
...
LpuOGRN
...
varchar(15)
...
+
...
ОГРН ЛПУ
...
oms_LPU.C_OGRN
...
LpuOID
...
varchar(50)
...
+
...
OID структурного подразделения
...
oms_LPU.Lic
Тело:
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
GUID
...
Num
...
varchar(20)
...
Номер
...
oms_DOGOVOR.Num
...
Name
...
varchar(100)
...
Наименование
...
oms_DOGOVOR.Name
...
DateB
...
datetime
...
Дата начала действия
...
oms_DOGOVOR.DATE_B
...
DateE
...
datetime
...
Дата окончания действия
...
oms_DOGOVOR.DATE_E
...
ProfitType
...
int
...
Классификатор типов пациентов (1-ОМС, 2-Бюджет, 3-Платные услуги, 4-ДМС, 5-Другие)
...
oms_DOGOVOR.rf_kl_ProfitTypeID
|
8. Метод получения версии интеграции в ТМ:МИС
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
GET: {{url}}/api/paidServices/IntegrationInvoice/Version |
GET: {{url}}/api/paidServices/IntegrationInvoice/v2/Version |
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
При включении новой версии интеграции метод вернёт "2", иначе "1"
|
...
oms_Tariff.rf_NDSRateID
oms_NDSRate.Rate_Num
...
|
...
|
...
|
...
|
...
Тело:
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
Code
...
9. Метод расчета скидок по счету
Входные данные.
Параметры:
...
НомерЗаказаТММИС
...
invoiceNum
...
varchar(50)
...
+
...
Номер счета. Информационное поле выводится на форму
...
hlt_Invoice.Num
...
PayerGUID
uniqueidentifier
...
+
ГУИД плательщика
...
По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.
...
Массив «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
Выходные данные.
Параметры:
...
Массив «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
...
Справочники
Справочник типов документов
...