Протокол интеграции с МИС МедПроф
Направления
Parameters:
Name Description

orderId * required

integer

(path)

 ID направления в МИС

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "id" : 0, // идентификатор направления (orderId) в МИС
    "fam" : "Иванов Иван Иванович", // ФИО пациента,
    "gender" : "мужской", // пол пациента
    "birthday" : "01.01.1985", // Дата рождения
    "address": "Санкт-Петербург, Лиговский пр, д. 78", // Адрес регистрации
    "citizenship": "Россия", // Гражданство
    "passport": "4000 123411", // Серия и номер паспорта
    "passportDate": "2010-10-11", // Дата выдачи паспорта
    "passportPlace": "ТП №5 УФМС РОССИИ", // Место выдачи
    "phone": "+7 (900) 000-11-22", // Телефон
    "orderDate" : "15.12.2019", // дата прохождения мед обследования
    "subdivision": {
        "id": "2585", // подразделение (id из справочника /subdivisions/{medClientId})
        "name": "IT" // наименование подразделения
    },
    "profession": {
        "id": "0", // профессия (id из справочника /professions/{medClientId})
        "name": "Повар" // наименование профессии
    },
    "med" : [ // объём обследования пациента
        {
            "id" : 0, // идентификатор услуги
            "name" : "Вакцинация против кори", // наименование услуги
            "date" : "15.12.2019", // дата проведения или результата обследования
        },
        {
            "id" : 0, // идентификатор услуги
            "name" : "ФЛГ", // наименование услуги
            "date" : "15.12.2019", // дата проведения или результата обследования
        }
    ],
    "services" : [ // оказанные услуги
        {
            "id" : 0, // идентификатор группы обследования
            "name" : "Оформление личной медицинской книжки", // наименование услуги
        },
        {
            "id" : 0, // идентификатор группы обследования
            "name" : "Справка 086/у", // наименование услуги
        }
    ],
    "status" : "ready", // Статус направления (key из справочника /dictionary/status)
    "statusName" : "Оформлен", // Наименование статуса
    "startDate" : "2022-01-12 17:14:16", // Начало обследования в медицинском центре
    "finishDate" : "2022-01-12 18:20:18", // Завершение обследования в медицинском центре
    "completeDate" : "2022-01-13 11:35:30", // Готовы итоговые документы
    "deliveryDate" : "2022-01-17 17:10:56" // Передан в доставку,
    "conclusion29n" : [ // Статус заключения по результатам предварительного / периодического осмотра по приказу МЗ РФ № 29н от 28.01.2021 г.
        "id": "1",
        "state": "Годен",
        "text": "Медицинских противопоказаний к работе с указанными вредными и (или) опасными производственными факторами по приказу МЗ РФ № 29н от 28.01.2021 г. не выявлено"
    ]
}

400

Invalid orderId supplied or access denied

401

Unauthorized

Parameters:
Name Description

orderId * required

integer

(path)

 ID направления в МИС

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

Pdf file in binary form

400

Invalid orderId supplied or access denied

401

Unauthorized

422

System error

открыть /order Создание направления на обследование

Parameters:
Name Description

access-token * required

string

(header)

 Секретный ключ

body * required

object

(body)

Информация о пациенте

{
    "fam": "Иванов Иван Иванович", // ФИО пациента, * required
    "gender": "мужской", // пол пациента (мужской/женский) * required
    "birthday": "1990-01-01", // Дата рождения (yyyy-mm-dd) * required
    "surveyTypeId": "1", // вид осмотра (id из справочника /dictionary/survey)
    "address": "Санкт-Петербург, Лиговский пр, д. 78", // Адрес регистрации
    "citizenship": "Россия", // Гражданство
    "passport": "4000 123411", // Серия и номер паспорта
    "passportDate": "2010-10-11", // Дата выдачи паспорта
    "passportPlace": "ТП №5 УФМС РОССИИ", // Место выдачи
    "phone": "79001234455", // Телефон (11 цифр)
    "snils": "111-111-111 11", // Снилс
    "payType":1, // вид оплаты (id из справочника /dictionary/paytypes) * required
    "medClientId":100, // договор (id из справочника /medClient) * required
    "subdivisionId":1, // подразделение (id из справочника /subdivisions/{medClientId})
    "subdivision":"String", // подразделение, если нет в справочнике /subdivisions/{medClientId}
    "professionId":2, // профессия (id из справочника /professions/{medClientId})
    "profession":"String", // профессия, если нет в справочнике /professions/{medClientId}
    "services": ["5","1"], // оказанные услуги (id из справочника /dictionary/services) * required
    "hazards": ["432", "419"], // Пункты приказа 29н (id из справочника /dictionary/hazards)
    "parts": ["1"] // Доп. услуги (id из справочника /dictionary/parts)
}

