IMPORTANT! Extension is already under development

Extension to work with Nova Poshta API

All models methods and properties has the same as in official documentation.

1. Setup configuration:

'components' => [
    'novaposhta' => [
        'class' => 'jones\novaposhta\Api',
        'api_key' => 'specify your api key',
        'format' => 'json' \\supported json and xml formats
    ]
]

The json format more appreciated, because response formatting faster.

2. Set alias for extension in bootstrap.php file:

Yii::setAlias('novaposhta', '@vendor/joni-jones/yii2-novaposhta');

3. Configure extension translations:

'components' => [
    'api' => [
        'class' => 'yii\i18n\PhpMessageSource',
        'basePath' => '@novaposhta/messages',
        'sourceLanguage' => 'en',
    ],
]

4. Create new api model:

$model = new \jones\novaposhta\Address(new \jones\novaposhta\request\Factory());

or

$model = Yii::createObject(\jones\novaposhta\Address::class);

in the second case request factory will be created by Yii DI manager.

5. Process request:

$areas = $model->getAreas();

Each model has list of rules where described attributes per each scenario. If some api call will be processed without required attributes you will get false instead normal response. To get list of errors just call:

$model->getErrors();

• Address
• InternetDocument (under development)
• Common (under development)
• ContactPerson (under development)
• Counterparty (under development)
• ScanSheet (under development)

• getAreas

  $areas = $addressModel->getAreas();

• getCities

  $cities = $addressModel->getCities('Бровари'); // filter not empty add it to `FindByString` request param

• delete

  $addressModel->Ref = 'fs1d2vbv12'; // if Ref is not specified you will get validation error
  $addressModel->delete();

• getWarehouses

  $addressModel->CityRef = 'df1j2cmf5d';  // CityRef is required parameter
  $warehouses = $addressModel->getWarehouses('Броварський'); // Street name is additional parameter

• getStreet

  $streets = $addressModel->getStreet('city ref', 'street name');

• getWarehouseTypes

  $types = $addressModel->getWarehouseTypes();

• save

  $addressModel->StreetRef = 'd8364179-4149-11dd-9198-001d60451983';
  $addressModel->CounterpartyRef = '56300fb9-cbd3-11e4-bdb5-005056801329';
  $response = $addressModel->save('10', 12, 'Comment');   // building should be in string type

• update

  $addressModel->Ref = '503702df-cd4c-11e4-bdb5-005056801329';
  $addressModel->CounterpartyRef = '56300fb9-cbd3-11e4-bdb5-005056801329';
  $response = $addressModel->save('10', 12, 'Comment');   // building should be in string type

• getAreas

  $counterparties = $counterpartyModel->getCounterparties();

• getCounterpartyAddresses

  $addresses = $counterpartyModel->getCounterpartyAddresses('6e9acced-d072-11e3-95eb-0050568046cd', 'Sender');

• getCounterpartyContactPersons

  $persons = $counterpartyModel->getCounterpartyContactPersons('6e9acced-d072-11e3-95eb-0050568046cd');

• save

  // set model attributes
  $counterpartyModel->cityRef = '0050568046cd';
  .
  .
  .
  $counterpartyModel->Phone = '0567894512';
  $response = $counterpartyModel->save();

• update

  // set model attributes
  $counterpartyModel->Ref = '005056801329';
  .
  .
  .
  $counterpartyModel->Email = 'contractor@test.com';
  $response = $counterpartyModel->update();

• delete

  $counterparty->Ref = '0050568002cf'; // if Ref is not specified you will get validation error
  $counterparty->delete();