Все методы возвращают результат в виде объекта OperationResult
Зелёный - новая сущность в ТМ:МИС.
Оранжевый - под вопросом.
1 Метод получения счетов из сервиса ТМ:МИС
...
(deprecated)
Предупреждение |
---|
Метод остался, но нужно перейти на метод получения счетов по номеру |
Раскрыть | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Входные данные. Параметры:
|
...
|
...
|
...
|
...
Выходные данные. Параметры:
|
...
Тело:
|
...
клиентТММИС
...
Массив «Client»
...
+
...
|
|
...
|
...
|
...
|
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 | + | ГУИД плательщика
| По данному полю осуществляется поиск |
Дата
Текущая дата, указывает дату когда будет печататься чек. Смена должна быть открыта
Вид операции
Перечисление.ВидОперации (Продажа)
Обрабатывается только операция продажи
ЦенаВключаетНДС
Булево (Истина)
Цена всегда включает НДС
ЮрФизЛицо
dogovorType
int
+
Тип договора. Только с Физ. лицом
hlt_DogovorPaying.rf_DogovorPayingTypeID
mkabGUID
uniqueidentifier
+
ГУИД МКАБ
hlt_MKAB.UGUID
По данному полю осуществляется поискданных, если не найдено создается новый. Справочник создаётся один раз, потом автоматически не синхронизируется. | |||||
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 | |
Массив «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 |
Цена со скидкой |
smCost
smPrice | decimal(18, 2) | + |
Цена за единицу услуги с |
hlt_Invoice.BillSum
учётом скидки. | hlt_BillService.discountPrice |
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 | |
Массив «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 |
Цена со скидкой
decimal(20, 5)
+
Цена за единицу услуги с учётом скидки.
Рассчитывается как smCost/smCount
Цена
smPrice
) | + | Цена за единицу услуги с учётом скидки. |
hlt_ |
BillService. |
discountPrice |
2 Метод передачи подтверждения получения
...
счёта в ТМ:МИС
Адрес запроса
POST: {{url}}/api/paidServices/IntegrationInvoice/Receive |
Раскрыть | ||
---|---|---|
| ||
Если счёт в статусе "Создан", ему ставится статус "Передан в кассу" |
Входные данные.
Параметры:
Поле 1С | Тег ТМ:МИС | Тип | Обязат. | Описание | Поле БД МИС |
BillFlag
bit
-
Признак оплаты счёта
hlt_Invoice.BillFlag
GetFlag
bit
+
Признак подтверждения получения счёта
hlt_Invoice.GetFlag
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 |
СтатусЧека
Число (1)
Статус (0-не обработано, 1 - обработано)
...
cashdeskGuid | uniqueidentifier | + | Гуид кассы | hlt_Cashdesk.UGUID | |
Type | int | + | Тип документа (1– Счёт-заказ, 3 – Счёт-возврат) | hlt_Invoice.rf_InvoiceTypeID | |
Массив «Payments» | |||||
paySum | decimal(18, 2) | + | Сумма платежа | hlt_Invoice.paySum | |
PaymentType | int | + | Форма оплаты (1- Наличный расчет, 3 - Банковская карта) | hlt_Invoice.rf_PaymentTypeID |
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 |
LpuOGRN
varchar(15)
+
ОГРН ЛПУ
oms_LPU.C_OGRN
LpuOID
varchar(50)
+
OID структурного подразделения