Responses:
Code Description

200

successful operation

{
    "id": "55551" // ID направления
}

405

Invalid input

Parameters:
Name Description

orderId * required

integer

(path)

 ID направления в МИС

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "id": "55551" // ID направления
}

400

Invalid orderId supplied or access denied

401

Unauthorized

403

Not Acceptable. Order is already in progress.

404

404 Not Found

Parameters:
Name Description

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "id" : 0, // идентификатор направления (orderId) в МИС
    "fam" : "Иванов Иван Иванович", // ФИО пациента,
    "gender" : "мужской", // пол пациента
    "birthday" : "01.01.1985", // Дата рождения
    "address": "Санкт-Петербург, Лиговский пр, д. 78", // Адрес регистрации
    "citizenship": "Россия", // Гражданство
    "passport": "4000 123411", // Серия и номер паспорта
    "passportDate": "2010-10-11", // Дата выдачи паспорта
    "passportPlace": "ТП №5 УФМС РОССИИ", // Место выдачи
    "phone": "+7 (900) 000-11-22", // Телефон
    "orderDate" : "15.12.2019", // дата прохождения мед обследования
    "subdivision": {
        "id": "2585", // подразделение (id из справочника /subdivisions/{medClientId})
        "name": "IT" // наименование подразделения
    },
    "profession": {
        "id": "0", // профессия (id из справочника /professions/{medClientId})
        "name": "Повар" // наименование профессии
    },
    "med" : [ // объём обследования пациента
        {
            "id" : 0, // идентификатор услуги
            "name" : "Вакцинация против кори", // наименование услуги
            "date" : "15.12.2019", // дата проведения или результата обследования
        },
        {
            "id" : 0, // идентификатор услуги
            "name" : "ФЛГ", // наименование услуги
            "date" : "15.12.2019", // дата проведения или результата обследования
        }
    ],
    "services" : [ // оказанные услуги
        {
            "id" : 0, // идентификатор группы обследования
            "name" : "Оформление личной медицинской книжки", // наименование услуги
        },
        {
            "id" : 0, // идентификатор группы обследования
            "name" : "Справка 086/у", // наименование услуги
        }
    ],
    "status" : "ready", // Статус направления (key из справочника /dictionary/status)
    "statusName" : "Оформлен" // Наименование статуса
    "startDate" : "2022-01-12 17:14:16", // Начало обследования в медицинском центре
    "finishDate" : "2022-01-12 18:20:18", // Завершение обследования в медицинском центре
    "completeDate" : "2022-01-13 11:35:30", // Готовы итоговые документы
    "deliveryDate" : "2022-01-17 17:10:56" // Передан в доставку,
    "conclusion29n" : [ // Статус заключения по результатам предварительного / периодического осмотра по приказу МЗ РФ № 29н от 28.01.2021 г.
        "id": "1",
        "state": "Годен",
        "text": "Медицинских противопоказаний к работе с указанными вредными и (или) опасными производственными факторами по приказу МЗ РФ № 29н от 28.01.2021 г. не выявлено"
    ]
}

400

Invalid ID supplied or access denied

404

