Как отправить и получить акт об установленном расхождении ТОРГ-2 в рекомендованном ФНС формате

Сценарий работы с актом об установленном расхождении ТОРГ-2

  1. Покупатель формирует файл титула покупателя, подписывает и направляет продавцу.

  2. Продавец получает титул покупателя акта о расхождениях, подписанный и отправленный покупателем.

  3. Продавец формирует файл титула доп сведений, подписывает своей ЭП и отправляет в адрес покупателя.

Формирование файла титула покупателя для акта об установленном расхождении ТОРГ-2

Cгенерировать файл титула, соответствущий утвержденному формату, можно с помощью метода GenerateTitleXml. Для этого передайте в метод следующие параметры:

  • documentTypeNamedId — тип документа;

  • documentFunction — функция документа;

  • documentVersion — версия документа;

  • titleIndex — идентификатор титула документа.

В теле запроса нужно передать XML-файл UserDataXsd, соответствующий XSD-схеме. UsedDataXsd содержит информацию для генерации титула, которую может заполнить только пользователь.

Получить тип, функцию, версию, идентификатор титула и ссылку на скачивание XSD-схемы можно с помощью метода GetDocumentTypes. В ответе метод возвращает описание всех типов документов, доступных в ящике.

Ниже приведено тело ответа метода GetDocumentTypes. Для упрощения из него удалены другие типы, функции, версии и информация о метаданных.

{
  "Name": "Torg2",
  "Title": "Акт об установленном расхождении ТОРГ-2",
  "SupportedDocflows": [
    0
  ],
  "RequiresFnsRegistration": true,
  "Functions": [
      {
      "Name": "NoAdditionalInfo",
      "Versions": [
        {
          "Version": "torg2_05_01_01",
          "SupportsContentPatching": true,
          "SupportsEncrypting": false,
          "SupportsPredefinedRecipientTitle": false,
          "SupportsAmendmentRequest": true,
          "Titles": [
            {
              "Index": 0,
              "IsFormal": true,
              "XsdUrl": "/GetContent?typeNamedId=Torg2&function=NoAdditionalInfo&version=torg2_05_01_01&titleIndex=0&contentType=TitleXsd",
              "UserDataXsdUrl": "/GetContent?typeNamedId=Torg2&function=NoAdditionalInfo&version=torg2_05_01_01&titleIndex=0&contentType=UserContractXsd",
              "SignerInfo": {
                "SignerType": 2,
                "ExtendedDocumentTitleType": 9
              },
              "MetadataItems": [],
              "EncryptedMetadataItems": []
            }
         ],
         "IsActual": true,
          "Workflows": [
            {
             "Id": 1,
              "IsDefault": true
            }
          ]
        }
      ]
    },
    {
      "Name": "WithAdditionalInfo",
      "Versions": [
        {
          "Version": "torg2_05_01_01",
          "SupportsContentPatching": true,
          "SupportsEncrypting": false,
          "SupportsPredefinedRecipientTitle": false,
          "SupportsAmendmentRequest": true,
          "Titles": [
            {
              "Index": 0,
              "IsFormal": true,
              "XsdUrl": "/GetContent?typeNamedId=Torg2&function=WithAdditionalInfo&version=torg2_05_01_01&titleIndex=0&contentType=TitleXsd",
              "UserDataXsdUrl": "/GetContent?typeNamedId=Torg2&function=WithAdditionalInfo&version=torg2_05_01_01&titleIndex=0&contentType=UserContractXsd",
              "SignerInfo": {
                "SignerType": 2,
                "ExtendedDocumentTitleType": 9
              },
              "MetadataItems": [],
              "EncryptedMetadataItems": []
            },
            {
              "Index": 1,
              "IsFormal": true,
              "XsdUrl": "/GetContent?typeNamedId=Torg2&function=WithAdditionalInfo&version=torg2_05_01_01&titleIndex=1&contentType=TitleXsd",
              "UserDataXsdUrl": "/GetContent?typeNamedId=Torg2&function=WithAdditionalInfo&version=torg2_05_01_01&titleIndex=1&contentType=UserContractXsd",
              "SignerInfo": {
                "SignerType": 2,
                "ExtendedDocumentTitleType": 10
              },
              "MetadataItems": [],
              "EncryptedMetadataItems": []
            }
          ],
          "IsActual": true,
          "Workflows": [
            {
              "Id": 3,
              "IsDefault": true
            }
          ]
        }
      ]
    }
  ]
}

  • documentTypeNamedId = Torg2 — имя типа документа,

  • documentFunction = NoAdditionalInfo — функция для однотитульного документа, WithAdditionalInfo — функция для двухтитульного,

  • documentVersion = torg2_05_01_01 — версия формата,

  • titleIndex = 0 — титул покупателя,

  • UserDataXsdUrl — URL-путь метода, возвращающего файл XSD-схемы контракта для генерации титула с помощью метода генерации.

Отправка файла титула покупателя для акта об установленном расхождении ТОРГ-2

Полученный XML-файл титула покупателя можно отправить с помощью метода PostMessage.

