Перейти к содержанию

3.15 Операции над объектами

Используется с версии 5.1.1

SendOperation


Выполняет указанную операцию с объектами учета − спецификациями, квитанциями, актами ввода в оборот, актами инвентаризации. Используется взамен устаревших методов SendBuyingupAction, SendSpecificationOperation. Каждый документ в пакете обрабатывается в отдельной транзакции.

Параметры запроса:

Название параметра Описание
CallerSignature Электронная подпись участника. Подписан Request Data
TestMessage Признак тестового запроса
OGRN ОГРН организации
IDTOP* Идентификационный код (филиала) организации в ГИИС ДМДК
RequestData.operation Операция над объектом учета

* − используется с версии 5.1. Заполняется при регистрации головной организацией фактов оборота, произошедших в ТОП этой организации, с использованием сертификата автоматизированной системы (обезличенного), загруженного в профиль информационного обмена головной организации.

Параметры ответа:

Название параметра Описание
DmdkSignature Электронная подпись ГИИС ДМДК
ResponseData.messageId Уникальный идентификатор запроса (UUID). Заполняется в случае успешной регистрации запроса
ResponseData.status Статус запроса
ResponseData.error Сообщение об ошибке. Заполняется в случае некорректной регистрации запроса.
Пример XML - отправка спецификации
Запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns1="urn://xsd.dmdk.goznak.ru/common/3.0">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:SendOperationRequest>
      <ns:CallerSignature> ... подпись по стандарту XMLDSig ... </ns:CallerSignature>
      <ns:RequestData id="body">
        <!-- Отмена подписанной, но не принятой получателем, исходящей спецификации -->
        <ns:operation>
          <ns1:specification>
            <ns1:index>62d64361-e3b9-418f-8844-3d6714001f39</ns1:index>
            <ns1:id>T-00-000000099-24</ns1:id>
            <ns1:type>CANCEL</ns1:type>
          </ns1:specification>
        </ns:operation>
        <ns:operation>
          <!-- Удаление спецификации -->
          <ns1:specification>
            <ns1:index>3c956124-9aeb-4a30-abb7-32b4a4e8b941</ns1:index>
            <ns1:id>T-00-000000096-24</ns1:id>
            <ns1:type>DELETE</ns1:type>
          </ns1:specification>
        </ns:operation>
        <ns:operation>
          <!-- Возврат спецификации -->
          <ns1:specification>
            <ns1:index>f3a78ef8-2355-4154-905c-3d49d980f41a</ns1:index>
            <ns1:id>T-00-000000098-24</ns1:id>
            <ns1:type>RECOVER</ns1:type>
          </ns1:specification>
        </ns:operation>
        <!-- Отправка спецификации без подписи в рамках одной организации (внутреннее перемещение) -->
        <ns:operation>
          <ns1:specification>
            <ns1:index>74a8ed0f-c0b7-4fd7-b92d-019f99d98c59</ns1:index>
            <ns1:id>T-00-000000097-24</ns1:id>
            <ns1:type>SEND_INTERNAL</ns1:type>
          </ns1:specification>
        </ns:operation>
      </ns:RequestData>
    </ns:SendOperationRequest>
  </soapenv:Body>
