...
1.1 Метод получения счетов из сервиса ТМ:МИС по номеру счета или гуиду счета
Адрес запроса
| GET: {{url}}/api/paidServices/IntegrationInvoice/ByNumber |
| Раскрыть | ||
|---|---|---|
| ||
Если тип договора, по которому сформирован счёт "Физическое лицо" |
Входные данные.
Параметры:
| Поле 1С | Тег ТМ:МИС | Тип | Обязат. | Описание | Поле БД МИС |
OGRN | varchar(15) | + | ОГРН ЛПУ | oms_LPU.C_OGRN | |
OID | varchar(50) | + | OID структурного подразделения | oms_LPU.Lic | |
| IdЗаказаТММИС | invoiceGuid | uniqueidentifier | - | Гуид счета | hlt_Invoice.GUID |
| IdЗаказаТММИС | number | varchar() | - | Номер счета | hlt_Invoice.Id |
Выходные данные.
Параметры:
| Поле 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 | + | ГУИД плательщика | По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется. | |
| birthday | datetime | + | Дата рождения плательщика | ||
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 | |
| ParentInvoiceGuid | uniqueidentifier | - | Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно. | hlt_Invoice.GUID | |
| isCancelled | bit | Признак аннулирования счета | hlt_Invoice.FLAG | ||
| paySum | decimal(18, 2) | + | Сумма, подлежащая оплате (Рассчитывается как сумма счета - сумма оплаты) | hlt_Invoice.paySum | |
| invoiceSum | decimal(18, 2) | + | Сумма счёта | hlt_Invoice.InvoiceSum | |
| Discount | decimal(18, 2) | Скидка по счету | |||
| Массив «Discount» | |||||
| smDiscountGuid | uniqueidentifier | Идентификатор скидки по справочнику | |||
| smDiscountName | varchar(500) | Наименование скидки по справочнику | |||
| smDiscountValue | decimal (5, 2) | Размер скидки | |||
Массив «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( | |||
Цена за единицу услуги с учётом скидки.
hlt_BillService.discountPrice18, 2) | + | Цена за единицу услуги с учётом скидки. | hlt_BillService.discountPrice | ||
| smDiscount | decimal(18, 2) | Скидка по позиции счета | |||
| Массив «Discount» | |||||
| smDiscountGuid | uniqueidentifier | Идентификатор скидки по справочнику | |||
| smDiscountName | varchar(500) | Наименование скидки по справочнику | |||
| smDiscountValue | decimal (5, 2) | ||||
+
| Размер скидки |
1.2 Метод получения счетов из сервиса ТМ:МИС по ФИО и ДР плательщика
Адрес запроса
| GET: {{url}}/api/paidServices/IntegrationInvoice/ByPayer |
| Раскрыть | ||
|---|---|---|
| ||
Если тип договора, по которому сформирован счёт "Физическое лицо" |
Входные данные.
Параметры:
| Поле 1С | Тег ТМ:МИС | Тип | Обязат. | Описание | Поле БД МИС |
OGRN | varchar(15) | + | ОГРН ЛПУ | oms_LPU.C_OGRN | |
OID | varchar(50) | + | OID структурного подразделения | oms_LPU.Lic | |
| FIO | varchar(50) | -/+ | ФИО плательщика | ||
| Birthday | datetime | -/+ | Дата рождения плательщика Обязательно, если указано ФИО плательщика |
Выходные данные.
Параметры:
| Поле 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 | + | ГУИД плательщика | По данному полю осуществляется поиск данных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется. | |
| birthday | datetime | + | Дата рождения плательщика | ||
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 | |
| ParentInvoiceGuid | uniqueidentifier | - | Идентификатор счета (родительского счета), в рамках которого были оплачены услуги, которые включены в счет возврат. При передаче счета с типом "Счет возврат" указание идентификатора родительского счета обязательно. | hlt_Invoice.GUID | |
| isCancelled | bit | Признак аннулирования счета | hlt_Invoice.FLAG | ||
| paySum | decimal(18, 2) | + | Сумма, подлежащая оплате (Рассчитывается как сумма счета - сумма оплаты) | hlt |
| _Invoice.paySum | |||||
| invoiceSum | decimal(18, 2) | + | Сумма счёта | hlt_Invoice.InvoiceSum | |
| Discount | decimal(18, 2) | Скидка по счету | |||
| Массив «Discount» | |||||
| smDiscountGuid | uniqueidentifier | Идентификатор скидки по справочнику | |||
| smDiscountName | varchar(500) | Наименование скидки по справочнику | |||
| smDiscountValue | decimal (5 | ||||
| , 2) |
| Размер скидки | |||||
Массив «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 |
| smDiscount | decimal(18, 2) | Скидка по позиции счета | |||
| Массив «Discount» | |||||
| smDiscountGuid | uniqueidentifier | Идентификатор скидки по справочнику | |||
| smDiscountName | varchar(500) | Наименование скидки по справочнику | |||
| smDiscountValue | decimal (5, 2) | Размер скидки | |||
2. Метод передачи подтверждения получения счёта в ТМ:МИС
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/Receive |
| Раскрыть | ||
|---|---|---|
| ||
Если счёт в статусе "Создан", ему ставится статус "Передан в кассу" |
...
3. Метод передачи признака оплаты счёта в ТМ:МИС
Адрес запроса
| POST: {{url}}//api/paidServices/IntegrationInvoice/Pay |
Входные данные.
Параметры:
...
4. Метод передачи справочника касс в ТМ:МИС
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/CashDesk |
Входные данные.
Параметры:
...