Creating a Shipment Without an Invoice: For EU Countries
Parcels within the country and between EU countries where Nova Post is represented can be sent without an invoice.
For delivery to the United Kingdom and beyond, an invoice is mandatory.
A waybill (WB) for shipments without an invoice can be created using the same method as for international shipments. In the Nova Post API the method for creating a shipment is universal for both local and international shipments, and it easily adapts to the needs of each type of delivery. The difference lies only in the fields required for completion.
For local deliveries and deliveries between EU countries, the following fields are sufficient:
- 1status: This field defaults to "ReadyToShip", which is the only value that can be specified when creating the ID.
- 1clientOrder: customer order identifier*
- 2note: order note*
- 3payerType та payerContractNumber: information about the payer for delivery services.
- 1parcels: detailed information about the parcels:
- 1.1cargoCategory: cargo category (e.g., "parcel").
- 1.2parcelDescription: description of the parcel contents.
- 1.3insuranceCost: declared value of the parcel for shipping insurance.
- 1.4width, length, height, actualWeight: parcel dimensions and weight.
- 2sender: information about the sender.
- 2.1companyTin: company tax identification number.
- 2.2phone, email, name: sender's contact information.
- 2.3countryCode: sender's country code (ISO Alpha-2).
- 2.4divisionId: sender’s branch identifier.
- 2.5addressParts: sender’s branch identifierdetailed address information for the sender if shipping from an address.
- 3recipient: information about the recipient.
- 3.1phone, email, name: recipient’s contact information.
- 3.2countryCode: recipient's country code (ISO Alpha-2).
- 3.3divisionId: recipient’s branch identifier.
- 3.4addressParts: detailed address information for the recipient if delivering to an address.
* optional fields
Other fields not described here do not need to be filled in, as they are intended for international shipments.
- Request Structure for Creating a Local Shipment:
{
"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": {}
}
}