Нова Пошта API v4 + OpenCart — автоматизація доставки

Нова Пошта API v4 — JSON-RPC API що дозволяє отримати список міст, відділень, розрахувати вартість доставки та відстежити посилку прямо з вашого OpenCart магазину.

Отримання API ключа

Зайдіть в особистий кабінет НП → Налаштування → API → Згенерувати ключ. Ключ виглядає як UUID.

Базовий API запит

POST https://api.novaposhta.ua/v2.0/json/
{
  "apiKey": "your_api_key",
  "modelName": "Address",
  "calledMethod": "getCities",
  "methodProperties": {
    "FindByString": "Київ"
  }
}

Ключові методи для інтеграції

1. Список міст (автодоповнення)

modelName: "Address", calledMethod: "getCities"

2. Відділення міста

modelName: "AddressGeneral", calledMethod: "getWarehouses",
methodProperties: { CityRef: "city_uuid" }

3. Розрахунок вартості

modelName: "InternetDocument", calledMethod: "getDocumentPrice",
methodProperties: {
  CitySender: "...", CityRecipient: "...",
  Weight: "1", ServiceType: "WarehouseWarehouse",
  Cost: "500", CargoType: "Cargo", SeatsAmount: "1"
}

Накладений платіж (COD)

При створенні ТТН додайте поля PaymentMethod: "Cash" та AfterpaymentOnGoodsCost з сумою COD.

Синхронізація бази відділень

База відділень НП оновлюється щодня. Рекомендую запускати синхронізацію через cron о 03:00:

0 3 * * * php /path/to/opencart/index.php route=extension/module/novaposhta/sync

Хочете готову інтеграцію? Замовте підключення Нової Пошти до OpenCart.