Помощник по сервису интеграции

Примеры сформированных запросов и ответов#

Формирование запроса на создание новой записи об отчёте об охране лесов#

<soapenv:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен/">
   <soapenv:Header>
      <api:EgaisRequestHeader apiVersion="версия API" operationId="?">
           <api:security>
                <api:credentials userLogin='логин пользователя' userPassword='пароль пользователя'/>
                <api:apiKey>идентификатор внешней системы</api:apiKey>
           </api:security>
      </api:EgaisRequestHeader>
   </soapenv:Header>
   <soapenv:Body>
      <api:RequestInsertDocument>
         <api:contractReport sourceKey="?">
            <con4:reportType>contractProtectionReport</con4:reportType>
            <con4:contractNumber>555</con4:contractNumber>
            <!--Optional:-->
            <con4:status>draft</con4:status>
            <con4:receiptDate>2018-10-23T10:42:24</con4:receiptDate>
            <!--Optional:-->
            <con4:signatureDate>2018-10-23T10:42:24</con4:signatureDate>
            <con4:clientCreateTime>2018-10-23T10:42:24</con4:clientCreateTime>
            <con4:partyId>1207175</con4:partyId>
            <con4:underlyingContractRef id="P_130400" documentId="?" documentType="contractLease"/>
            <con4:woodlotElements/>
            <con4:startDate>2018-10-23T00:00:00.000+03:00</con4:startDate>
            <con4:reportingPeriod>
                <!--Optional:-->
               <con4:reportQuarter>1</con4:reportQuarter>
               <con4:reportingYear>2018</con4:reportingYear>
            </con4:reportingPeriod>
         </api:contractReport>
      </api:RequestInsertDocument>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на создание новой записи об отчёте об охране лесов#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseInsertDocument техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:contractReport id="P_924151" documentId="P_3373333" createDate="2018-10-24T10:28:46.740+03:00" updateDate="2018-10-24T10:28:46.740+03:00" sourceSystem="T" createdBy="логин пользователя, создавшего запись" updatedBy="логин пользователя, изменившего запись updatedBySystem="T" sourceKey="?">
            <ns9:reportType>contractProtectionReport</ns9:reportType>
            <ns9:contractNumber>555</ns9:contractNumber>
            <ns9:status>draft</ns9:status>
            <ns9:receiptDate>2018-10-23T00:00:00.000+03:00</ns9:receiptDate>
            <ns9:clientCreateTime>2018-10-23T10:42:24.000+03:00</ns9:clientCreateTime>
            <ns9:stateAuthorityId>22</ns9:stateAuthorityId>
            <ns9:partyId>1207175</ns9:partyId>
            <ns9:underlyingContractRef id="P_130400" documentType="contractLease"/>
            <ns9:woodlotElements/>
            <ns9:startDate>2018-10-23T00:00:00.000+03:00</ns9:startDate>
            <ns9:reportingPeriod>
               <ns9:reportQuarter>1</ns9:reportQuarter>
               <ns9:reportingYear>2018</ns9:reportingYear>
            </ns9:reportingPeriod>
         </ns2:contractReport>
      </ns2:ResponseInsertDocument>
   </soap:Body>
</soap:Envelope>

Формирование запроса на редактирование записи об отчёте об охране лесов#

Формирование запроса на редактирование отчётного квартала.

