Создание записи о контрагенте#
Запрос 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>