API запросы ecos-edi

В ecos-edi микросервисе реализован функционал из enterprise-core cервиса EcosEdiService.

При отправке запроса на отправку пакета или документов или генерацию сервисных документов используется record dao c id - edi-action.

Для отправки запроса через рекорды необходимо использовать метод mutate.

DTO запроса:

public static class EdiActionRequest {
    private String requestType;
    private EdiProviderType providerType;
    private ObjectData requestData;
}

Где:

  • requestType - тип запроса, например “generatePrintForm“

  • providerType- тип провайдера, Контур, СБИС и т.д. для Диадока необходимо указывать “KONTUR“ (см. EdiProviderType enum).

  • requestData - данные по запросу, например, для генерации печатных форм это documentRef документа

Запросы с результатом возвращают объект с полем data. Например, результат проверки существования связи с контрагентом:

{"data": true}

Команды без возвращаемых данных возвращают пустой объект {}. Тип значения data зависит от действия: это может быть логическое значение, ссылка на запись, список ссылок или данные печатной формы.

Пример запроса:

RecordAtts requestAtts = new RecordAtts();
requestAtts.setId("edi/edi-action@");
requestAtts.setAtt("requestType", "generatePrintForm");
requestAtts.setAtt("providerType","KONTUR");
requestAtts.setAtt("requestData", ObjectData.create().set("documentRef", RecordRef.valueOf("recordRef value")));
recordsService.mutate(requestAtts);

Посмотреть различные типы запросов можно в классе EdiRequestRouter микросервиса ecos-edi

Пример запроса из консоли:

var rec = Records.get('edi/edi-action@'); // важно @ в конце
rec.att("_self", {
                "requestType":"generatePrintForm",
                "providerType":"KONTUR",
    "requestData": {"documentRef":"emodel/edi-document@5d518efd-cef1-4ebf-b518-62ff9a620c9e"}

    });
var resp = await rec.save("?json");

Параметр "?json" запрашивает JSON-представление ответа. save возвращает Promise, поэтому для получения результата используется await; данные запроса с результатом доступны в resp.data. Строка "json" без вопросительного знака запрашивает атрибут с таким именем.

Ссылки на записи и идентификаторы в примерах необходимо заменить данными вашей системы. Доступность конкретного действия зависит от провайдера и версии его коннектора.

Список текущих поддерживаемых запросов:

isCounterpartyExists — проверка существования связи с контрагентом

Запрос на проверку существования связи с контрагентом у конкретной организации.

Параметры requestData:

  • clientBoxId — ид проверяемого ящика

  • inn — ИНН контрагента

  • kpp — КПП контрагента

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"isCounterpartyExists",
                "providerType":"KONTUR",
                "requestData": {
                    "clientBoxId":"1312313-131331-1231",
                    "inn":"12334561234",
                    "kpp":"123652323"
                }

    });
var resp = await rec.save("?json");
acquireCounterparty — создание связи с контрагентом

Запрос на создание связи с контрагентом.

Параметры:

  • counterpartyRef - recordRef контрагента в ecos

  • clientBoxId - ид ящика организации

  • invitationDocRef - recordRef пригласительного документа (опционально)

  • comment - Комментарий

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"acquireCounterparty",
                "providerType":"KONTUR",
                "requestData": {
                    "counterpartyRef":"emodel/counterparty@12311241-123123",
                    "clientBoxId":"123123-123123123-123213",
                    "invitationDocRef":"emodel/invitationDoc@12311241-123123",
                    "comment": "commentText"
                }

    });
var resp = await rec.save("?json");
breakWithCounterparty — разрыв связи с контрагентом

Запрос на разрыв связи с контрагентом.

Параметры:

  • counterpartyRef - recordRef контрагента в ecos

  • clientBoxId - id ящика организации

  • comment - комментарий

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"breakWithCounterparty",
                "providerType":"KONTUR",
                "requestData": {
                    "counterpartyRef":"emodel/counterparty@12311241-123123",
                    "clientBoxId":"123123-123123123-123213",
                    "comment": "commentText"
                }

    });
