Exportcenter:AttachAccountingDocuments:v2.3

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску

Общие сведения

Операция AttachAccountingDocuments предназначена для подачи сведений о документах в контексте заявок ВБР и ЛИ.

Требования к подписи заявления (УКЭП) и машиночитаемым доверенностям (МЧД)

Требования к УКЭП и МЧД, а также правила их валидации при обработке заявлений описаны здесь: Exportcenter:ApplicationManagementService:Signature.

Ограничения для выполнения запроса

При выполнении операции AttachAccountingDocuments контролируется текущий статус указанной в запросе заявки, в таблице ниже приведены статусы, предполагающие возможность выполнения операции:

Статус заявки Какие необязательные теги

допустимо передавать для этого статуса

Описание
WAITING_DATA_FOR_CONTRACT <exc:contractApplication>
WAITING_SIGN_CONTRACT <exc:attachedDocument> Должны быть переданы файлы с типом 47 и 50
WAITING_PREPAYMENT <exc:invoicePaymentInfo>
IN_PROGRESS <exc:invoicePaymentInfo>
WAITING_REWORK <exc:invoicePaymentInfo>
NEW_REVISION_RECEIVED <exc:invoicePaymentInfo>
RESEARCH_FINISHED <exc:invoicePaymentInfo>
WAITING_PAYMENT <exc:invoicePaymentInfo>
WAITING_CLOSING_ACT <exc:invoicePaymentInfo>
<exc:acceptanceStatementInfo>
<exc:attachedDocument>
Может быть передан файл с типом 48
ACT_RECEIVED <exc:invoicePaymentInfo>

Спецификация запроса

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <exc:attachAccountingDocumentsRequest>
002 ···<exc:metadata> exc:ServiceMetadata [1..1] 1. Служебная информация
003 ······<exc:processID>?</exc:processID> bs:Identifier [1..1] 1.1. Идентификатор процесса в ИС Одно окно РЭЦ
004 ······<exc:seqNumber>?</exc:seqNumber> bs:SequenceNumber [1..1] 1.2. Порядковый номер запроса
005 ······<exc:documentID>?</exc:documentID> bs:UUID [1..1]

1.5. Идентификатор заявления в ВетИС

  • Указывается идентификатор заявки на услугу (ВБР, ЛИ), в контексте которой передаются сведения
006 ······<dt:businessEntity> dt:BusinessEntity [1..1] 1.4. Сведения о хозяйствующем субъекте-заявителе
007 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] 1.4.1. Глобальный идентификатор записи
008 ·········<dt:inn>?</dt:inn> bs:String255 [1..1] 1.4.2. ИНН хозяйствующего субъекта
009 ······</dt:businessEntity>
010 ···</exc:metadata>
011 ···<exc:invoicePaymentInfo> exc:ExcInvoicePayment [0..1]

2. Сведения об оплате счета

  • Обязательно в случае передачи сведений об оплате
  • При заполнении сведений в п. 2 сведения в п. 3, 4, 5 не заполняются
012 ······<exc:paymentOrderNumber>?</exc:paymentOrderNumber> bs:String255 [1..1] 2.1. Номер платежного поручения
013 ······<exc:paymentDate>?</exc:paymentDate> xs:date [1..1] 2.2. Дата приема поручения к исполнению
014 ······<exc:paymentPurpose>?</exc:paymentPurpose> bs:String255 [1..1]

2.3. Назначение платежа

  • Max длина 210 символов
015 ···</exc:invoicePaymentInfo>
016 ···<exc:acceptanceStatementInfo> exc:ExcAcceptanceCertificate [0..1]

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

  • Обязательно в случае передачи сведений об отказе в подписании
  • При заполнении сведений в п. 3 сведения в п. 2, 4, 5 не заполняются
017 ······<exc:refusalReason>?</exc:refusalReason> exc:ExcRefusalSigningReason [1..1]

3.1. Причина отказа

  • EXPIRED_SIGNING_DATE - Вышел срок подписания акта
  • SERVICE_CLAIMS - Имеются претензии к предоставленным услугам
018 ···</exc:acceptanceStatementInfo>
019 ···<exc:contractApplication> exc:ExcContractApplication [0..1]

4. Сведения для заключения договора

  • Договор на оказание услуг по выдаче заключения заключается:
    • для ВБР: между учреждением, указанным в laboratory, и заявителем, указанным в metadata/businessEntity исходной заявки, переданной в операции 9.1
  • При заполнении сведений в п. 4 сведения в п. 2, 3, 5 не заполняются
020 ······<exc:businessEntity> dt:BusinessEntity [0..1] Сведения о заказчике
021 ········<dt:kpp>?</dt:kpp> bs:String255 [0..1]

4.4.2. КПП

  • Обязательный для юр.лиц, необязательный для ИП
022 ········<dt:ogrn>?</dt:ogrn> bs:String255 [1..1]

