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