var resp = await rec.save("?json");
sendPackageToCounterparty — отправка исходящего пакета провайдеру

Отправка исходящего пакета провайдеру.

Параметры:

  • packageRef - recordRef отправляемого пакета

  • counterpartyRef - recordRef контрагента в ecos

  • counterpartyBoxId - boxId контрагента (опционально, обязательно если не указан counterpartyRef)

  • legalEntityRef - recordRef юр. лица в ecos

  • clientBoxId - boxId юр. лица (опционально, обязательно если не указан legalEntityRef)

  • fromDepartmentId - Id департамента в провайдере от имени которого отправляется пакет (Опционально)

  • toDepartmentId - Id департамента в провайдере, которому отправляется пакет (Опционально)

  • isInternal - является ли пакет внутренним (оборот между департаменатами одной организации)

  • needSentSignature - Требуется ли подпись контрагента

  • packageNumber - Номер пакета (Опционально)

  • packageDate - Дата пакета в формате ГГГГ-ММ-ДД (Опционально)

  • packageComment - Комментарий к пакету (Опционально)

  • signerRef - recordRef пользователя подписавшего документы в пакете

  • targetType - id типа данных, по которому выбирается ящик ЭДО юр. лица и контрагента, если clientBoxId или counterpartyBoxId не указаны. Сопоставляется с полем «Типы цели» настроек ЭДО (Опционально)

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendPackageToCounterparty",
                "providerType":"KONTUR",
                "requestData": {
                    "packageRef":"emodel/edi-package@12311241-123123",
                    "counterpartyRef":"emodel/counterparty@12311241-123123",
                    "counterpartyBoxId":"234623478246824623442374",
                    "legalEntityRef":"emodel/legal-entity@12311241-123123",
                    "clientBoxId":"2342342342342342424324",
                    "fromDepartmentId":"3434444444444434343434",
                    "toDepartmentId":"242423423424242424242",
                    "isInternal":false,
                    "needSentSignature":true,
                    "packageNumber":"22551515252",
                    "packageDate":"2023-09-08",
                    "packageComment":"Test comment",
                    "signerRef": "emodel/person@12311241-123123"
                }

    });
var resp = await rec.save("?json");
signPackage — отправка подписанных документов в пакете провайдеру

Отправка подписанных документов в пакете провайдеру.

Параметры:

  • packageRef – recordRef пакета с ЭДО документами

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"signPackage",
                "providerType":"KONTUR",
                "requestData": {
                    "packageRef":"emodel/edi-package@12311241-123123"
                }

    });
await rec.save("?json");
pointwiseSync — точечная синхронизация с провайдером по одному пакету

Точечная синхронизация с провайдером по одному пакету.

Параметры:

  • clientBoxId - id ящика с которым настроена синхронизация

  • systemPackageId- id пакета по которому требуется провести синхронизацию

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"pointwiseSync",
                "providerType":"KONTUR",
                "requestData": {
                    "clientBoxId":"12315116136163241231",
                    "systemPackageId":"1321312312312321312312"
                }

    });
await rec.save("?json");
signDocuments — отправка подписей по документам провайдеру

Отправка подписей по документам провайдеру.

Параметры:

  • documentRefs - список подписанных документов, для которых требуется отправить подписи

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"signDocuments",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
signDocumentsAndBuyerTitles — отправка подписей по формализованным документам провайдеру

Отправка подписей по формализованным документам провайдеру.

Параметры:

  • documentRefs - список подписанных неформализованных документов, для которых требуется отправить подписи.

  • invoicesRefs - список подписанных формализованных документов, для которых требуется отправить подписи

  • inn - ИНН юр. лица (Опционально, используется провайдером СБИС)

  • fio - ФИО подписанта (Опционально, используется провайдером СБИС; по умолчанию — ФИО текущего пользователя)

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"signDocumentsAndBuyerTitles",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ],
                    "invoicesRefs":[
                                    "emodel/edi-document@ref3",
                                    "emodel/edi-document@ref4"
                                    ]
                }

    });
