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

Создание записи о контрагенте#

Запрос InsertParty позволяет создать запись о контрагенте со следующими данными:

Наименование поля Способ заполнения
Тип контрагента автоматически
ИНН контрагента (не заполняется для иностранной компании) вручную
ОГРН контрагента (для юридического лица) / ОГРНИП контрагента (для индивидуального предпринимателя) вручную
Наименование организации (для юридического лица и иностранной компании) вручную
Имя (для физического лица и индивидуального предпринимателя) вручную
Фамилия (для физического лица и индивидуального предпринимателя) вручную
Отчество (для физического лица и индивидуального предпринимателя) вручную
Тип документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) вручную
Серия документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) вручную
Номер документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) вручную
Юридический адрес вручную
Фактический адрес вручную
Специальная категория (для юридического лица) вручную
Статус контрагента автоматически
Код (для иностранной компании) автоматически
Страна (для иностранной компании) автоматически
Организационно-правовая форма (для юридического лица и индивидуального предпринимателя) вручную

Спецификация запроса на создание контрагента

Код операции Описание операции
RequestInsertParty Принимает от внешних АИС запрос на создание записи о контрагенте, в ходе обработки которого формируется ответ и возвращается внешней АИС

Перечень входных параметров и их формат

Код параметра Описание параметра Свойство Тип Формат
partyType Идентификатор типа контрагента Обязательное поле integer [0-9]
справочное значение
inn ИНН контрагента (не заполняется для иностранной компании) Необязательное поле string [0-9] {12}
ogrn ОГРН контрагента (для юридического лица) / ОГРНИП контрагента (для индивидуального предпринимателя) Необязательное поле string [0-9] {15}
partyName Наименование организации (для юридического лица и иностранной компании) Необязательное поле string [0-9] [A-Я] [а-я]
[A-Z] [а-z]
personFirstName Имя (для физического лица и индивидуального предпринимателя) Необязательное поле string [0-9] [A-Я] [а-я]
personLastName Фамилия (для физического лица и индивидуального предпринимателя) Необязательное поле string [0-9] [A-Я] [а-я]
personMidName Отчество (для физического лица и индивидуального предпринимателя) Необязательное поле string [0-9] [A-Я] [а-я]
personDocTypeId Тип документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) Необязательное поле integer Принимает значение:
0 – паспорт гражданина РФ
personDocSeries Серия документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) Необязательное поле string [0-9] {4}
personDocNum Номер документа, удостоверяющего личность (для физического лица и индивидуального предпринимателя) Необязательное поле string [0-9] {6}
physicalAddress Фактический адрес Обязательное поле string [0-9] [A-Я] [а-я]
[A-Z] [а-z]
goldenRecordId Идентификатор мастер записи Необязательное поле string [0-9] [A-Z]
countryId Идентификатор страны Необязательное поле integer [0-9]
справочное значение
legalFormId Организационно-правовая форма (для юридического лица и индивидуального предпринимателя) Необязательное поле integer [0-9]
справочное значение

Пример сформированного запроса и ответа

Формирование запроса на создание контрагента#

<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:RequestInsertParty>
         <api:party sourceKey="?">
            <com:partyType>0</com:partyType>
            <!--Optional:-->
            <com:inn>ИНН</com:inn>
            <!--Optional:-->
            <com:ogrn>ОГРН</com:ogrn>
            <!--Optional:-->
            <com:partyName>ООО "Пример"</com:partyName>
            <com:physicalAddress>394030 Г ВОРОНЕЖ УЛИЦА РЕВОЛЮЦИИ ДОМ 66</com:physicalAddress>
            <!--Optional:-->
            <com:goldenRecordId/>
            <!--Optional:-->
            <com:countryId>167</com:countryId>
            <!--Optional:-->
            <com:legalFormId>6</com:legalFormId>
         </api:party>
      </api:RequestInsertParty>
   </soapenv:Body>
</soapenv:Envelope>

Формирование ответа на создание контрагента#

<soap:Envelope техническая информация с атрибутами xmlns, определяющими пространства имен>
   <soap:Header>
      <ns4:EgaisResponseHeader техническая информация с атрибутами xmlns, определяющими пространства имен>
   </soap:Header>
   <soap:Body>
      <ns2:ResponseInsertParty etLookupValues техническая информация с атрибутами xmlns, определяющими пространства имен>
         <ns2:party id="P_1207176" createDate="2018-11-01T15:07:25.360+03:00" updateDate="2018-11-01T15:07:25.360+03:00" createdBy="логин пользователя, создавшего запись" updatedBy="логин пользователя, изменившего запись" sourceKey="?">
            <partyType>0</partyType>
            <inn>ИНН</inn>
            <ogrn>ОГРН</ogrn>
            <partyName>ООО "Пример"</partyName>
            <personFirstName/>
            <personLastName/>
            <personMidName/>
            <personDocSeries/>
            <personDocNum/>
            <physicalAddress>394030 Г ВОРОНЕЖ УЛИЦА РЕВОЛЮЦИИ ДОМ 66</physicalAddress>
            <goldenRecordId>P_1207176</goldenRecordId>
            <countryId>167</countryId>
            <legalFormId>6</legalFormId>
         </ns2:party>
      </ns2:ResponseInsertParty>
   </soap:Body>
</soap:Envelope>

Выше