4.4.1. ОГРН / ОГРНИП

  • 13 или 15 (ИП) символов
023 ······</exc:businessEntity>
024 ······<exc:bankAccountDetails> dt:BankAccountDetails [1..1] 4.5. Сведения для расчетов
025 ·········<dt:paymentAccountNumber>?</dt:paymentAccountNumber> dt:BankAccountNumber [1..1]

4.5.1. Расчетный счет

  • 20 символов
026 ·········<dt:correspondentAccountNumber>?</dt:correspondentAccountNumber> dt:BankAccountNumber [1..1]

4.5.2. Корреспондентский счет

  • 20 символов
027 ·········<dt:BIC>?</dt:BIC> dt:BankIdentificationNumber [1..1]

4.5.3. БИК

  • 9 символов
028 ·········<dt:bankName>?</dt:bankName> bs:String255 [1..1] 4.5.4. Наименование банка
029 ······</exc:bankAccountDetails>
030 ······<exc:postAddress> dt:Address [1..1] Почтовый адрес
031 ·········<dt:addressView>?</dt:addressView> bs:NText [1..1] 4.3. Строковое представление адреса
032 ······</exc:postAddress>
033 ······<exc:definedContact> exc:ExcDefinedContact [1..1]

4.6. Контактные данные

  • Данные, которые будут указаны в договоре
034 ·········<exc:email>?</exc:email> bs:String255 [1..1] 4.6.1. E-mail контактного лица
035 ·········<exc:phone>?</exc:phone> bs:String255 [1..1] 4.6.2. Номер телефона контактного лица
036 ······</exc:definedContact>
037 ······<exc:authorizedPerson> vd:User [1..1] 4.1. Уполномоченное лицо заказчика
038 ·········<vd:fio>?</vd:fio> bs:String255 [1..1] 4.1.1. ФИО
039 ·········<vd:post>?</vd:post> bs:String255 [1..1] 4.1.2. Должность
040 ······</exc:authorizedPerson>
041 ······<exc:attachedDocument> exc:ExcAttachedDocument [1..1] 4.2. Основание права подписи уполномоченного лица
042 ·········<exc:includedFile> exc:ExcDocumentFile [1..1]

4.2.1. Вложения

  • Файл может быть передан двумя способами:
    • Загружен в хранилище операцией uploadAttachmentRequest - в этом случае в запросе должны быть переданы:
      • fileName
      • mimeCode
      • fileSize (опционально)
      • fileDigest
      • referenceId
    • Файл передается в запросе в формате base64 - в этом случае в запросе должны быть переданы:
      • fileName
      • mimeCode
      • binaryData
  • Допустимые форматы: pdf
  • Максимально допустимый размер одного файла — 5МБ
043 ············<exc:fileName>?</exc:fileName> bs:String255 [1..1] 4.2.1.1. Имя файла
044 ············<exc:mimeCode>?</exc:mimeCode> xs:token [1..1] 4.2.1.2. MIME-код файла
045 ············<exc:encoding>?</exc:encoding> xs:token [0..1]

4.2.1.4. Кодировка файла, представленного в бинарном виде

  • По умолчанию значение UTF-8
046 ············<exc:fileSize>?</exc:fileSize> xs:nonNegativeInteger [0..1]

4.2.1.3. Размер файла в байтах

  • Может быть передан опционально для дополнительной идентификации файла, если он был загружен в хранилище операцией uploadAttachmentRequest
047 ············<exc:fileDigest algorithmId="?">?</exc:fileDigest> exc:ExcFileDigest [0..1]

4.2.1.5. Хеш-значение для файла в соответствии с указанным алгоритмом

  • Обязательно, если передан referenceId (файл загружен в хранилище операцией uploadAttachmentRequest)
  • Алгоритм указывается в атрибуте тега, список поддерживаемых алгоритмов:
    • GOST3411-2012.256
    • GOST3411-2012.512
    • SHA-1
    • SHA-256
048 ············<exc:referenceId>?</exc:referenceId> exc:ExcDocumentFileReference [0..1]

4.2.1.6. Ссылка или идентификатор файла в хранилище

  • Обязательно, если файл загружен в хранилище операцией uploadAttachmentRequest
049 ············<exc:binaryData>?</exc:binaryData> exc:ExcDocumentBinaryData [0..1]

4.2.1.7. Содержимое файла в формате base64

  • Обязательно, если файл не загружался в хранилище операцией uploadAttachmentRequest
050 ·········</exc:includedFile>
051 ······</exc:attachedDocument>
052 ···</exc:contractApplication>
053 ···<exc:attachedDocument> exc:ExcAttachedDocument [0..*]

5. Сведения о прикрепленных документах

  • При заполнении сведений в п. 5 сведения в п. 2, 3, 4 не заполняются
054 ······<vd:type>?</vd:type> dt:DocumentType [1..1]