</soapenv:Envelope>
Пример XML - операции с квитанциями на скупку/комиссию/изготовление/ремонт, залоговым билетом
Запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns1="urn://xsd.dmdk.goznak.ru/common/3.0">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:SendOperationRequest>
      <ns:CallerSignature> ... подпись по стандарту XMLDSig ... </ns:CallerSignature>
      <ns:RequestData id="body">
        <!-- Отменить взыскание по карточке залога -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>1</ns1:index>
            <ns1:id>P-02-000000226-23</ns1:id>
            <ns1:type>DS_BR_FORECLOSED_CANCEL</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Взять в залог по карточке залога  -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>2</ns1:index>
            <ns1:id>P-02-000000049-24</ns1:id>
            <ns1:type>DS_BR_PLEDGED</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Ввод в оборот по карточке залога -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>3</ns1:index>
            <ns1:id>P-02-000000044-24</ns1:id>
            <ns1:type>DS_BR_PUT_INTO_CIRCULATION</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Отменить ввод в оборот по карточке залога -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>4</ns1:index>
            <ns1:id>P-02-000000017-24</ns1:id>
            <ns1:type>DS_BR_PUT_INTO_CIRCULATION_CANCEL</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Погасить заём по карточке залога -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>5</ns1:index>
            <ns1:id>P-02-000000046-24</ns1:id>
            <ns1:type>DS_BR_REDEEMED</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Отменить погашение залога по карточке залога -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>6</ns1:index>
            <ns1:id>P-02-000000047-24</ns1:id>
            <ns1:type>DS_BR_REDEEMED_CANCEL</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Вернуть ценности по квитанции на комиссию -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>7</ns1:index>
            <ns1:id>P-02-000000203-23</ns1:id>
            <ns1:type>DS_BR_RETURNED</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Выдать изделия по квитанции на изготолвение -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>8</ns1:index>
            <ns1:id>P-02-000000238-23</ns1:id>
            <ns1:type>DS_BR_RETURNED_MANUFACTURING</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
        <!-- Выдать изделия по квитанции на ремонт -->
        <ns:operation>
          <ns1:buyingupReceipt>
            <ns1:index>9</ns1:index>
            <ns1:id>P-02-000000014-24</ns1:id>
            <ns1:type>DS_BR_RETURNED_REPAIR</ns1:type>
          </ns1:buyingupReceipt>
        </ns:operation>
      </ns:RequestData>
    </ns:SendOperationRequest>
  </soapenv:Body>
</soapenv:Envelope>
Пример XML - корректировка акта ввода в оборот
Запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns1="urn://xsd.dmdk.goznak.ru/common/3.0">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:SendOperationRequest>
      <ns:CallerSignature> ... подпись по стандарту XMLDSig ... </ns:CallerSignature>
      <ns:RequestData id="body">
        <ns:operation>
          <ns1:batchDocument>
            <ns1:index>001</ns1:index>
            <ns1:id>E-00-000000158-24</ns1:id>
            <ns1:type>CORRECTION</ns1:type>
          </ns1:batchDocument>
        </ns:operation>
        <ns:operation>
          <ns1:batchDocument>
            <ns1:index>002</ns1:index>
            <ns1:id>E-00-000000161-24</ns1:id>
            <ns1:type>CORRECTION</ns1:type>
          </ns1:batchDocument>
        </ns:operation>
      </ns:RequestData>
    </ns:SendOperationRequest>
  </soapenv:Body>
</soapenv:Envelope>
Пример XML - корректировка акта инвентаризации
Запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns1="urn://xsd.dmdk.goznak.ru/common/3.0">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:SendOperationRequest>
      <ns:CallerSignature> ... подпись по стандарту XMLDSig ... </ns:CallerSignature>
      <ns:RequestData id="body">
        <ns:operation>
          <ns1:inventory>
            <ns1:index>1</ns1:index>
            <ns1:id>E-00-000000174-24</ns1:id>
            <ns1:type>CORRECTION</ns1:type>
          </ns1:inventory>
        </ns:operation>
        <ns:operation>
          <ns1:inventory>
            <ns1:index>2</ns1:index>
            <ns1:id>E-00-000000317-23</ns1:id>
            <ns1:type>CORRECTION</ns1:type>
          </ns1:inventory>
        </ns:operation>
        <ns:operation>
          <ns1:inventory>
            <ns1:index>3</ns1:index>
            <ns1:id>E-00-000000319-23</ns1:id>
            <ns1:type>CORRECTION</ns1:type>
          </ns1:inventory>
        </ns:operation>
      </ns:RequestData>
    </ns:SendOperationRequest>
  </soapenv:Body>
</soapenv:Envelope>

CheckOperation


Метод возвращает результат обработки запроса SendOperation.

Параметры запроса:

Название параметра Описание
CallerSignature Электронная подпись участника. Подписан Request Data
TestMessage Признак тестового запроса
OGRN ОГРН организации
IDTOP* Идентификационный код (филиала) организации в ГИИС ДМДК
RequestData.messageId Уникальный идентификатор запроса (UUID)

