Служебный документ
Служебный документ — это технологическая сущность внутри сообщения, которая добавляется в цепочку документооборота помимо пользовательских документов. Является одним из видов документов в сообщении.
В Диадоке существуют следующие виды служебных документов:
подтверждение оператора,
документ для отмены сведений об отгрузке маркированных товаров.
Подробное описание каждого вида служебного документа представлено ниже.
Извещение о получении (ИоП)
Извещение о получении — это подтверждение того, что документ получен второй стороной документооборота.
В зависимости от вида документооборота ИоП может быть обязательным, требуемым по запросу или недопустимым. Определить обязательность извещения можно по полям TitleReceiptBehavior и AmendmentRequestResponseBehavior в структуре DocumentWorkflowSettingsV2.
Если вид документооборота предполагает ИоП по запросу, то отправитель сам определяет, запрашивать ли у получателя подтверждение получения документа. В этом случае управлять обязательностью ИоП можно с помощью признака NeedReceipt в структуре DocumentAttachment или RecipientTitleAttachment.
Проверить необходимость в извещении для конкретного документа можно по его статусу — инструкция доступна на странице Работа со статусами документа.
Чтобы подтвердить получение документа с помощью ИоП, воспользуйтесь инструкциями Генерация извещения о получении и Отправка извещения о получении.
Уведомление об уточнении (УоУ)
Уведомление об уточнении — это запрос на исправление или корректировку документа. Уточнение может потребоваться в случае, если получатель нашел в документе ошибки.
В зависимости от сути ошибки отправитель исходного сообщения будет должен сформировать ответный документ с новым типом:
корректировка (КСФ, УКД) — если в документе была неправильно указана стоимость или количество товаров или услуг;
исправление (ИСФ, ИУПД) — при других ошибках в документе: опечатки, неверные реквизиты или данные товаров или услуг.
Не для всех типов документов доступно УоУ. Определить возможность запросить уточнение можно по полю SupportsAmendmentRequest в структуре DocumentVersionV2.
Чтобы запросить исправление или корректировку документа, воспользуйтесь инструкциями Генерация уведомления об уточнении и Отправка уведомления об уточнении.
Предложение об аннулировании (ПоА)
Предложение об аннулировании — служебный документ, который используется для признания ранее подписанного электронного документа недействительным.
Если документ требует ответного действия (подписания, отправки ИоП или ответного титула), а получатель еще не выполнил его, то отправитель может аннулировать документ в одностороннем порядке. В этом случае согласие контрагента не требуется, а отправка подписанного ПоА сразу приводит к аннулированию документа. Исключением является роуминг: если документ отправлен другому оператору ЭДО, то аннулировать такой документ в одностороннем порядке нельзя.
Если документ был отправлен в роуминге или контрагент уже обработал полученный документ, то аннулирование возможно только по соглашению обеих сторон. В этом случае инициатор должен отправить ПоА, а вторая сторона отправить ответную подпись на запрос об аннулировании. Только ответная подпись контрагента приводит к аннулированию документа. В аннулировании можно отказать, и тогда документ останется действующим — подробнее в разделе Отказ в подписи.
При состоявшемся аннулировании документ теряет юридическую силу. Отменить аннулирование невозможно.
Чтобы аннулировать документ, воспользуйтесь инструкциями Генерация предложения об аннулировании и Отправка предложения об аннулировании.
Отказ в подписи
Отказ в подписи позволяет отклонить поступивший документ или предложение об аннулировании документа.
Если документ подразумевает двустороннюю подпись или отправитель запросил подпись на отправленный документ, а получатель не согласен с содержимым этого документа, то получатель может отказаться от подписи. В этом случае документооборот будет завершен, а электронный документ не вступит в силу.
Определить необходимость в отправке ответной подписи можно по статусу документа — инструкция доступна на странице Работа со статусами документа.
Если контрагент запросил аннулирование документа, а получатель не согласен с этим, то получатель может отклонить предложение об аннулировании. В этом случае документ останется действительным.
Чтобы отказаться от подписи документа или предложения об аннулировании, воспользуйтесь инструкциями Генерация отказа от подписи и отказа от предложения об аннулировании и Отправка отказа от подписи и отказа от предложения об аннулировании.
Универсальное сообщение (УС)
Универсальное сообщение — это XML-файл установленного формата, с помощью которого участники документооборота могут информировать друг друга о получении документа, об ошибках или других событиях, имеющих отношение к документообороту. Он вводится изменениями в приказ Минфина от 05.02.2021 N 14Н (подробнее на сайте Диадока).
УС представляет собой сущность, которая может заменить ИоП, УоУ или отказ в подписи.
Примечание
После окончания переходного периода универсальные сообщения полностью заменят текущие извещение о получении, уведомление об уточнении и отказ в подписи — обмен этими служебными документами после указанной даты будет невозможен.
Главным свойством УС является его код, который указывает, какие функции оно выполняет в сообщении:
1999 — извещение о получении,
2999 — уведомление об уточнении,
3999 — отказ в подписи,
4002 — дополнительная информация к документу.
Отличия УС от текущих форматов служебных документов — ИоП, УоУ и отказа в подписи:
УС не нужно подписывать сертификатом электронной подписи,
на УС не формируются подтверждения оператора,
в УС можно указать комментарий.
Чтобы отправить УС, воспользуйтесь инструкциями Генерация универсального сообщения и Отправка универсального сообщения.
См. также
- Представление в API:
CorrectionRequestAttachment — данные уведомления об уточнении в отправляемом дополнении к сообщению
ReceiptAttachment — данные извещения о получении документа в отправляемом дополнении к сообщению
RevocationRequestAttachment — данные предложения об аннулировании документа в отправляемом дополнении к сообщению
UniversalMessageAttachment — данные универсального сообщения в отправляемом дополнении к сообщению
XmlSignatureRejectionAttachment — данные отказа от предложения об аннулировании документа или отказа в подписи под документом в отправляемом дополнении к сообщению
- Инструкции:
- Методы для работы со служебными документами:
GenerateInvoiceCorrectionRequestXml (V2) — генерирует файл уведомления об уточнении
GenerateReceiptXml (V2) — генерирует файл извещения о получении
GenerateRevocationRequestXml (V2) — генерирует файл предложения об аннулировании
GenerateSignatureRejectionXml (V2) — генерирует файл отказа в подписи
GenerateTtGisFixationCancellationRequest — генерирует документ для отмены сведений об отгрузке маркированных товаров
GenerateUniversalMessage — генерирует файл универсального сообщения
ParseRevocationRequestXml — парсит файл предложения об аннулировании
ParseSignatureRejectionXml — парсит файл отказа в подписи
ParseUniversalMessage — парсит файл универсального сообщения
ParseUniversalMessageXml — парсит файл универсального сообщения