5.1. Тип документа

  • 47 - Договор (документ из пакета документов к договору)
  • 48 - Акт выполненных работ
  • 50 - Договор с визуализацией подписей УКЭП
  • Типы 47 и 50 могут передаваться в запросе только совместно, отдельная передача запрещена
055 ······<exc:includedFile> exc:ExcDocumentFile [1..*]

5.2. Вложение (прикрепленный документ)

  • Файл может быть передан двумя способами:
    • Загружен в хранилище операцией uploadAttachmentRequest - в этом случае в запросе должны быть переданы:
      • fileName
      • mimeCode
      • fileSize (опционально)
      • fileDigest (обязательно, если отсутствует signature)
      • referenceId
      • signature (обязательно для подписываемых документов)
    • Файл передается в запросе в формате base64 - в этом случае в запросе должны быть переданы:
      • fileName
      • mimeCode
      • binaryData
      • signature (обязательно для подписываемых документов)
  • Допустимые форматы: .pdf, xml
  • Максимально допустимый размер одного файла — 5МБ
  • При наличии МЧД - ее передача обеспечивается отдельным бинарным вложением внутри передаваемого документа
056 ·········<exc:fileName>?</exc:fileName> bs:String255 [1..1] 5.2.1. Имя файла
057 ·········<exc:mimeCode>?</exc:mimeCode> xs:token [1..1]

5.2.2. MIME-код файла

  • Для МЧД в формате XML значение - application/x.power-of-attorney+xml
  • Для файлов .pdf значение - application/pdf
058 ·········<exc:encoding>?</exc:encoding> xs:token [0..1]

5.2.4. Кодировка файла, представленного в бинарном виде

  • По умолчанию значение UTF-8
  • Обязательно при передаче МЧД
059 ·········<exc:fileSize>?</exc:fileSize> xs:nonNegativeInteger [0..1]

5.2.3. Размер файла в байтах

  • Может быть передан опционально для дополнительной идентификации файла, если он был загружен в хранилище операцией uploadAttachmentRequest
060 ·········<exc:fileDigest algorithmId="?">?</exc:fileDigest> exc:ExcFileDigest [0..1]

5.2.5. Хеш-значение для файла в соответствии с указанным алгоритмом

  • Обязательно, если передан referenceId (файл загружен в хранилище операцией uploadAttachmentRequest)
  • Алгоритм указывается в атрибуте тега, список поддерживаемых алгоритмов:
    • GOST3411-2012.256
    • GOST3411-2012.512
    • SHA-1
    • SHA-256
061 ·········<exc:referenceId>?</exc:referenceId> exc:ExcDocumentFileReference [0..1]

5.2.6. Ссылка или идентификатор файла в хранилище

  • Обязательно, если файл загружен в хранилище операцией uploadAttachmentRequest
062 ·········<exc:binaryData>?</exc:binaryData> exc:ExcDocumentBinaryData [0..1]

5.2.7. Содержимое файла в формате base64

  • Обязательно, если файл не загружался в хранилище операцией uploadAttachmentRequest
063 ·········<exc:signature>?</exc:signature> exc:ExcDocumentBinaryData [0..*]

5.2.8. Открепленная подпись файла

  • Обязательно для типов документов 47, 48
  • Опционально для МЧД
064 ······</exc:includedFile>
065 ···</exc:attachedDocument>
066 ···<exc:additionalProperties> exc:ExcAdditionalAttributeList [1..1] Дополнительные опции запроса
067 ······<exc:additionalAttribute> exc:ExcAdditionalAttribute [1..1] 1.6. Дополнительный атрибут
068 ·········<exc:attrID>OPERATION_CONTEXT</exc:attrID> bs:Identifier [1..1] Идентификатор атрибута - Контекст операции (тип процесса)
069 ·········<exc:attrValue>?</exc:attrValue> bs:Text [1..1]

1.6. Значение атрибута

  • WBR - ВБР
  • LAB_RESEARCH - ЛИ
070 ······</exc:additionalAttribute>
071 ···</exc:additionalProperties>
072 </exc:attachAccountingDocumentsRequest>

Спецификация ответа

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <exc:attachAccountingDocumentsResponse>
002 ···<exc:metadata> exc:ServiceMetadata [1..1] 1. Служебная информация
003 ······<exc:processID>?</exc:processID> bs:Identifier [1..1] 1.3. Идентификатор процесса в ИС Одно окно РЭЦ
004 ······<exc:seqNumber>?</exc:seqNumber> bs:SequenceNumber [1..1] 1.4. Порядковый номер запроса
005 ······<exc:documentID>?</exc:documentID> bs:UUID [1..1] 1.1. Идентификатор документа/заявления, зарегистрированного в ВетИС
006 ······<exc:documentNumber>?</exc:documentNumber> xs:token [1..1] 1.2. Человекочитаемый номер документа/заявления, зарегистрированного в ВетИС
007 ···</exc:metadata>
008 </exc:attachAccountingDocumentsResponse>