Added custom invoice attachments for business shipments
Endpoint:
POST v.1.0/shipments
PUT v.1.0/shipments/{id}
In accordance with customs requirements, starting from April 15, corporate clients will be able to additionally upload their own invoice form with a physical signature or a completed, signed, and scanned invoice template to the international express waybill in order to ensure proper cargo documentation support.
What’s new?
Previously, clients could attach their own invoice forms, but customs officers identified them only after the physical inspection of the cargo.
There was also a risk of incorrect invoice type identification (commercial invoice or invoice issued free of charge), which could cause delays in customs clearance processing.
Now, within the invoice array, you can:
specify whether the invoice is client-provided;
define the invoice type and its attributes;
attach a scanned invoice file.
This allows the system to automatically determine the correct customs codes and synchronize data between the client, Nova Post systems, and customs authorities.
Additionally, in this scenario, the client must provide a flag confirming that the invoice has been physically signed.
How it works:
New fields for attaching a client invoice have been added to the request for creating or updating an international express waybill.
The system identifies the presence of a client invoice and transfers this information to the customs broker.
Please note that this functionality is available both for:
creating an international express waybill;
updating an international express waybill.
Field name
Type
Description
clientInvoice
int
Indicates whose invoice is used.
1 — client invoice
0 — Nova Post template
Default value: 0
invoiceType
enum
Invoice type:
Invoice — commercial invoice
ProformaInvoice — free-of-charge invoice
Default value: Invoice
customerNumber
string
Client invoice number (for client invoice).
Required if clientInvoice = 1
customerCreatedAt
datetime
Client invoice date (for client invoice).
Default value: current date
invoiceSign
int
Indicates that the client signed the invoice file.
Required if clientInvoice = 1
invoiceFile
object
Object for transferring client invoice file data
base64Content
string
File content in Base64 format.
Required if clientInvoice = 1
filename
string
Client-defined file name.
Required if clientInvoice = 1
Example of filling in:
After creating the international express waybill, you will be able to add additional accompanying documents, retrieve the list of already uploaded documents, or download a file for verification.