<soapenv:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен/">
   <soapenv:Header>
      <api:EgaisRequestHeader apiVersion="версия API" operationId="?">
           <api:security>
                <api:credentials userLogin='логин пользователя' userPassword='пароль пользователя'/>
                <api:apiKey>идентификатор внешней системы</api:apiKey>
           </api:security>
          </api:EgaisRequestHeader>
   </soapenv:Header>
   <soapenv:Body>
      <api:RequestUpdateDocument>
         <api:contractReport sourceKey="?" id="P_924151" documentId="P_3373333">
            <con4:reportType>contractProtectionReport</con4:reportType>
            <con4:contractNumber>555</con4:contractNumber>
            <!--Optional:-->
            <con4:status>draft</con4:status>
            <con4:receiptDate>2018-10-23T10:42:24</con4:receiptDate>
            <!--Optional:-->
            <con4:signatureDate>2018-10-23T10:42:24</con4:signatureDate>
                        <con4:partyId>1207175</con4:partyId>
            <con4:underlyingContractRef id="P_130400" documentId="?" documentType="contractLease"/>
             <con4:woodlotElements/>
            <con4:startDate>2018-10-23T00:00:00.000+03:00</con4:startDate>
            <con4:reportingPeriod>
               <!--Optional:-->
               <con4:reportQuarter>2</con4:reportQuarter>
               <con4:reportingYear>2018</con4:reportingYear>
            </con4:reportingPeriod>
         </api:contractReport>
       </api:RequestUpdateDocument>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на редактирование записи об отчёте об охране лесов#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseUpdateDocument техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:contractReport id="P_924151" documentId="P_3373333" createDate="2018-10-24T10:28:46.740+03:00" updateDate="2018-10-24T10:47:45.253+03:00" sourceSystem="T" createdBy="логин пользователя, создавшего запись" updatedBy="логин пользователя, изменившего запись updatedBySystem="T" sourceKey="?">
            <ns9:reportType>contractProtectionReport</ns9:reportType>
            <ns9:contractNumber>555</ns9:contractNumber>
            <ns9:status>draft</ns9:status>
            <ns9:receiptDate>2018-10-23T00:00:00.000+03:00</ns9:receiptDate>
            <ns9:clientCreateTime>2018-10-23T10:42:24.000+03:00</ns9:clientCreateTime>
            <ns9:stateAuthorityId>22</ns9:stateAuthorityId>
            <ns9:partyId>1207175</ns9:partyId>
            <ns9:underlyingContractRef id="P_130400" documentType="contractLease"/>
            <ns9:woodlotElements/>
            <ns9:startDate>2018-10-23T00:00:00.000+03:00</ns9:startDate>
            <ns9:reportingPeriod>
               <ns9:reportQuarter>2</ns9:reportQuarter>
               <ns9:reportingYear>2018</ns9:reportingYear>
            </ns9:reportingPeriod>
         </ns2:contractReport>
      </ns2:ResponseUpdateDocument>
   </soap:Body>
</soap:Envelope>

Формирование запроса на добавление информации о мероприятиях#

Для добавления информации о мероприятии в созданный отчет об охране лесов необходимо сформировать запрос со значением «REL» параметра «value», где значение параметра «useSquare» – площадь выдела, га (используемая), «value» – объем мероприятия, «value2» – площадь мероприятия.