Order not found
Договоры
Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "medclients" : [ // услуги
        {
            "id" : 0, // идентификатор договора
            "name" : "ООО Ромашка", // наименование организации
            "altname" : "Ромашка ООО", // наименование организации
            "contractNumber" : "1", // номер договора
            "contractDate" : "2020-01-01" // дата договора
        },
        {
            "id" : 0, // идентификатор договора
            "name" : "ООО Золушка", // наименование организации
            "altname" : "Золушка ООО (ресторан)", // наименование организации
            "contractNumber" : "1", // номер договора
            "contractDate" : "2020-01-01" // дата договора
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ

medClientId * required

string

(path)

 договор (id из справочника /medClient)
Responses:
Code Description

200

successful operation

{
	"medclientId" : "0", // договор (id из справочника /medClient)
	"subdivisions" : [ // услуги
        {
            "id" : 0, // идентификатор
            "name" : "Ресторан", // наименование
        },
        {
            "id" : 0, // идентификатор
            "name" : "Склад", // наименование
        }
	]
}

401

Unauthorized

400

Invalid ID supplied or access denied

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ

medClientId * required

string

(path)

 договор (id из справочника /medClient)
Responses:
Code Description

200

successful operation

{
	"medclientId" : "0", // договор (id из справочника /medClient)
	"professions" : [ // услуги
        {
            "id" : 0, // идентификатор
            "name" : "Повар", // наименование
            "hazards" : ["461"]
        },
        {
            "id" : 0, // идентификатор
            "name" : "Официант", // наименование
            "hazards" : []
        }
	]
}

401

Unauthorized

400

Invalid ID supplied or access denied

422

System error

Справочники
Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "services" : [ // услуги
        {
            "id" : 0, // идентификатор услуги
            "name" : "Оформление личной медицинской книжки", // наименование услуги
        },
        {
            "id" : 0, // идентификатор услуги
            "name" : "Предварительный/периодический медицинский осмотр", // наименование услуги
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "parts" : [ // услуги
        {
            "id" : 0, // идентификатор услуги
            "name" : "Фтизиатр", // наименование услуги
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "med" : [ // услуги из объёма обследования
        {
            "id" : 0, // идентификатор услуги
            "name" : "Терапевт", // наименование услуги
        },
        {
            "id" : 0, // идентификатор услуги
            "name" : "Клинический анализ крови", // наименование услуги
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "status" : [
        {
            "key" : 0, // идентификатор статуса
            "name" : "Создан заказ", // наименование статуса
        },
        {
            "id" : 0, // идентификатор статуса
            "name" : "Проходит обследование", // наименование статуса
        }
    ]
}

401

Unauthorized

422

System error

открыть /dictionary/survey Получение номенклатуры видов осмотра

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "surveyTypes" : [
        {
            "id" : 0, // идентификатор 
            "name" : "предварительный", // наименование 
        },
        {
            "id" : 0, // идентификатор 
            "name" : "периодический", // наименование 
        }
    ]
}

401

Unauthorized

422

System error

открыть /dictionary/paytypes Получение номенклатуры типов оплаты

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "payTypes" : [
        {
            "id" : 0, // идентификатор
            "name" : "Наличные", // наименование
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "hazards" : [
        {
            "id" : 0, // идентификатор
            "point" : "23.", // пункт
            "name" : "Работы, где имеется контакт с пищевыми продуктами в процессе их производства, хранения, транспортировки и реализации (в организациях пищевых и перерабатывающих отраслей промышленности, сельского хозяйства, пунктах, базах, складах хранения и реализации, в транспортных организациях, организациях торговли, общественного питания, на пищеблоках всех учреждений и организаций)", // наименование
        }
    ]
}

401

Unauthorized

422

System error

Parameters:

access-token * required

string

(header)

 Секретный ключ
Responses:
Code Description

200

successful operation

{
    "statuses" : [
        {
            "id" : 1, // идентификатор
            "name" : "Годен", // наименование
        },
        {
            "id" : 2, // идентификатор
            "name" : "Не годен", // наименование
        },
        {
            "id" : 3, // идентификатор
            "name" : "Ограниченно годен", // наименование
        }
    ]
}

401

Unauthorized

422

System error