Примечание |
---|
Описание ошибок интеграции |
Информация |
---|
Зелёный - новая сущность в ТМ:МИС. Синий |
...
- новые поля в модели |
1.
...
Метод получения счетов из сервиса ТМ:МИС по номеру счета или гуиду счета
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
GET: {{url}}/api/paidServices/IntegrationInvoice/v2/ByNumber |
Раскрыть | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Если тип договора, по которому сформирован счёт "Физическое лицо" и если статус счёта "Создан", "Создан и оказан", "Передан в кассу", "Частично оплачен"
|
...
|
...
|
...
|
...
|
...
...
ФИО плательщика
...
|
Дата рождения плательщика
...
|
...
|
...
|
...
Поле 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
...
+
ГУИД плательщика
...
По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.
|
2. Метод получения счетов из сервиса ТМ:МИС по ФИО и ДР плательщика
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
GET: {{url}}/api/paidServices/IntegrationInvoice/v2/ByPayer |
Раскрыть | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||
Если тип договора, по которому сформирован счёт "Физическое лицо" и если статус счёта "Создан", "Создан и оказан", "Передан в кассу", "Частично оплачен"
|
...
Дата рождения плательщика
...
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. Метод передачи подтверждения получения счёта в ТМ:МИС
...
|
...
|
...
|
...
IdЗаказаТММИС
...
invoiceGuid
...
uniqueidentifier
...
+
...
ID Счета.
...
hlt_Invoice.GUID
...
|
3. Метод получения счетов из сервиса ТМ:МИС со статусом "Требует отправки в ОФД"
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
GET: {{url}}/api/paidServices/IntegrationInvoice/v2/Ofd |
Раскрыть | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Для получения оплаченных счетов с оказанными услугами, требующих отправки в ОФД
|
...
|
...
|
...
+
|
...
|
...
|
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
BillFlag
...
bit
...
+
...
Признак оплаты счёта
...
hlt_Invoice.BillFlag
...
Форма оплаты (1- Наличный расчет, 3 - Банковская карта)
...
hlt_Invoice.rf_PaymentTypeID
|
...
НомерЧекаККМ
...
checkNum
...
varchar(250)
...
+
...
|
...
|
...
|
...
|
...
+
...
Дата чека – дата оплаты
...
hlt_Invoice.BillDate
|
...
Сумма платежа
...
4. Метод передачи справочника касс в ТМ:МИС
...
|
...
|
...
|
...
Поле 1С
|
4. Метод передачи подтверждения получения счёта в
...
ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
CashdeskGuid
...
uniqueidentifier
...
+
...
ГУИД кассы в 1С
...
hlt_Cashdesk.UGUID
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
POST: {{url}}/api/paidServices/IntegrationInvoice/v2/Receive |
...
CashdeskName
...
varchar(255)
...
+
...
Наименование кассы
...
hlt_Cashdesk.Name
...
5. Метод передачи договоров
Раскрыть | ||||
---|---|---|---|---|
| ||||
Если счёт в статусе "Создан" или "Создан и оказан", ему ставится статус "Передан в кассу"
|
|
...
|
...
|
...
|
...
Поле 1С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
...
Num
...
varchar(50)
...
Номер
...
hlt_DogovorPaying.Num
...
DateB
...
datetime
...
Дата начала действия
...
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
...
|
5. Метод передачи признака оплаты счёта в ТМ:МИС
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Pay |
6. Метод передачи плательщиков
Раскрыть | ||||
---|---|---|---|---|
| ||||
|
|
...
|
...
|
...
|
...
int
...
Тип плательщика. В зависимости от типа плательщика определяется набор обязательных полей. (1-Физическое лицо, 2-Представитель плательщика, 3-Юридическое лицо, 4-ДМС)
...
hlt_Payer.rf_PayerTypeID
|
6. Метод обновления статуса счёта в ТМ:МИС
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Status |
...
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. Метод передачи прейскурантов
Раскрыть | ||||
---|---|---|---|---|
| ||||
После обработки счета в статусе "9-Требуется отправка в ОФД" в 1С, статус счета должен быть обновлен на "10-Оплачен и оказан" и передан в ТМ:МИС.
|
|
...
|
...
|
Тело:
...
Поле 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
|
7. Метод передачи справочника касс в ТМ:МИС
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
POST: {{url}}/api/paidServices/IntegrationInvoice/v2/CashDesk |
...
oms_Tariff.rf_NDSRateID
oms_NDSRate.Rate_Num
8. Метод получения справочника скидок
Раскрыть | ||||
---|---|---|---|---|
| ||||
|
|
...
|
...
|
...
Code
...
|
...
|
...
|
...
|
...
|
...
|
...
9. Метод расчета скидок по счету
Входные данные.
Параметры:
...
НомерЗаказаТММИС
...
invoiceNum
...
varchar(50)
...
+
...
Номер счета. Информационное поле выводится на форму
...
hlt_Invoice.Num
...
PayerGUID
uniqueidentifier
...
+
ГУИД плательщика
...
По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется.
|
8. Метод получения версии интеграции в ТМ:МИС
Якорь | ||||
---|---|---|---|---|
|
Адрес запроса
GET: {{url}}/api/paidServices/IntegrationInvoice/Version |
GET: {{url}}/api/paidServices/IntegrationInvoice/v2/Version |
...
Массив «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", иначе "1"
|
...
|
...
Массив «Services»
...
idУслугиТММИС
...
smguid
...
uniqueidentifier
...
+
...
Идентификатор услуги
По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются.
...
oms_ServiceMedical.GUIDSM
...
кодУслугиТММИС
|
...
|
...
|
...
|
...
|
...
|
...
smName
|
...
|
...
|
...
Ставка НДС
...
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
...
Справочники
Справочник типов документов
...
|