await rec.save("?json");
sendReconciliationActSigns — отправка подписей для актов сверки

Отправка подписей для актов сверки.

Параметры:

  • documentRefs - список подписанных актов сверки, для которых требуется отправить подписи

  • signerRef - recordRef пользователя подписавшего документы

  • signerJobTitle - Должность пользователя подписавшего документы

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendReconciliationActSigns",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ],
                    "signerRef":"emodel/person@ref-1",
                    "signerJobTitle":"Директор тест"
                }

    });
await rec.save("?json");
rejectPackage — отправка подписанного отказа в подписи документов в пакете

Отправка подписанного отказа в подписи документов в пакете.

Параметры:

  • packageRef - recordRef пакета с ЭДО документами

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"rejectPackage",
                "providerType":"KONTUR",
                "requestData": {
                    "packageRef":"emodel/edi-package@12311241-123123"
                }

    });
await rec.save("?json");
rejectDocuments — отправка подписанного отказа в подписи документов

Отправка подписанного отказа в подписи документов.

Параметры:

  • documentRefs - список документов, для которых требуется отправить отказ

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"rejectDocuments",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
sendReconciliationActRejects — отправка подписанных отказов в подписи для актов сверки

Отправка подписанных отказов в подписи для актов сверки.

Параметры:

  • documentRefs - список актов сверки для которых требуется отправить отказ

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendReconciliationActRejects",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
acceptRevocationRequests — отправка подписанного согласия на аннулирование по документам

Отправка подписанного согласия на аннулирование документов по предложению контрагента.

Параметры:

  • documentRefs - список документов по которым было подписано аннулирование

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"acceptRevocationRequests",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
declineRevocationRequests — отправка подписанных отказов по запросу на аннулирование по документам

Отправка подписанных отказов по запросу на аннулирование по документам.

Параметры:

  • documentRefs - список документов по которым было подписан отказ аннулирования

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"declineRevocationRequests",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
sendRevocationRequests — отправка подписанных запросов на аннулирование по документам

Отправка подписанных запросов на аннулирование по документам.

Параметры:

  • documentRefs - список документов по которым был подписан запрос на аннулирование

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendRevocationRequests",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
sendCorrectionRequests — отправка подписанных запросов на корректировку по документам

Отправка подписанных запросов на корректировку по документам.

Параметры:

  • documentRefs - список документов по которым был подписан запрос на корректировку

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendCorrectionRequests",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
sendBuyerTitles — отправка подписанных титулов покупателя по формализованным документам

Отправка подписанных титулов покупателя по формализованным документам.

Параметры:

  • documentRefs - список документов по которым был подписан титул покупателя

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendBuyerTitles",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
await rec.save("?json");
generatePrintForm — генерация печатной формы по документу

Генерация печатной формы по документу, возвращается контент печатной формы.

Параметры:

  • documentRef - recordRef документа по которому требуется сгенерировать печатную форму

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generatePrintForm",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
generatePrintFormWithDetails — генерация печатной формы по документу с доп. параметрами

Генерация печатной формы по документу, возвращается контент печатной формы + доп. параметры (id документа, статус генерации печатной формы у провайдера, возможные ошибки).

Параметры:

  • documentRef - recordRef документа по которому требуется сгенерировать печатную форму

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generatePrintFormWithDetails",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
needUpdateMainContentByPrintForm — требуется ли генерация печатной формы для документа

Требуется ли генерация печатной формы для документа.

Параметры:

  • documentRef - recordRef документа по которому требуется уточнение по требованию генерации

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"needUpdateMainContentByPrintForm",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
generateRejectionXml — генерация xml отказа в подписи для документа

Генерация xml отказа в подписи для документа.

Параметры:

  • documentRef – recordRef документа по которому требуется генерация xml отказа в подписи

  • signerRef - recordRef пользователя, который будет подписывать отказ

  • comment - комментарий отказа

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateRejectionXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "signerRef":"emodel/person@ref-1",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
generateRejectionsXml — генерация xml отказа в подписи для документов

