From bc1606e3bf201278d3548c4d26fc1fd93dd4968c Mon Sep 17 00:00:00 2001 From: Alexander Viktorchik Date: Thu, 25 Jul 2024 15:04:40 +0300 Subject: [PATCH] qst-api - comments --- src/Examples/qstCreateIp.php | 68 +++++++++++++++++++++----------- src/Examples/qstCreateOrg.php | 74 +++++++++++++++++++++++------------ 2 files changed, 96 insertions(+), 46 deletions(-) diff --git a/src/Examples/qstCreateIp.php b/src/Examples/qstCreateIp.php index ec03f68..6543cbf 100644 --- a/src/Examples/qstCreateIp.php +++ b/src/Examples/qstCreateIp.php @@ -14,54 +14,78 @@ // Подключим файл, в котором заданы параметры мерчанта include_once 'start.php'; -/* Создание и отправка анкеты для подключения продавца */ +/* Создание и отправка анкеты для подключения сабмерчанта (продавца) ИП */ -/* Создаем и заполняем объект анкеты */ +/* Создадим объект анкеты */ $qst = new Qst(); -/* ИНН продавца */ +/* Укажем ИНН добавляемого сабмерчанта */ $qst->setInn('773200328662'); -/* Данные продавца */ +/* Создадим объект данных анкеты добавляемого сабмерчанта */ $qstSchema = new QstSchema(); + +/* Добавим в данные анкеты номер телефона сабмерчанта */ $qstSchema->addPhone('+7 495 1234567, доб. 123'); + +/* Добавим в данные анкеты email сабмерчанта */ $qstSchema->addEmail('example@ypmn.com'); +/* Создадим и заполним объект юридического адреса сабмерчанта */ $qstLegalAddress = (new QstSchemaLegalAddress()) - ->setZip('123456') - ->setRegion('Москва') - ->setCity('Москва') - ->setStreet('ул. Охотный ряд') - ->setHouse('1'); + ->setZip('123456') // индекс + ->setRegion('Москва') // регион + ->setCity('Москва') // город + ->setStreet('ул. Охотный ряд') // улица + ->setHouse('1'); // дом +/* Укажем объект юридического адреса сабмерчанта в данных анкеты */ $qstSchema->setLegalAddress($qstLegalAddress); +/* + * Создадим объект фактического адреса сабмерчанта и отметим, что + * фактический адрес сабмерчанта соответствует юридическому + */ $qstActualAddress = (new QstSchemaActualAddress())->setChecked(true); +/* Укажем объект фактического адреса сабмерчанта в данных анкеты */ $qstSchema->setActualAddress($qstActualAddress); +/* + * Создадим объект почтового адреса сабмерчанта и отметим, что + * почтовый адрес сабмерчанта соответствует юридическому + */ $qstPostAddress = (new QstSchemaPostAddress())->setChecked(true); +/* Укажем объект почтового адреса сабмерчанта в данных анкеты */ $qstSchema->setPostAddress($qstPostAddress); +/* Создадим объект удостоверяющего документа и заполним его паспортными данными ИП */ $qstIdentityDoc = (new QstSchemaIdentityDoc()) - ->setSeries('1234') - ->setNumber('123456') - ->setIssueDate('2000-01-30') - ->setIssuedBy('МВД') - ->setIssuedByKP('123-456'); - + ->setSeries('1234') // номер паспорта + ->setNumber('123456') // серия + ->setIssueDate('2000-01-30') // дата выдачи + ->setIssuedBy('МВД') // кем выдан + ->setIssuedByKP('123-456'); // к/п + +/* + * Заполним дату и место рождения ИП в данных анкеты. + * Укажем объект с паспортными данным ИП в данных анкеты. + */ $qstSchema - ->setBirthDate('1969-02-23') - ->setBirthPlace('Москва') - ->setIdentityDoc($qstIdentityDoc); + ->setBirthDate('1969-02-23') // дата рождения ИП + ->setBirthPlace('Москва') // место рождения ИП + ->setIdentityDoc($qstIdentityDoc); // объект с паспортными данным ИП +/* Создадим и заполним объект с банковскими данными ИП */ $qstBankAccount = (new QstSchemaBankAccount()) - ->setBankBIK('044525700') - ->setBankCorAccount('30101810200000000700') - ->setBankAccount('40702810100002400756'); - + ->setBankBIK('044525700') // БИК + ->setBankCorAccount('30101810200000000700') // кор. счет + ->setBankAccount('40702810100002400756'); // расч. счет +/* Добавим объект с банковскими данными сабмерчанта в данные анкеты */ $qstSchema->addBankAccount($qstBankAccount); +/* Заполним дополнительное поле #1 (при наличии) */ $qstSchema->setAdditionalFieldByKey(1, 'Доп. поле'); +/* Установим объект с данными анкеты в объект анкеты */ $qst->setSchema($qstSchema); /* Создадим HTTP-запрос к API */ diff --git a/src/Examples/qstCreateOrg.php b/src/Examples/qstCreateOrg.php index 4a062fd..0c1d750 100644 --- a/src/Examples/qstCreateOrg.php +++ b/src/Examples/qstCreateOrg.php @@ -15,58 +15,84 @@ // Подключим файл, в котором заданы параметры мерчанта include_once 'start.php'; -/* Создание и отправка анкеты для подключения продавца */ +/* Создание и отправка анкеты для подключения сабмерчанта (продавца) организации */ -/* Создаем и заполняем объект анкеты */ +/* Создадим объект анкеты */ $qst = new Qst(); -/* ИНН продавца */ +/* Укажем ИНН добавляемого сабмерчанта */ $qst->setInn('7704217370'); -/* Данные продавца */ +/* Создадим объект данных анкеты добавляемого сабмерчанта */ $qstSchema = new QstSchema(); + +/* Добавим в данные анкеты номер телефона сабмерчанта */ $qstSchema->addPhone('+7 495 1234567, доб. 123'); +/* Добавим в данные анкеты еще один номер телефона сабмерчанта */ $qstSchema->addPhone('+7 499 7654321, доб. 321'); + +/* Добавим в данные анкеты email сабмерчанта */ $qstSchema->addEmail('example@ypmn.com'); +/* Создадим и заполним объект юридического адреса сабмерчанта */ $qstLegalAddress = (new QstSchemaLegalAddress()) - ->setZip('123112') - ->setRegion('Москва') - ->setCity('Москва') - ->setStreet('Пресненская наб.') - ->setHouse('д. 10') - ->setFlat('эт. 41, Пом. I, комн. 6'); + ->setZip('123112') // индекс + ->setRegion('Москва') // регион + ->setCity('Москва') // город + ->setStreet('Пресненская наб.') // улица + ->setHouse('д. 10') // дом + ->setFlat('эт. 41, Пом. I, комн. 6'); // офис +/* Установим объект юридического адреса сабмерчанта в данных анкеты */ $qstSchema->setLegalAddress($qstLegalAddress); +/* + * Создадим объект фактического адреса сабмерчанта и отметим, что + * фактический адрес сабмерчанта соответствует юридическому + */ $qstActualAddress = (new QstSchemaActualAddress())->setChecked(true); +/* Установим объект фактического адреса сабмерчанта в данных анкеты */ $qstSchema->setActualAddress($qstActualAddress); -$qstCeoIdentityDoc = (new QstSchemaIdentityDoc()) - ->setSeries('1234') - ->setNumber('123456') - ->setIssueDate('2000-01-30') - ->setIssuedBy('МВД') - ->setIssuedByKP('123-456'); +/* Создадим объект удостоверяющего документа и заполним его паспортными данными руководителя организации */ +$qstCeoIdentityDoc = (new QstSchemaIdentityDoc()) + ->setSeries('1234') // номер паспорта + ->setNumber('123456') // серия + ->setIssueDate('2000-01-30') // дата выдачи + ->setIssuedBy('МВД') // кем выдан + ->setIssuedByKP('123-456'); // к/п + +/* + * Создадим объект руководителя организации. + * Установим в него объект с паспортными данными руководителя. + * Заполним место и дату рождения, адрес регистрации руководителя + */ $qstCeo = (new QstSchemaCeo()) - ->setIdentityDoc($qstCeoIdentityDoc) - ->setBirthDate('1980-01-30') - ->setBirthPlace('Москва') - ->setRegistrationAddress('г. Москва, ул. Ленина, д. 1, кв. 1'); + ->setIdentityDoc($qstCeoIdentityDoc) // объект с паспортными данными руководителя + ->setBirthDate('1980-01-30') // дата рождения руководителя + ->setBirthPlace('Москва') // место рождения руководителя + ->setRegistrationAddress('г. Москва, ул. Ленина, д. 1, кв. 1'); // адрес регистрации руководителя + +/* Установим объект с данными руководителя организации в данных анкеты */ $qstSchema->setCeo($qstCeo); +/* Создадим объект собственника организации, заполним ФИО и долю собственника */ $qstOwner = (new QstSchemaOwner())->setOwner('Иванов Иван Иванович')->setShare('100'); +/* Добавим объект с данными собственника организации в объект данных анкеты */ $qstSchema->addOwner($qstOwner); +/* Создадим и заполним объект с банковскими данными организации */ $qstBankAccount = (new QstSchemaBankAccount()) - ->setBankBIK('044525700') - ->setBankCorAccount('30101810200000000700') - ->setBankAccount('40702810100002400756'); - + ->setBankBIK('044525700') // БИК + ->setBankCorAccount('30101810200000000700') // кор. счет + ->setBankAccount('40702810100002400756'); // расч. счет +/* Добавим объект с банковскими данными сабмерчанта в данные анкеты */ $qstSchema->addBankAccount($qstBankAccount); +/* Заполним дополнительное поле #1 (при наличии) */ $qstSchema->setAdditionalFieldByKey(1, 'Доп. поле'); +/* Установим объект с данными анкеты в объект анкеты */ $qst->setSchema($qstSchema); /* Создадим HTTP-запрос к API */