The UPS Paperless API is a digital solution that allows businesses to electronically transmit trade documents—such as commercial invoices and certificates of origin—directly to UPS during the shipping process
UPS Paperless flow
1. create an Order with CustomsDeclaration data and a dummy document on Attachments
a. Innoship will use UPS Paperless API to upload dummy data and get documentId.
b. Innoship will use this documentId to create the UPS Label using ship endpoint.
2. Created Label will have EDI-IDIS text on it ( see label below)
3. use Upload Documents endpoint to upload real invoice data - use CourierId 58 and link CourierShipmentId
a. Innoship will get documentId and use it to link with UPS push image endpoint.
INFO: real invoice data must be uploaded before the shipment is handed over to UPS
API REQUEST EXAMPLE WITH CustomsDeclaration and Attachments
{
"ServiceId": 51,
"CourierId": 58,
"ShipmentDate": "2026-03-09T10:48:02.606+01:00",
"ShipmentDateEnd": "2026-03-10T10:48:02.606+01:00",
"AddressTo": {
"Name": "Test Paperless",
"ContactPerson": "Test Paperless",
"Country": "NO",
"LocalityName": "STAVANGER",
"AddressText": "Langflåtveien 37",
"PostalCode": "4017",
"Phone": "91808913",
"Email": "eirik@erik.no"
},
"Payment": 1,
"Content": {
"EnvelopeCount": 0,
"ParcelsCount": 1,
"PalettesCount": 0,
"TotalWeight": 7,
"Contents": "General goods",
"OversizedPackage": false,
"Parcels": [
{
"SequenceNo": 1,
"Size": {
"Width": 10,
"Height": 20,
"Length": 15
},
"Weight": 7,
"Type": 2,
"Reference1": "16822417",
"Articles": [
{
"Quantity": 25,
"Description": "Newport 350ml DBL Tumbler BK",
"CountryOfOrigin": "CN",
"Tariff": "9617000000",
"WeightNet": 0.266,
"WeightGross": 0.28,
"PricePerPieceAmount": 1.63,
"PricePerPieceAmountCurrency": "EUR",
"Sku": "10091690"
}
]
}
],
"InvoiceValue": 40.75
},
"Extra": {
"DeclaredValueAmount": 40.75,
"DeclaredValueAmountCurrency": "EUR",
"Reference1": "CNO116822417",
"Reference2": "altus",
"Reference3": "",
"Reference4": "081",
"CustomsDeclaration": {
"Exporter": {
"Name": "Test Exporter",
"ContactPerson": "Test Exporter",
"Country": "NL",
"LocalityName": "Leiden",
"AddressText": "Schipholweg 59",
"PostalCode": "2316 ZL",
"Phone": "+31713328000",
"Email": "noreply@innoship.com"
},
"Importer": {
"Name": "Test Importer",
"ContactPerson": "Test Importer",
"Country": "NO",
"LocalityName": "Trollasen",
"AddressText": "Trollasveien 8",
"PostalCode": "1414",
"Phone": "+4766800030",
"Email": "noreply@innoship.com"
},
"ExporterEORI": "NL856618019",
"ImporterTaxId": "983770339",
"Reason": 10,
"Incoterm": "DDP",
"Attachments": [
{
"Name": "emptyFile.pdf",
"Content": "---trimmed---"
}
]
}
},
"Parameters": {
"Async": true,
"GetParcelsBarcodes": false,
"IncludeCourierResponse": false,
"IncludePriceBreakdown": false,
"IncludeAddressInResponse": false,
"ConsolidateOrder": false,
"IgnoreNotifications": false,
"ImportExternalOrder": false,
"OverwriteLocationAddressWithSenderDetails": false
},
"ExternalClientLocation": "ExternalClientLocation",
"ExternalOrderId": "16822417",
"Metadata": "metadata",
"SourceChannel": "UPS Paperless",
"Observation": "Observation"
}UPS LABEL EXAMPLE