* − заполняется тем же значением, что было указано в запросе SendOperation.

Параметры ответа:

Название параметра Описание
DmdkSignature Электронная подпись ГИИС ДМДК
ResponseData.messageId Уникальный идентификатор запроса (UUID). Заполняется в случае успешной регистрации запроса
ResponseData.status Статус запроса
ResponseData.error Сообщение об ошибке. Заполняется в случае возникновения ошибки в процессе обработки запроса.
ResponseData.success Учетные номера объектов, которые были успешно зафиксированы в Системе
ResponseData.success.result.index Порядковый номер в переданном пакете
ResponseData.success.result.id Учетный номер объекта в ГИИС ДМДК
ResponseData.success.result.newId Учетный номер объекта, образовавшегося в результате выполнения операции
ResponseData.failure Учетные номера объектов, которые не были приняты Системой с указанием причины
ResponseData.failure.result.index Порядковый номер в пакете
ResponseData.failure.result.id Учетный номер объекта в ГИИС ДМДК
ResponseData.failure.result.msg Ошибка
ResponseData.failure.result.error Полное описание ошибки
Пример XML - ответ на операции со спецификацией
Ответ:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <ns2:CheckOperationResponse xmlns:ns10="urn://xsd.dmdk.goznak.ru/buyingup/3.0" xmlns:ns11="urn://xsd.dmdk.goznak.ru/deal/3.0" xmlns:ns12="urn://xsd.dmdk.goznak.ru/specification/3.0" xmlns:ns13="urn://xsd.dmdk.goznak.ru/glossary/3.0" xmlns:ns14="urn://xsd.dmdk.goznak.ru/protocol-qca/3.0" xmlns:ns2="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns3="urn://xsd.dmdk.goznak.ru/act/3.0" xmlns:ns4="urn://xsd.dmdk.goznak.ru/contractor/3.0" xmlns:ns5="urn://xsd.dmdk.goznak.ru/batch/3.0" xmlns:ns6="urn://xsd.dmdk.goznak.ru/assayreceipt/3.0" xmlns:ns7="urn://xsd.dmdk.goznak.ru/types/3.0" xmlns:ns8="urn://xsd.dmdk.goznak.ru/document/3.0" xmlns:ns9="urn://xsd.dmdk.goznak.ru/batch-operation/3.0">
      <ns2:DmdkSignature> ... подпись по стандарту XMLDSig ... </ns2:DmdkSignature>
      <ns2:ResponseData id="responsedata">
        <ns2:messageId>1c1dba66-7d76-4411-839c-b22a1eccbe3f</ns2:messageId>
        <ns2:status>PREPARED</ns2:status>
        <ns2:success>
          <ns2:result>
            <ns2:index>62d64361-e3b9-418f-8844-3d6714001f39</ns2:index>
            <ns2:id>T-00-000000099-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>f3a78ef8-2355-4154-905c-3d49d980f41a</ns2:index>
            <ns2:id>T-00-000000098-24</ns2:id>
            <ns2:newId>T-00-000000100-24</ns2:newId>
          </ns2:result>
          <ns2:result>
            <ns2:index>74a8ed0f-c0b7-4fd7-b92d-019f99d98c59</ns2:index>
            <ns2:id>T-00-000000097-24</ns2:id>
          </ns2:result>
        </ns2:success>
        <ns2:failure>
          <ns2:result>
            <ns2:index>3c956124-9aeb-4a30-abb7-32b4a4e8b941</ns2:index>
            <ns2:id>T-00-000000096-24</ns2:id>
            <ns2:msg>Нельзя удалить. Этот документ прикреплен к другим объектам системы</ns2:msg>
            <ns2:error>
              <ns2:code>contentFileBindingExists</ns2:code>
              <ns2:msg>Нельзя удалить. Этот документ прикреплен к другим объектам системы</ns2:msg>
            </ns2:error>
          </ns2:result>
        </ns2:failure>
      </ns2:ResponseData>
    </ns2:CheckOperationResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример XML - ответ на операции с квитанциями на скупку/комиссию/изготовление/ремонт, залоговым билетом
