Все методы возвращают результат в виде объекта OperationResult
Зелёный - новая сущность в ТМ:МИС.
Синий - новые поля в модели
1 Метод получения счетов из сервиса ТМ:МИС (deprecated)
Метод остался, но нужно перейти на метод получения счетов по номеру
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 | |
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 | |
| status | int | + | Статус счёта 1 - Создан 2 - Передан в кассу 3 - Оплачен 4 - Выполнен 5 - Аннулирован 6 - Частично оплачен 7 - Считать оплаченным 8 - Создан и оказан 9 - Требуется отправка в ОФД 10 - Оплачен и оказан | Поле не заполняется для текущей версии спецификации! Используется только для Интеграции с рабочим местом кассира 2.0 | |
Массив «Services» | |||||
idУслугиТММИС | smguid | uniqueidentifier | + | По данному полю осуществляется поиск данных, если не найдено создается новый. Если найден, то проверяется опция на предмет возможности изменения и если она установлена перезатираются все поля в соответствии с полученными данными, в противном случае данные не меняются. | oms_ServiceMedical.GUIDSM hlt_BillService.UGUID |
кодУслугиТММИС | 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 Для счет-возврата: hlt_BillService.ServicePay |
Цена со скидкой | smPrice | decimal(18, 2) | + | Цена за единицу услуги с учётом скидки. | hlt_BillService.discountPrice |
| Признак оказания услуги | isCompleted | bit | + | Если услуга оказана -1 Если услуга не оказана - 0 | Поле не заполняется для текущей версии спецификации! Используется только для Интеграции с рабочим местом кассира 2.0 |
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 | |
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 | |
| status | int | + | Статус счёта 1 - Создан 2 - Передан в кассу 3 - Оплачен 4 - Выполнен 5 - Аннулирован 6 - Частично оплачен 7 - Считать оплаченным 8 - Создан и оказан 9 - Требуется отправка в ОФД 10 - Оплачен и оказан | Поле не заполняется для текущей версии спецификации! Используется только для Интеграции с рабочим местом кассира 2.0 | |
Массив «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 Для счет-возврата: hlt_BillService.ServicePay |
Цена со скидкой | smPrice | decimal(18, 2) | + | Цена за единицу услуги с учётом скидки. | hlt_BillService.discountPrice |
| Признак оказания услуги | isCompleted | bit | + | Если услуга оказана -1 Если услуга не оказана - 0 | Поле не заполняется для текущей версии спецификации! Используется только для Интеграции с рабочим местом кассира 2.0 |
2 Метод передачи подтверждения получения счёта в ТМ:МИС
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/Receive |
Входные данные.
Параметры:
| Поле 1С | Тег ТМ:МИС | Тип | Обязат. | Описание | Поле БД МИС |
OGRN | varchar(15) | + | ОГРН ЛПУ | oms_LPU.C_OGRN | |
OID | varchar(50) | + | OID структурного подразделения | oms_LPU.Lic | |
IdЗаказаТММИС | invoiceGuid | uniqueidentifier | + | ID Счета. | hlt_Invoice.GUID |
3 Метод передачи признака оплаты счёта в ТМ:МИС
Адрес запроса
| POST: {{url}}//api/paidServices/IntegrationInvoice/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 | |
Type | int | + | Тип документа (1– Счёт-заказ, 3 – Счёт-возврат) | hlt_Invoice.rf_InvoiceTypeID | |
| xml | varbinary | - | Тело платежа (xml) | новое поле | |
| Массив «Payments» | |||||
| paySum | decimal(18, 2) | + | Сумма платежа | hlt_Invoice.paySum | |
| PaymentType | int | + | Форма оплаты (1- Наличный расчет, 3 - Банковская карта) | hlt_Invoice.rf_PaymentTypeID | |
| Массив «Services» | |||||
idУслугиТММИС | smguid | uniqueidentifier | + | Идентификатор услуги счета | hlt_BillService.UGUID |
кодУслугиТММИС | smCode | varchar(50) | + | Код услуги | oms_ServiceMedical.ServiceMedicalCode |
Наименование | smName | varchar(500) | + | Наименование услуги | oms_ServiceMedical.ServiceMedicalName |
Сумма платежа | smPaySum | decimal(18, 2) | + | Сумма платежа по услуге | hlt_BillService.ServicePay |
4 Метод передачи справочника касс в ТМ:МИС
Адрес запроса
| POST: {{url}}/api/paidServices/IntegrationInvoice/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 | |
| Code | varchar(255) | - | Код кассы | hlt_Cashdesk.Code | |
| DateBegin | datetime | - | Дата начала действия | hlt_Cashdesk.DateBegin | |
| DateEnd | datetime | - | Дата окончания действия | hlt_Cashdesk.DateEnd |