<soapenv:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен/">
   <soapenv:Header>
      <api:EgaisRequestHeader apiVersion="версия API" operationId="?">
           <api:security>
                <api:credentials userLogin='логин пользователя' userPassword='пароль пользователя'/>
                <api:apiKey>идентификатор внешней системы</api:apiKey>
         </api:security>
      </api:EgaisRequestHeader>
   </soapenv:Header>
   <soapenv:Body>
      <api:RequestInsertDocument>
         <api:plotFact>
            <com:cuttingPlotId>76</com:cuttingPlotId>            
            <com:activity>
               <look:id>90</look:id>
               <look:name>Реконструкция лесных дорог, предназначенных для охраны лесов от пожаров</look:name>
               <look:code>710</look:code>
            </com:activity>            
            <com:activityPlace>
               <look:id>3</look:id>
               <look:name>ООЛ</look:name>
            </com:activityPlace>
             <com:useSquare>10</com:useSquare>
             <!--Optional:-->
            <com:value>10</com:value>
            <!--Optional:-->
            <com:value2>10</com:value2>
             <!--Optional:-->
            <com:jsonData>{"age": 0, "height": 0, "comment": "", "completeness": 0.1, "maxUsedValue": 0, "fireWoodVolume": 0, "timberWoodVolume": 0, "illiquidWoodVolume": 0, "infrastructureNumber": "", "landCharacteristicEndDate": {"id": "1", "name": "Лесные насаждения", "value": "1", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKind": {"id": 1, "name": "Лесные насаждения", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKindCategory": {"id": 1, "name": "Лесные земли, занятые лесными насаждениями (покрытые лесной растительностью)", "deleted": null, "createdBy": null, "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": null, "updateDate": null, "sourceSystem": null} } }, "landCharacteristicStartDate": {"id": "1", "name": "Лесные насаждения", "value": "1", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKind": {"id": 1, "name": "Лесные насаждения", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKindCategory": {"id": 1, "name": "Лесные земли, занятые лесными насаждениями (покрытые лесной растительностью)", "deleted": null, "createdBy": null, "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": null, "updateDate": null, "sourceSystem": null} } } }</com:jsonData>
              <com:meta>
                    <look:value>REL</look:value>
               </com:meta>                    
            <com:document id="P_3373333" documentType="contractProtectionReport"/>        
         </api:plotFact>
      </api:RequestInsertDocument>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на добавление информации о мероприятиях#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseInsertDocument техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:plotFact id="354" createDate="2018-10-24T14:09:51.315+03:00" createdBy="логин пользователя, создавшего запись">
            <cuttingPlotId>76</cuttingPlotId>
            <activity>
               <ns12:id>90</ns12:id>
               <ns12:name>Реконструкция лесных дорог, предназначенных для охраны лесов от пожаров</ns12:name>
               <ns12:code>710</ns12:code>
            </activity>
            <activityPlace>
               <ns12:id>3</ns12:id>
               <ns12:name>ООЛ</ns12:name>
            </activityPlace>
            <useSquare>10</useSquare>
            <value>10.0</value>
            <value2>10.0</value2>
            <jsonData>{"age": 0, "height": 0, "comment": "", "completeness": 0.1, "maxUsedValue": 0, "fireWoodVolume": 0, "timberWoodVolume": 0, "illiquidWoodVolume": 0, "infrastructureNumber": "", "landCharacteristicEndDate": {"id": "1", "name": "Лесные насаждения", "value": "1", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKind": {"id": 1, "name": "Лесные насаждения", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKindCategory": {"id": 1, "name": "Лесные земли, занятые лесными насаждениями (покрытые лесной растительностью)", "deleted": null, "createdBy": null, "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": null, "updateDate": null, "sourceSystem": null} } }, "landCharacteristicStartDate": {"id": "1", "name": "Лесные насаждения", "value": "1", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKind": {"id": 1, "name": "Лесные насаждения", "deleted": false, "createdBy": "migration", "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": "2018-05-19T17:42:47", "updateDate": null, "sourceSystem": null, "landCharacteristicKindCategory": {"id": 1, "name": "Лесные земли, занятые лесными насаждениями (покрытые лесной растительностью)", "deleted": null, "createdBy": null, "initialId": null, "sourceKey": null, "updatedBy": null, "createDate": null, "updateDate": null, "sourceSystem": null} } } }</jsonData>
            <meta>
               <ns12:value>REL</ns12:value>
            </meta>
            <document id="P_3373333" documentType="contractProtectionReport"/>
         </ns2:plotFact>
      </ns2:ResponseInsertDocument>
   </soap:Body>
</soap:Envelope>

Формирование запроса на получение данных об отчёте об охране лесов#

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

<soapenv:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен/">
   <soapenv:Header>
      <api:EgaisRequestHeader apiVersion="версия API" operationId="?">
           <api:security>
                <api:credentials userLogin='логин пользователя' userPassword='пароль пользователя'/>
                <api:apiKey>идентификатор внешней системы</api:apiKey>
           </api:security>
      </api:EgaisRequestHeader>
   </soapenv:Header>
   <soapenv:Body>
      <api:RequestGetDocument>
         <api:documentRef id="P_924151" documentId="P_3373333" documentType="contractProtectionReport"/>
      </api:RequestGetDocument>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на получение данных об отчёте об охране лесов#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseGetDocument техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:contractReport id="P_924151" documentId="P_3373333" createDate="2018-10-24T10:28:46.740+03:00" updateDate="2018-10-24T10:47:45.253+03:00" sourceSystem="T" createdBy="логин пользователя, создавшего запись" updatedBy="логин пользователя, изменившего запись updatedBySystem="T" sourceKey="?">
            <ns9:reportType>contractProtectionReport</ns9:reportType>
            <ns9:contractNumber>555</ns9:contractNumber>
            <ns9:status>draft</ns9:status>
            <ns9:receiptDate>2018-10-23T00:00:00.000+03:00</ns9:receiptDate>
            <ns9:clientCreateTime>2018-10-23T10:42:24.000+03:00</ns9:clientCreateTime>
            <ns9:stateAuthorityId>22</ns9:stateAuthorityId>
            <ns9:partyId>1207175</ns9:partyId>
            <ns9:underlyingContractRef id="P_130400" documentType="contractLease"/>
            <ns9:woodlotElements/>
            <ns9:startDate>2018-10-23T00:00:00.000+03:00</ns9:startDate>
            <ns9:reportingPeriod>
               <ns9:reportQuarter>2</ns9:reportQuarter>
               <ns9:reportingYear>2018</ns9:reportingYear>
            </ns9:reportingPeriod>
         </ns2:contractReport>
      </ns2:ResponseGetDocument>
   </soap:Body>
</soap:Envelope>

Формирование запроса на получение данных об отчёте об охране лесов
по заданным параметрам фильтрации
#

Формирование запроса на получение данных об отчёте об охране лесов по номеру отчёта.

<soapenv:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен/">
   <soapenv:Header>
      <api:EgaisRequestHeader apiVersion="версия API" operationId="?">
           <api:security>
                <api:credentials userLogin='логин пользователя' userPassword='пароль пользователя'/>
                <api:apiKey>идентификатор внешней системы</api:apiKey>
         </api:security>
      </api:EgaisRequestHeader>
   </soapenv:Header>
   <soapenv:Body>
      <api:RequestGetDocumentsByFilter documentType="contractProtectionReport" pageSize="10" pageNumber="0">
         <!--0 to 100 repetitions:-->
         <api:item>
            <fil:property>contractNumber</fil:property>
            <!--1 or more repetitions:-->
            <fil:value>555</fil:value>
            <!--Optional:-->
            <fil:operation>EQ</fil:operation>
         </api:item>
      </api:RequestGetDocumentsByFilter>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на редактирование записи об отчёте об охране лесов
по заданным параметрам фильтрации
#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseGetDocumentsByFilter техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:contractReport id="P_924151" documentId="P_3373333" createDate="2018-10-24T10:28:46.740+03:00" updateDate="2018-10-24T10:47:45.253+03:00" sourceSystem="T" createdBy="логин пользователя, создавшего запись" updatedBy="логин пользователя, изменившего запись updatedBySystem="T" sourceKey="?">
            <ns9:reportType>contractProtectionReport</ns9:reportType>
            <ns9:contractNumber>555</ns9:contractNumber>
            <ns9:status>draft</ns9:status>
            <ns9:receiptDate>2018-10-23T00:00:00.000+03:00</ns9:receiptDate>
            <ns9:clientCreateTime>2018-10-23T10:42:24.000+03:00</ns9:clientCreateTime>
            <ns9:stateAuthorityId>22</ns9:stateAuthorityId>
            <ns9:partyId>1207175</ns9:partyId>
            <ns9:underlyingContractRef id="P_130400" documentType="contractLease"/>
            <ns9:startDate>2018-10-23T00:00:00.000+03:00</ns9:startDate>
            <ns9:reportingPeriod>
               <ns9:reportQuarter>2</ns9:reportQuarter>
               <ns9:reportingYear>2018</ns9:reportingYear>
            </ns9:reportingPeriod>
         </ns2:contractReport>
      </ns2:ResponseGetDocumentsByFilter>
   </soap:Body>
</soap:Envelope>

Выше