Генерация xml отказа в подписи для документов.

Параметры:

  • documentRefs – список документов, по которым требуется генерация xml отказа в подписи

  • signerRef - recordRef пользователя, который будет подписывать отказ

  • comment - комментарий отказа

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateRejectionsXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ],
                    "signerRef":"emodel/person@ref-1",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
generateRevocationXml — генерация xml запроса на аннулирование для документа

Генерация xml запроса на аннулирование для документа.

Параметры:

  • documentRef – recordRef документа по которому требуется генерация xml запроса на аннулирование

  • signerName - имя пользователя, который будет подписывать запрос на аннулирование

  • comment - комментарий запроса на аннулирование

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateRevocationXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "signerName":"admin",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
generateRevocationsXml — генерация xml запроса на аннулирование для документов

Генерация xml запроса на аннулирование для документов.

Параметры:

  • documentRefs – recordRef документов по которым требуется генерация xml запроса на аннулирование

  • signerName - имя пользователя, который будет подписывать запрос на аннулирование

  • comment - комментарий запроса на аннулирование

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateRevocationsXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ],
                    "signerName":"admin",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
generateInvoiceCorrectionRequestXml — генерация xml корректировки для документа

Генерация xml корректировки для документа.

Параметры:

  • documentRef – recordRef документа по которому требуется генерация xml корректировки

  • signerName - имя пользователя, который будет подписывать корректировку

  • comment - комментарий

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateInvoiceCorrectionRequestXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "signerName":"admin",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
isNeedSignTitle — проверка на требование подписания титула покупателя у документа

Проверка на требование подписания титула покупателя у документа.

Параметры:

  • documentRef - recordRef документа по которому требуется проверка

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"isNeedSignTitle",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
generateBuyerTitle — генерация xml титула покупателя для документа

Генерация xml титула покупателя для документа.

Параметры:

  • documentRef – recordRef документа по которому требуется генерация титула покупателя

  • signerName - имя пользователя, который будет подписывать титул покупателя

  • factArrivalDate - фактическая дата передачи товара в формате ГГГГ-ММ-ДД

  • comment - комментарий

  • data - дополнительные данные запроса на генерацию титула, передаются провайдеру (Опционально)

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateBuyerTitle",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "signerName":"admin",
                    "factArrivalDate":"2023-09-08",
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
sendEdiXml — отправка EDI-сообщения провайдеру

Отправка EDI-сообщения (например, ORDERS или DESADV) провайдеру. Содержимое документа отправляется как есть. Реализовано для Контур.EDI (providerType — KONTUR).

Параметры:

  • documentRef - recordRef документа с XML EDI-сообщения

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendEdiXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
sendSignedEdiXml — отправка подписанного EDI-сообщения провайдеру

Отправка EDI-сообщения вместе с подписью. На текущий момент коннекторами провайдеров не поддерживается.

Параметры:

  • documentRef - recordRef подписанного документа с XML EDI-сообщения

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendSignedEdiXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
generateReceiptXml — генерация xml извещения о получении для документа

Генерация xml извещения о получении для документа.

Параметры:

  • documentRef – recordRef документа по которому требуется генерация извещения о получении

  • signerName - имя пользователя, который будет подписывать извещение о получении

  • signerPosition - должность пользователя

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateReceiptXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "signerName":"admin",
                    "signerPosition":"DirectorTest"
                }

    });
var res = await rec.save("?json");
generateReceiptsXml — генерация xml извещения о получении для документов

Генерация xml извещения о получении для документов.

Параметры:

  • documentRefs – recordRef документов по которым требуется генерация извещения о получении

  • signerName - имя пользователя, который будет подписывать извещение о получении

  • signerPosition - должность пользователя

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateReceiptsXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ],
                    "signerName":"admin",
                    "signerPosition":"DirectorTest"
                }

    });
var res = await rec.save("?json");
sendReceiptsXml — отправка подписанного xml извещения о получении для документов

Отправка подписанного xml извещения о получении для документов.