Ответ:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <ns2:CheckOperationResponse xmlns:ns10="urn://xsd.dmdk.goznak.ru/buyingup/3.0" xmlns:ns11="urn://xsd.dmdk.goznak.ru/deal/3.0" xmlns:ns12="urn://xsd.dmdk.goznak.ru/specification/3.0" xmlns:ns13="urn://xsd.dmdk.goznak.ru/glossary/3.0" xmlns:ns14="urn://xsd.dmdk.goznak.ru/protocol-qca/3.0" xmlns:ns2="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns3="urn://xsd.dmdk.goznak.ru/act/3.0" xmlns:ns4="urn://xsd.dmdk.goznak.ru/contractor/3.0" xmlns:ns5="urn://xsd.dmdk.goznak.ru/batch/3.0" xmlns:ns6="urn://xsd.dmdk.goznak.ru/assayreceipt/3.0" xmlns:ns7="urn://xsd.dmdk.goznak.ru/types/3.0" xmlns:ns8="urn://xsd.dmdk.goznak.ru/document/3.0" xmlns:ns9="urn://xsd.dmdk.goznak.ru/batch-operation/3.0">
      <ns2:DmdkSignature> ... подпись по стандарту XMLDSig ... </ns2:DmdkSignature>
      <ns2:ResponseData id="responsedata">
        <ns2:messageId>356145ce-ebb4-4221-bd24-a5d01c752988</ns2:messageId>
        <ns2:status>PREPARED</ns2:status>
        <ns2:success>
          <ns2:result>
            <ns2:index>1</ns2:index>
            <ns2:id>P-02-000000226-23</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>2</ns2:index>
            <ns2:id>P-02-000000049-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>3</ns2:index>
            <ns2:id>P-02-000000044-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>4</ns2:index>
            <ns2:id>P-02-000000017-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>5</ns2:index>
            <ns2:id>P-02-000000046-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>6</ns2:index>
            <ns2:id>P-02-000000047-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>7</ns2:index>
            <ns2:id>P-02-000000203-23</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>9</ns2:index>
            <ns2:id>P-02-000000014-24</ns2:id>
          </ns2:result>
        </ns2:success>
        <ns2:failure>
          <ns2:result>
            <ns2:index>8</ns2:index>
            <ns2:id>P-02-000000238-23</ns2:id>
            <ns2:msg>Данная операция не может быть выполнена: партии Ювелирное изделие 6432300000088244 с этапом Ломбард(12:PAWNSHOP) стадией На хранении(37:STORED) статусом На комплектации(11:COMPLETE_SET) не может быть присвоен этап Ломбард(12:PAWNSHOP) стадия Терминальная стадия(38:END_STAGE) статус Выведена из оборота(13:REMOVED)</ns2:msg>
            <ns2:error>
              <ns2:code>batchAction</ns2:code>
              <ns2:msg>Данная операция не может быть выполнена: партии Ювелирное изделие 6432300000088244 с этапом Ломбард(12:PAWNSHOP) стадией На хранении(37:STORED) статусом На комплектации(11:COMPLETE_SET) не может быть присвоен этап Ломбард(12:PAWNSHOP) стадия Терминальная стадия(38:END_STAGE) статус Выведена из оборота(13:REMOVED)</ns2:msg>
            </ns2:error>
          </ns2:result>
        </ns2:failure>
      </ns2:ResponseData>
    </ns2:CheckOperationResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример XML - ответ на корректировку акта ввода в оборот
