Укр
Локальні відправлення в межах ЄС
integration
Методи

Створення відправлень

Створення відправлення без інвойсу: для країн ЄС

Посилки всередині країни та між країнами ЄС, в яких є представництво Nova Post, можна відправляти без інвойсу.

 Для доставки у Велику Британію та за межі Великої Британії інвойс обов'язковий.

ЕН для відправлень без інвойсу можна створювати тим самим методом, що і міжнародні посилки. В API Nova Post метод створення відправлення універсальний для локальних перевезень та відправлень за кордон, й легко адаптується до потреб кожного виду перевезення. Різниця – лише в полях, обов'язкових для заповнення.

Для локальної доставки та доставки між країнами ЄС достатньо заповнити поля:

  • status: для цього поля дефолтне значення "ReadyToShip", тільки його можна вказати під час створення ІД.
  • clientOrder: ідентифікатор замовлення клієнта*
  • note: примітка до замовлення*
  • payerType та payerContractNumber: інформація про платника за послуги доставки
  • parcels: детальна інформація про посилки:
    • cargoCategory: категорія вантажу (наприклад, "parcel").
    • parcelDescription: опис вмісту посилки.
    • insuranceCost: декларована вартість посилки для страхування відправлення.
    • width, length, height, actualWeight: габарити та вага посилки.
  • sender: інформація про відправника.
    • companyTin: ідентифікаційний номер компанії.
    • phone, email, name: контактна інформація відправника.
    • countryCode: код країни відправника (ISO Alpha-2).
    • divisionId: ідентифікатор відділення для відправлення.
    • addressParts: детальна інформація про адресу відправника, при відправленні з адреси.
  • recipient: інформація про отримувача.
    • phone, email, name: контактна інформація отримувача.
    • countryCode: код країни отримувача (ISO Alpha-2).
    • divisionId: ідентифікатор відділення для отримання.
    • addressParts: детальна інформація про адресу отримувача, при оформленні доставки на адресу.

* необов'язкові для заповнення поля

Інші поля, що неописані тут, заповнювати непотрібно, вони призначені для міжнародних посилок.

  • Структура запиту для створення локального відправлення

    {
        "status": "ReadyToShip",
        "clientOrder": "",
        "note": "Test",
        "payerType": "Sender",
        "payerContractNumber": null,
        "parcels": [
            {
                "cargoCategory": "parcel",
                "parcelDescription": "test print",
                "insuranceCost": "1279",
                "rowNumber": 1,
                "width": 200,
                "length": 350,
                "height": 100,
                "actualWeight": 500
            }
        ],
        "sender": {
            "companyTin": "",
            "companyName": "",
            "phone": "380991234567",
            "email": "test@test.ts",
            "name": "Test Test",
            "countryCode": "PL",
            "divisionId": 27253,
            "addressParts": {}
        },
        "recipient": {
            "companyTin": "",
            "companyName": "",
            "phone": "380991234567",
            "email": "test@test.ts",
            "name": "Test Test",
            "countryCode": "PL",
            "address": null,
            "divisionId": 27254,
            "addressParts": {}
        }
    }