Закрывающие документы (ModClosingDocumentsViaCorteos)
- Александр Исобаев
Тип мода: клиентский
Категория мода: 2
Описание мода: Данный мод, позволяет при помощи api, через отдельный интерфейс, сотрудникам клиента, с определенными ролями, выгружать различные закрывающие документы со стороны агентства с их SFTP.
Настройка мода:
Через marketplace агентства подключается мод
Далее в меню “Расширение” открываем настройку “Настройка доступа к API закрывающих документов” и производим настройки подключения к вебсервису и sftp
Затем заходим в нужный договор и включаем мод уже там, а так же переходим в меню “Настройки” в раздел “Настройка доступа к API закрывающих документов” и указываем каким ролям клиента доступен этот функционал. (Возможно указание и классических ролей и кастомных)
После всех настроек, у клиента (кому разрешен доступ), появляется новый раздел в меню “Заказы” под названием “Финансовые документы”
В самом разделе есть несколько фильтров для поиска нужных документов, но обязательный фильтр только 1: даты
После выдачи документов пользователь может скачать как отдельный документ, так и выбрать несколько документов и скачать их разом.
ВНИМАНИЕ: Настройка вебсервиса со стороны агента
Для работы данного мода, на стороне агентства должен быть развернуть вебсервис и sftp который может принимать наши запросы и давать ответы с документами.
Corteos посылает запросы такого формата:
http://test.corteos.ru/files/hs/SFTPExchange/GetDocs?ids=10,24880
http://test.corteos.ru/files/hs/SFTPExchange/GetDocs?number=5150131&ids=24880
Т.е. после адреса вебсервиса мы указываем параметр запроса и его значения.
Параметры:
number - Строка - номер документа(счета)
datestart - Дата(YYYY-MM-DD) - дата с
dateend - Дата(YYYY-MM-DD) - дата по
ids - Строка - ИД контрагентов в кортеосе, разделенные запятым
idtypes - Строка - ИД типов документов, разделенные запятыми
Описание элементов:
Name - Имя документа
Id - ИД контрагента
IdType - Ид типа документа
Path - Путь на SFTP
DocNumber - Номер документа
DocDate - Дата документа
Type - Тип документа
Справочник типов документов:
1 Акт
2 Ваучеры
3 Корректировочная счет фактура
4 Маршрутные квитанции
5 Накладная
6 Отчет агента
7 Реестр
8 Счет на оплату
9 Счет фактура
10 УКД
11 УПД
Пример ожидаемого ответа от вебсервиса:
[
{
"Name": "Маршрутные квитанции_5060133.zip",
"Id": "24880",
"IdType": "4",
"Path": "/МСП/2024 Май/05060133/Маршрутные квитанции_5060133.zip",
"DocNumber": "5060133",
"DocDate": "2024-05-06T00:00:00",
"Type": "Маршрутные квитанции"
},
{
"Name": "Реестр_5060133.xlsx",
"Id": "24880",
"IdType": "7",
"Path": "/МСП/2024 Май/05060133/Реестр_5060133.xlsx",
"DocNumber": "5060133",
"DocDate": "2024-05-06T00:00:00",
"Type": "Реестр"
},
{
"Name": "Счет на оплату покупателю_5060133.pdf",
"Id": "24880",
"IdType": "8",
"Path": "/МСП/2024 Май/05060133/Счет на оплату покупателю_5060133.pdf",
"DocNumber": "5060133",
"DocDate": "2024-05-06T00:00:00",
"Type": "Счет на оплату"
},
{
"Name": "УПД_5060133.pdf",
"Id": "24880",
"IdType": "11",
"Path": "/МСП/2024 Май/05060133/УПД_5060133.pdf",
"DocNumber": "5060133",
"DocDate": "2024-05-06T00:00:00",
"Type": "УПД"
},
{
"Name": "Маршрутные квитанции_5150131.zip",
"Id": "24880",
"IdType": "4",
"Path": "/МСП/2024 Май/05150131/Маршрутные квитанции_5150131.zip",
"DocNumber": "5150131",
"DocDate": "2024-05-15T00:00:00",
"Type": "Маршрутные квитанции"
},
{
"Name": "Реестр_5150131.xlsx",
"Id": "24880",
"IdType": "7",
"Path": "/МСП/2024 Май/05150131/Реестр_5150131.xlsx",
"DocNumber": "5150131",
"DocDate": "2024-05-15T00:00:00",
"Type": "Реестр"
},
{
"Name": "Счет на оплату покупателю_5150131.pdf",
"Id": "24880",
"IdType": "8",
"Path": "/МСП/2024 Май/05150131/Счет на оплату покупателю_5150131.pdf",
"DocNumber": "5150131",
"DocDate": "2024-05-15T00:00:00",
"Type": "Счет на оплату"
},
{
"Name": "УПД_5150131.pdf",
"Id": "24880",
"IdType": "11",
"Path": "/МСП/2024 Май/05150131/УПД_5150131.pdf",
"DocNumber": "5150131",
"DocDate": "2024-05-15T00:00:00",
"Type": "УПД"
}
]