Ответ:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <ns2:CheckOperationResponse xmlns:ns10="urn://xsd.dmdk.goznak.ru/buyingup/3.0" xmlns:ns11="urn://xsd.dmdk.goznak.ru/deal/3.0" xmlns:ns12="urn://xsd.dmdk.goznak.ru/specification/3.0" xmlns:ns13="urn://xsd.dmdk.goznak.ru/glossary/3.0" xmlns:ns14="urn://xsd.dmdk.goznak.ru/protocol-qca/3.0" xmlns:ns2="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns3="urn://xsd.dmdk.goznak.ru/act/3.0" xmlns:ns4="urn://xsd.dmdk.goznak.ru/contractor/3.0" xmlns:ns5="urn://xsd.dmdk.goznak.ru/batch/3.0" xmlns:ns6="urn://xsd.dmdk.goznak.ru/assayreceipt/3.0" xmlns:ns7="urn://xsd.dmdk.goznak.ru/types/3.0" xmlns:ns8="urn://xsd.dmdk.goznak.ru/document/3.0" xmlns:ns9="urn://xsd.dmdk.goznak.ru/batch-operation/3.0">
      <ns2:DmdkSignature> ... подпись по стандарту XMLDSig ... </ns2:DmdkSignature>
      <ns2:ResponseData id="responsedata">
        <ns2:messageId>68c585d1-dea9-454f-8e91-000ec12b5e51</ns2:messageId>
        <ns2:status>PREPARED</ns2:status>
        <ns2:success>
          <ns2:result>
            <ns2:index>001</ns2:index>
            <ns2:id>E-00-000000158-24</ns2:id>
          </ns2:result>
          <ns2:result>
            <ns2:index>002</ns2:index>
            <ns2:id>E-00-000000161-24</ns2:id>
          </ns2:result>
        </ns2:success>
      </ns2:ResponseData>
    </ns2:CheckOperationResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример XML - ответ на корректировку акта инвентаризации
Ответ:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <ns2:CheckOperationResponse xmlns:ns10="urn://xsd.dmdk.goznak.ru/buyingup/3.0" xmlns:ns11="urn://xsd.dmdk.goznak.ru/deal/3.0" xmlns:ns12="urn://xsd.dmdk.goznak.ru/specification/3.0" xmlns:ns13="urn://xsd.dmdk.goznak.ru/glossary/3.0" xmlns:ns14="urn://xsd.dmdk.goznak.ru/protocol-qca/3.0" xmlns:ns2="urn://xsd.dmdk.goznak.ru/exchange/3.0" xmlns:ns3="urn://xsd.dmdk.goznak.ru/act/3.0" xmlns:ns4="urn://xsd.dmdk.goznak.ru/contractor/3.0" xmlns:ns5="urn://xsd.dmdk.goznak.ru/batch/3.0" xmlns:ns6="urn://xsd.dmdk.goznak.ru/assayreceipt/3.0" xmlns:ns7="urn://xsd.dmdk.goznak.ru/types/3.0" xmlns:ns8="urn://xsd.dmdk.goznak.ru/document/3.0" xmlns:ns9="urn://xsd.dmdk.goznak.ru/batch-operation/3.0">
      <ns2:DmdkSignature> ... подпись по стандарту XMLDSig ... </ns2:DmdkSignature>
      <ns2:ResponseData id="responsedata">
        <ns2:messageId>d2cac62c-ca96-4f39-ae56-e031b8776b23</ns2:messageId>
        <ns2:status>PREPARED</ns2:status>
        <ns2:success>
          <ns2:result>
            <ns2:index>1</ns2:index>
            <ns2:id>E-00-000000174-24</ns2:id>
          </ns2:result>
        </ns2:success>
        <ns2:failure>
          <ns2:result>
            <ns2:index>2</ns2:index>
            <ns2:id>E-00-000000317-23</ns2:id>
            <ns2:msg>Нет доступа к корректировке акта ВН_ННННН</ns2:msg>
            <ns2:error>
              <ns2:code>errorCorrectBatchDocument</ns2:code>
              <ns2:msg>Нет доступа к корректировке акта ВН_ННННН</ns2:msg>
            </ns2:error>
          </ns2:result>
          <ns2:result>
            <ns2:index>3</ns2:index>
            <ns2:id>E-00-000000319-23</ns2:id>
            <ns2:msg>Нет доступа к корректировке акта ВН_ННННН</ns2:msg>
            <ns2:error>
              <ns2:code>errorCorrectBatchDocument</ns2:code>
              <ns2:msg>Нет доступа к корректировке акта ВН_ННННН</ns2:msg>
            </ns2:error>
          </ns2:result>
        </ns2:failure>
      </ns2:ResponseData>
    </ns2:CheckOperationResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>