| Примечание |
|---|
Описание ошибок интеграции |
| Информация |
|---|
Зелёный - новая сущность в ТМ:МИС. Синий |
...
- новые поля в модели |
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
...
кодУслугиТММИС
...
|
...
|
...
|
...
|
...
|
...
smName
|
...
|
...
Наименование услуги
...
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 |
3. Метод передачи признака оплаты счёта в ТМ:МИС
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
Для получения оплаченных счетов с оказанными услугами, требующих отправки в ОФД
|
|
...
|
...
|
...
+
|
...
|
Тело:
...
Поле 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С
...
Тег ТМ:МИС
...
Тип
...
Обязат.
...
Описание
...
Поле БД МИС
|
5. Метод передачи признака оплаты счёта в ТМ:МИС
| Якорь | ||||
|---|---|---|---|---|
|
Адрес запроса
| POST: {{url}}//api/paidServices/IntegrationInvoice/v2/Pay |
...
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
...
Вид оплаты (перечислить значения с кодом)
...
hlt_DogovorPaying.rf_kl_ProfitTypeID
...
6. Метод передачи плательщиков
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
|
|
...
|
...
|
...
PayerType
...
int
...
Тип плательщика. В зависимости от типа плательщика определяется набор обязательных полей. (перечислить типы плательщиков)
...
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
...
Классификатор типов пациентов (перечислить)
...
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
|
...
кодУслугиТММИС
...
smCode
...
|
...
|
...
|
...
Наименование
|
...
|
...
|
...
|
...
Ставка НДС
...
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
...
|