Параметры:

  • documentRefs - recordRef документов по которым требуется отправка извещения о получении

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendReceiptsXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRefs":[
                                    "emodel/edi-document@ref1",
                                    "emodel/edi-document@ref2"
                                    ]
                }

    });
var res = await rec.save("?json");
sendReceiptXml — отправка подписанного xml извещения о получении для документа

Отправка подписанного xml извещения о получении для документа (Оптимизируется в дальнейшем).

Параметры:

  • documentRef - recordRef документа по которому требуется отправка извещения о получении

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendReceiptXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1"
                }

    });
var res = await rec.save("?json");
generateUniversalMessageXml — генерация xml универсального сообщения для документа

Генерация xml универсального сообщения по документу. Возвращается recordRef сохранённого универсального сообщения.

Параметры:

  • documentRef - recordRef документа, по которому формируется сообщение

  • universalMessageCode - тип сообщения: Receipt (извещение о получении), AmendmentRequest (уведомление об уточнении), Rejection (отказ), InformationMessage (информационное сообщение)

  • sender - сведения об отправителе: firstName, lastName, middleName, position

  • receiver - сведения о получателе: firstName, lastName, middleName, position

  • comment - комментарий (Опционально)

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"generateUniversalMessageXml",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-document@ref1",
                    "universalMessageCode":"Rejection",
                    "sender": {
                        "firstName":"Иван",
                        "lastName":"Иванов",
                        "middleName":"Иванович",
                        "position":"Бухгалтер"
                    },
                    "receiver": {
                        "firstName":"Пётр",
                        "lastName":"Петров",
                        "middleName":"Петрович",
                        "position":"Менеджер"
                    },
                    "comment":"Test comment"
                }

    });
var res = await rec.save("?json");
sendUniversalMessage — отправка универсального сообщения провайдеру

Отправка провайдеру универсального сообщения, сформированного запросом generateUniversalMessageXml.

Параметры:

  • documentRef - recordRef универсального сообщения

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"sendUniversalMessage",
                "providerType":"KONTUR",
                "requestData": {
                    "documentRef":"emodel/edi-universal-message-xml@ref1"
                }

    });
var res = await rec.save("?json");
addDocumentsToSystemPackage — добавление документа в системный пакет edi-package

Добавление документов в системный пакет. В параметры передаются ref пакета и список документов. Если packageRef не указан, сервис сначала ищет существующий черновик среди пакетов подходящих документов. Черновиком считается пакет без статуса packageStatus. Если подходящего черновика нет и есть документы для добавления, создаётся новый пакет.

Можно передавать документы типа edi-document и его наследников, а также пользовательские документы других типов. Для пользовательского документа сервис создаёт или обновляет связанную запись edi-document через ассоциацию ediDoc:systemDocumentLink. Повторное добавление может использовать существующий черновик, создать новую копию для повторной отправки либо пропустить уже отправленный неизменённый документ. Новый раунд создаётся после отказа или ошибки доставки, а также при изменении содержимого ранее отправленного документа.

Прямая ссылка на edi-document, уже находящийся в пакете со статусом, пропускается. В выбранный пакет добавляются только подходящие документы, которые ещё к нему не относятся; дубли исключаются.

Параметры:

  • packageRef - recordRef ЭДО пакета, в который добавляются документы. Если null, сервис ищет подходящий черновик и при необходимости создаёт новый пакет

  • documentRefs – документы добавляемые в пакет

В поле data ответа возвращается recordRef пакета. Если пакет не указан, подходящий черновик не найден и нет документов для добавления, возвращается пустая ссылка.

var rec = Records.get('edi/edi-action@');
rec.att("_self", {
                "requestType":"addDocumentsToSystemPackage",
                "providerType":"KONTUR",
                "requestData": {
                        "packageRef":"emodel/edi-package@packageId", // null — поиск подходящего черновика или создание нового пакета
                        "documentRefs":["emodel/doc-type@doc-id"] // список документов для добавления в системный edi пакет
                }
});
var resp = await rec.save("?json");