В теле запроса метода передайте структуру MessageToPost, заполненную следующими данными:

  • в поле FromBoxId укажите идентификатор ящика отправителя;

  • в поле ToBoxId укажите идентификатор ящика получателя;

  • для передачи XML-файла титула покупателя акта ТОРГ-2 используйте вложенную структуру DocumentAttachment:

    • XML-файл передайте в поле Content структуры SignedContent, подпись — в поле Signature;

    • TypeNamedId=Torg2;

    • поле Function зависит от элемента ИнфДопСв:

      • Если ИнфДопСв=1, укажите значение Function=NoAdditionalInfo,

      • Если ИнфДопСв принимает другое значение, укажите Function=WithAdditionalInfo.

    • Version=torg2_05_01_01.

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

"FromBoxId": "db32772b-9256-49a8-a133-fda593fda38a",
"ToBoxId": "13254c42-b4f7-4fd3-3324-0094aeb0f15a",
"DocumentAttachments": [
        {
            "SignedContent":
            {
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+",        //контент xml-файла в кодировке base-64
                "Signature": "MIIN5QYJKoZIhvcNAQcCoIIN1jCCDdIA...kA9MJfsplqgW",       //контент файла подписи в кодировке base-64
            },
            "TypeNamedId": "Torg2",
            "Function": "WithAdditionalInfo",
            "Version": "torg2_05_01_01"
        }
    ]
}

После отправки в теле ответа будет содержаться отправленное сообщение, сериализованное в протобуфер Message.

Все дальнейшие действия происходят на стороне продавца.

Поиск акта об установленном расхождении ТОРГ-2

Чтобы найти все входящие акты ТОРГ-2, которые нужно обработать, используйте метод GetDocuments:

  • в поле boxId укажите идентификатор ящика, в котором нужно найти входящие документы;

  • в поле filterCategory укажите статус и тип документа: Torg2.InboundNotFinished.

Пример запроса на получение акта ТОРГ-2:

GET /V3/GetDocuments?filterCategory=XmlTorg2.InboundNotFinished&boxId=db32772b-9256-49a8-a133-fda593fda38a HTTP/1.1
Host: diadoc-api.kontur.ru
Accept: application/json
Content-Type: application/json charset=utf-8
Authorization: DiadocAuth ddauth_api_client_id={{ключ разработчика}}, ddauth_token={{авторизационный токен}}

В теле ответа вернется список документов в виде структуры DocumentList с вложенной структурой Document. Чтобы получить документы, потребуются значения полей MessageId и EntityId.

Получение акта об установленном расхождении ТОРГ-2

Найденный документ можно получить с помощью метода GetMessage. В запросе передайте параметры, вернувшиеся в теле ответа метода GetDocuments: boxId, messageId, entityId.

Пример запроса на получение акта об установленном расхождении ТОРГ-2:

GET /V3/GetMessage?messageId=bbcedb0d-ce34-4e0d-b321-3f600c920935&entityId=30cf2c07-7297-4d48-bc6f-ca7a80e2cf95&boxId=db32772b-9256-49a8-a133-fda593fda38a HTTP/1.1
Host: diadoc-api.kontur.ru
Accept: application/json
Content-Type: application/json charset=utf-8
Authorization: DiadocAuth ddauth_api_client_id={{ключ разработчика}}, ddauth_token={{авторизационный токен}}

Формирование файла титула доп. сведений для акта об установленном расхождении ТОРГ-2

Генерация титула с помощью метода GenerateTitleXml выполняется аналогично титулу покупателя.

Тип и версия файла такие же, как у титула покупателя, отличается номер титула, также возможна только одна функция:

  • documentTypeNamedId = Torg2 — имя типа документа,

  • documentFunction = WithAdditionalInfo — функция документа,

  • documentVersion = torg2_05_01_01 — версия формата,

  • titleIndex = 1 — титул доп. сведений.

Отправка файла титула доп. сведений для акта об установленном расхождении ТОРГ-2

Отправить сформированный титул доп. сведений акта ТОРГ-2 можно с помощью метода PostMessagePatch.

В теле запроса метода передайте структуру MessagePatchToPost, заполненную следующими данными:

  • в поле BoxId укажите идентификатор ящика, в котором находится исходное сообщение,

  • в поле MessageId укажите идентификатор сообщения, к которому относится дополнение,

  • чтобы передать XML-файла титула, используйте структуру RecipientTitleAttachment:

    • ParentEntityId — идентификатор титула покупателя,

    • XML-файл нужно передать в поле Content вложенной структуры SignedContent, подпись — в поле Signature.

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

"BoxId": "db32772b-9256-49a8-a133-fda593fda38a",
"MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
"RecipientTitles":
[
    {
        "ParentEntityId":"30cf2c07-7297-4d48-bc6f-ca7a80e2cf95",
        "SignedContent":
        {
            "Content": "PD94bWwgdmVyc2l...LDQudC7Pg==",        //контент xml-файла в кодировке base-64
            "Signature": "MIIN5QYJKoZIhvc...KsTM6zixgz"        //контент файла подписи в кодировке base-64
        }
    }
]
}

После отправки в теле ответа будет содержаться отправленное дополнение, сериализованное в протобуфер MessagePatch.