↑ Все API
Cервис Финансовой информации
Для работы с API доступно демо-окружение, где можно протестировать запросы перед использованием в продуктивном контуре. Авторизация осуществляется с использованием Bearer токена, передаваемого в заголовке запроса.
Для получения логина и пароля для доступа к демо- и продуктивному-окружению, а также для уточнения деталей, обращайтесь в техническую поддержку.
Инструкция и пример по получению токена для работы с API доступна по ссылке: https://api-integration.omk.ru/auth/apiDoc.
Параметры
Получает сертификат по одному из параметров:
- TYPE_DOCUMENT - Тип документа
- NUMBER - Номер документа
- DATE - Дата документа
- DATE_PAY - Срок оплаты
- PAYMENT_PAYED - Оплачено (true\false)
- DAYS - Отсрочка
- POSITION.SPECIFICATION_NUMBER - Спецификация
- POSITION.DELIVERY_SAP_ID - Поставка
- CORRECTIVE_INVOICE.NUMBER - Номер документа (корр. счет-фактура)
- CORRECTIVE_INVOICE.DATE - Дата документа (корр. счет-фактура)
- CORRECTIVE_INVOICE.DATE_PAY - Срок оплаты (корр. счет-фактура)
- CORRECTIVE_INVOICE.DAYS - Отсрочка (корр. счет-фактура)
- CORRECTIVE_INVOICE.PAYMENT_PERIOD - Период оплаты (корр. счет-фактура)
- CORRECTIVE_INVOICE.PAYMENT_PAYED - Оплачено (true\false) (корр. Счет-фактура)
- limit - Количество записей. На данный момент доступные лимиты 5, 10, 20
- offset - Смещение
С какими сущностями работает
- invoice - Инвойсы
- invoice_position - Позиции инвойсов
- document - Документы
- delivery_position - Позиции поставок
- material - Материалы
Как вызвать
Примеры запросов по разным параметрам:
curl -X 'GET' \ 'http://data-connector/api/lk/finInfo?limit=5&PAYMENT_PAYED=false' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 13|NAQE3LIg3hkbcSGD67exCBHNTX7ArMrbYN6y4LLM'
curl -X 'GET' \ 'http://data-connector/api/lk/finInfo?limit=5&offset=2&TYPE_DOCUMENT=invoice' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 13|NAQE3LIg3hkbcSGD67exCBHNTX7ArMrbYN6y4LLM'
curl -X 'GET' \ 'http://data-connector/api/lk/finInfo?limit=5&POSITION[DELIVERY_SAP_ID]=82107948' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 13|NAQE3LIg3hkbcSGD67exCBHNTX7ArMrbYN6y4LLM'
curl -X 'GET' \ 'http://data-connector/api/lk/finInfo?limit=5&CORRECTIVE_INVOICE[NUMBER]=1800000410-25/48' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 13|NAQE3LIg3hkbcSGD67exCBHNTX7ArMrbYN6y4LLM'
curl -X 'GET' \ 'http://data-connector/api/lk/finInfo?limit=5&CORRECTIVE_INVOICE[PAYMENT_PAYED]=false' \ -H 'accept: application/json' \ -H 'Authorization: Bearer 13|NAQE3LIg3hkbcSGD67exCBHNTX7ArMrbYN6y4LLM'
Что в ответе
Стандартизованный объект:
Пример ответа
{
"success": true,
"error_code": null,
"data": {
"result": [
{
"TYPE_DOCUMENT": "invoice",
"INVOICE_TYPE_CODE": "ZF2",
"CONTRACT_DATE": "2022-08-03 00:00:00",
"CONTRACT_NUMBER": "22-МП-018",
"CURRENCY": "RUB",
"DATE_PAY": "2025-02-10 00:00:00",
"DATE": "2025-01-09 00:00:00",
"PAYMENT_PAYED": false,
"DAYS": 30,
"INVOICE_ID_SAP": "0092112915",
"NUMBER": "92112915",
"SUM": 1362684.71,
"TAX_SUM": 227114.12,
"DOCUMENT": null,
"POSITION": [
{
"ID": 4899153,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899154,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899155,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899156,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899157,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899158,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899159,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899160,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899161,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899162,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899163,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
}
],
"CORRECTIVE_INVOICE": null
},
{
"TYPE_DOCUMENT": "storno",
"INVOICE_TYPE_CODE": "S1",
"CONTRACT_DATE": "2022-08-03 00:00:00",
"CONTRACT_NUMBER": "22-МП-018",
"CURRENCY": "RUB",
"DATE_PAY": "2025-02-10 00:00:00",
"DATE": "2025-01-09 00:00:00",
"PAYMENT_PAYED": false,
"DAYS": 30,
"INVOICE_ID_SAP": "0092119435",
"NUMBER": "92119435",
"SUM": 1362684.71,
"TAX_SUM": 227114.12,
"DOCUMENT": null,
"POSITION": [
{
"ID": 4899142,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899143,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899144,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899145,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899146,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899147,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899148,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899149,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899150,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899151,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899152,
"QUANTITY": 1.785,
"SUM": 103233.69,
"CODE": "509030005096",
"NAME": "Прокат листовой 25х1500-09Г2С-345-15 ГОСТ 19281-2014",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
}
],
"CORRECTIVE_INVOICE": null
},
{
"TYPE_DOCUMENT": "invoice",
"INVOICE_TYPE_CODE": "ZF2",
"CONTRACT_DATE": "2023-05-11 00:00:00",
"CONTRACT_NUMBER": "23-МП-019",
"CURRENCY": "RUB",
"DATE_PAY": "2025-02-21 00:00:00",
"DATE": "2025-01-22 00:00:00",
"PAYMENT_PAYED": false,
"DAYS": 30,
"INVOICE_ID_SAP": "0092118388",
"NUMBER": "92118388",
"SUM": 2657820,
"TAX_SUM": 442970,
"DOCUMENT": null,
"POSITION": [
{
"ID": 4899136,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899137,
"QUANTITY": 2.98,
"SUM": 163900,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899138,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899139,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899140,
"QUANTITY": 7.49,
"SUM": 411950,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
},
{
"ID": 4899141,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": null
}
],
"CORRECTIVE_INVOICE": null
},
{
"TYPE_DOCUMENT": "storno",
"INVOICE_TYPE_CODE": "S1",
"CONTRACT_DATE": "2023-05-11 00:00:00",
"CONTRACT_NUMBER": "23-МП-019",
"CURRENCY": "RUB",
"DATE_PAY": "2025-02-21 00:00:00",
"DATE": "2025-01-22 00:00:00",
"PAYMENT_PAYED": false,
"DAYS": 30,
"INVOICE_ID_SAP": "0092119434",
"NUMBER": "92119434",
"SUM": 2657820,
"TAX_SUM": 442970,
"DOCUMENT": null,
"POSITION": [
{
"ID": 4899130,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899131,
"QUANTITY": 2.98,
"SUM": 163900,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899132,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899133,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899134,
"QUANTITY": 7.49,
"SUM": 411950,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
},
{
"ID": 4899135,
"QUANTITY": 7.45,
"SUM": 409750,
"CODE": "472001842",
"NAME": null,
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": null,
"DELIVERY_SAP_ID": "0"
}
],
"CORRECTIVE_INVOICE": null
},
{
"TYPE_DOCUMENT": "invoice",
"INVOICE_TYPE_CODE": "ZF2V",
"CONTRACT_DATE": "2023-04-25 00:00:00",
"CONTRACT_NUMBER": "SSA/01-23",
"CURRENCY": "RUB",
"DATE_PAY": "2025-03-01 00:00:00",
"DATE": "2025-03-01 00:00:00",
"PAYMENT_PAYED": false,
"DAYS": 0,
"INVOICE_ID_SAP": "0092119432",
"NUMBER": "1800004559-25",
"SUM": 612230.4,
"TAX_SUM": 102038.4,
"DOCUMENT": null,
"POSITION": [
{
"ID": 4899129,
"QUANTITY": 4.724,
"SUM": 510192,
"CODE": "501110000183",
"NAME": "Труба электросварная обсадная BC-N80 Q-114,3х7,37 PSL1 ГОСТ 31446-2017",
"MEASURE": "TNE",
"SPECIFICATION_NUMBER": "1",
"DELIVERY_SAP_ID": "82142259"
}
],
"CORRECTIVE_INVOICE": null
}
],
"total": 10000,
"limit": 5,
"offset": 0
}
}
Пояснения по значениям полей
- TYPE_DOCUMENT: corrective (Корректировочные счет-фактуры), replace (Исправительные счет-фактуры), storno (Сторнированные счет-фактуры), invoice (Счет-фактуры)
- INVOICE_TYPE_CODE: S1 (Сторно CчетФактур), S2 (Сторно кредит-авизо), ZG2 (Сторно прош период), ZG2K (Сторно КрАвЗав Прпер), ZS2 (Сторно КрАвизоЗавод), ZL2K (CторноДебАвЗав ПрПер), ZF2 (Счет-фактура), ZF2A (Сч-фАТЗ), ZN2 (Счет-фактура за ТМЦ), ZF2E (Сч-фЗавод валюта), ZF2M (Сч-ф валюта м/п), ZF2V (Сч-фЗавод)
- CORRECTIVE_INVOICE.INVOICE_TYPE_CODE: RE (Кредитование возврата), ZG2V (КредАвизо Завод), ZL2V (ДебАвизо Завод)
| Название | Описание |
|---|---|
| TYPE_DOCUMENT | Тип документ |
| INVOICE_TYPE_CODE | Тип инвойса |
| CONTRACT_DATE | Дата договора |
| CONTRACT_NUMBER | Номер договора |
| CURRENCY | Валюта |
| DATE_PAY | Срок оплаты |
| DATE | Дата документа |
| PAYMENT_PAYED | Оплачено (true\false) |
| DAYS | Количество дней отсрочки |
| INVOICE_ID_SAP | Номер инвойса в SAP |
| NUMBER | Номер инвойса |
| SUM | Сумма инвойса |
| TAX_SUM | Сумма налога |
| DOCUMENT | |
| ID | ID документа |
| NUMBER | Номер документа |
| DATE | Дата документа |
| TYPE | Тип документа |
| TYPE_CODE | Код типа документа |
| POSITION | |
| ID | ID позиции |
| QUANTITY | Количество товара |
| SUM | Сумма к оплате |
| CODE | Код материала |
| NAME | Наименование материала |
| MEASURE | Ед. измерения |
| SPECIFICATION_NUMBER | Номер спецификации |
| DELIVERY_SAP_ID | Номер поставки в SAP |
| CORRECTIVE_INVOICE | |
| ID | ID (корр. счет-фактура) |
| NUMBER | Номер документа (корр. счет-фактура) |
| SUM | Сумма инвойса (корр. счет-фактура) |
| TAX_SUM | Сумма налога (корр. счет-фактура) |
| INVOICE_TYPE_CODE | Тип инвойса |
| DATE | Дата документа |
| DATE_PAY | Срок оплаты |
| DAYS | Количество дней отсрочки |
| PAYMENT_PAYED | Оплачено (true\false) |