Uploads file

Shipments uploads file

post

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/shipments/uploads/{id}

Uploads supporting documents to a specific shipment by its ID. This method is used for attaching invoices, product specifications, customs declarations, or other shipment-related documents required for processing and clearance. Files are stored and linked to the shipment, ensuring better traceability and compliance.

⚠️ Region restriction: This method is available only for European shipments (EU/EU and EU/UA directions). It is not available for shipments originating from Ukraine.

File naming: • If the "fileName" parameter is provided, the uploaded file will be stored with that name. • If "fileName" is not provided, the default file name will be set to "invoice".

Use cases:

1. "I want to upload a client invoice in PDF to shipment 980911" - send the base64-encoded content in "file", set "fileName": "invoice.pdf".

2. "I want to attach a product photo in JPEG" - encode the photo in base64, set "fileName": "product-photo.jpeg".

🔹Description of control elements:

SCHEMA

Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.

• Single line description A description that fits into a single line; any text that does not fit remains hidden.

• Multiline description An expanded description that displays more than one line of text.

EXAMPLE

Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.

Authorizations

JWT

AuthorizationstringRequired

Authorization JWT-token with a lifetime of 1 hour in header

Path parameters

idinteger · int32Required

Unique identifier of the shipment to which the files are attached.
This value represents the shipmentId of the European system.
Using a Ukrainian shipment number will result in a validation error.

Body

application/json

filestringOptional

Base64-encoded document file (PDF, JPEG, or other supported formats).

fileNamestringOptional

Optional file name. Defaults to "invoice" if not provided.

Responses

201

File upload result

application/json

401

Unauthorized

application/json

404

The specified resource was not found

application/json

422

Validation error

application/json

503

Connection time-out

application/json

post

/shipments/uploads/{id}

HTTPcURLJavaScriptPython

POST /v.1.0/shipments/uploads/{id} HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "file": "/9j/4AAQSkZJRgABAQEAYABgAAD... (base64 content truncated)",
  "fileName": "product-photo.jpeg"
}

Example of JPEG uploadExample of PDF upload

{
  "success": true
}