- Authentication, Environments
- Endpoints Overview
- Scenarios And Workflows
- All API Endpoints
- Parcels
- Create or update single parcel.
- Create or update up to 200 parcels in a single request.
- Get parcel details by parcel Id.
- Get up to 100 parcels details by parcel Ids.
- Get parcel details by parcel number (tracking number).
- Get up to 100 parcels details by parcel numbers (tracking numbers).
- Get parcel details by sender reference number.
- Get up to 100 parcel details by sender reference numbers.
- Query up to 500 parcels.
- Delete parcel by Id.
- Delete up to 100 parcels by Ids.
- Get print details and contents by print Id.
- Get up to 100 parcel print details and contents by print Ids.
- Get pickup point details by Id.
- Query pickup points.
- Group parcels into bags and link to a shipment (update parcel references). When AllowPartialSuccess is true, valid parcels are updated and invalid ones returned in FailedParcels.
- Get parcel details by manifest reference numbers.
- Get up to 100 parcel details by manifest reference numbers.
- Get parcel details by carrier reference numbers.
- Get up to 100 parcel details by carrier reference numbers.
- Shipments
- Cancel erroneous parcels in a shipment.POST
- Delete shipment manifest file.DELETE
- Create new shipment.POST
- Create new bag level shipment.POST
- Update bag level shipment.PUT
- Link parcels with specified bag numbers to a shipment.POST
- Validate and prepare shipment for submitting.POST
- Submit and lock shipment and it's parcels.POST
- Group parcels into bags and link to a shipment, then prepare and submit shipment in one transaction.POST
- Delete shipment.DELETE
- Update shipment.PUT
- Get shipment details by shipment id.GET
- Query up to 500 shipments.GET
- Upload shipment manifest file.POST
- Upload shipment document.POST
- Get shipment details by shipment number.GET
- Cancel erroneous parcels in a shipment.
- Documents
- Download manifest file.
- Download shipment documents in archive file.
- Download shipment document file by Id.
- Download parcel label by Id.
- Generate and download generic bag labels.
- Generate and download bag label.
- Download resulting (processed) manifest file.
- Generate and download shipment parcel labels.
- Generate and download parcel commercial invoices.
- Download resulting (processed) shipment file.
- Tracking
- Fetch up to 500 tracking events in cursor fashion.
- Get event codes and other metadata.
- Get tracking events by the list of parcel numbers, up to 50, comma separated.
- Get tracking events by the list of sender reference numbers, up to 50, comma separated.
- Get tracking events by the list of parcel numbers or sender reference numbers, up to 50, comma separated.
- Get bag tracking events by the list of bag numbers, up to 50, comma separated.
- Get bag tracking events by the list of bag numbers or shipment numbers, up to 50, comma separated.
- Upload tracking events file.
- Accounts
- Integrations
- Schemas
- Schemas
- AccountInfo
- CreateAndClosePostalDispatchByShipmentRequest
- CreateMailTransitConsignmentByShipmentRequest
- CreateTrackingIntegrationEventsRequest
- DataSource
- DeleteManifestFileRequest
- DeleteManyParcelsRequest
- DeleteShipmentRequest
- DownloadResultingManifestFileRequest
- DownloadResultingShipmentFileRequest
- GenerateShipmentParcelPrintsRequest
- GetAccountDetailsRequest
- GetEventsBatchRequest
- GetManyEventsByBagNrsRequest
- GetManyEventsByParcelNrsRequest
- GetManyEventsBySenderParcelNrsRequest
- GetManyParcelPrintsRequest
- GetManyParcelsByCarrierParcelNrsRequest
- GetManyParcelsByIdsRequest
- GetManyParcelsByManifestParcelNrsRequest
- GetManyParcelsByParcelNrsRequest
- GetManyParcelsBySenderParcelNrsRequest
- GetParcelByIdRequest
- GetParcelByCarrierParcelNrRequest
- GetParcelByParcelNrRequest
- GetParcelBySenderParcelNrRequest
- GetParcelByManifestParcelNrRequest
- GetParcelPrintRequest
- GetPostalConsignmentDetailsRequest
- GetPostalConsignmentDetailsResponse
- GetPostalDispatchDetailsRequest
- GetPostalDispatchDetailsResponse
- GetShipmentDetailsRequest
- PostalConsignmentInfo
- PostalConsignmentStatus
- PostalDespatchReceptacleStatus
- PostalDespatchStatus
- PostalDispatchInfo
- PostalDocumentCategory
- PostalDocumentInfo
- PostalDocumentStatus
- PostalDocumentType
- PostalReceptacleInfo
- PostalReceptacleOutboundBagInfo
- PostalReceptacleParcelInfo
- PostalRouteInfo
- QueryAccountsRequest
- QueryAccountsResponse
- QueryParcelsRequest
- QueryPickupPointsRequest
- QueryPostalConsignmentsRequest
- QueryPostalConsignmentsResponse
- QueryPostalDispatchesRequest
- QueryPostalDispatchesResponse
- QueryShipmentsRequest
- ResolveHsCodesByDescriptionsRequest
- SearchManyBagEventsRequest
- SearchManyParcelEventsRequest
- TransportModeType
- UploadManifestFileRequest
- AccountAddressType
- AccountCommonSettings
- AccountSettingsAddressInfo
- AddressInfo
- AddTrackingEventsRequest
- BagEventsResponse
- BagPrintInfo
- BagPrintType
- BagStatus
- BagTrackingEventInfo
- BagViewInfo
- CancelShipmentParcelsWithErrorsRequest
- ContainerType
- CreateBagLevelShipmentRequest
- CreateIntegrationEventsRequest
- CreateOrUpdateManyParcelsRequest
- CreateOrUpdateParcelAdditionalInfo
- IncludePrintSizes
- CreateOrUpdateParcelIdentifiers
- LabelSize
- CreateOrUpdateParcelInfo
- CreateOrUpdateParcelItemInfo
- CreateOrUpdateParcelReceiverInfo
- CreateOrUpdateParcelReferences
- CreateOrUpdateParcelRequest
- CreateOrUpdateParcelSenderInfo
- CreateOrUpdateParcelStatusInfo
- CreateOrUpdateSingleParcelRequest
- CreateShipmentRequest
- CustomsSettings
- DeleteParcelRequest
- DownloadBagPrintRequest
- DownloadManifestFileRequest
- DownloadParcelPrintRequest
- DownloadShipmentDocumentRequest
- DownloadShipmentDocumentsRequest
- EmaiNotificationsInfo
- EmaiNotificationsSettings
- EventCodeInfo
- FileFormat
- FileStatus
- GenerateBagPrintsRequest
- GenerateParcelCommercialInvoicesRequest
- GenerateParcelCommercialInvoicesResponse
- ParcelLinkResultInfo
- ParcelValidationSettings
- GenerateShipmentParcelPrintsResponse
- GetAccountDetailsResponse
- GetCurrentAccountDetailsRequest
- GetEventsBatchResponse
- GetManyParcelPrintsResponse
- GetPickupPointDetailsRequest
- GetPickupPointDetailsResponse
- GetShipmentDetailsResponse
- LabelsSettings
- LeanMileSettings
- LinkBagsToShipmentRequest
- MailType
- ManifestAndSubmitShipmentParcelInfo
- ManifestAndSubmitShipmentRequest
- ManifestAndSubmitShipmentResponse
- ManifestFileType
- ManifestFileViewInfo
- ManyParcelsDetailsResponse
- NewIntegrationEvent
- NewTrackingEvent
- ParcelAdditionalInfo
- ParcelAndTrackingEventInfo
- ParcelCommercialInvoiceInfo
- ParcelDetailsResponse
- ParcelDocument
- ParcelDocumentType
- LinkBagsToShipmentResponse
- ParcelEventsResponse
- ParcelIdentifiers
- ParcelInfo
- ParcelItemInfo
- ParcelNrSequenceInfo
- ParcelNrType
- ParcelPrintFormat
- ParcelPrintInfo
- UpdateManyParcelReferencesResponse
- ParcelPrintType
- ParcelReceiverInfo
- ParcelReferences
- ParcelSenderInfo
- ParcelStatus
- ParcelStatusInfo
- ParcelTransactionType
- PickupPointInfo
- PickupPointType
- PostalLabelSettings
- PostalSettings
- PrepareShipmentRequest
- PrepareShipmentResponse
- QstepSettings
- QueryParcelsResponse
- QueryPickupPointsResponse
- QueryShipmentsResponse
- RateManagementSettings
- SearchBagEventsResponse
- ResendOrRelabelParcelRequest
- SearchParcelEventsResponse
- ShipmentArrivalInfo
- ShipmentArrivalViewInfo
- ShipmentDocumentType
- ShipmentDocumentViewInfo
- ShipmentManifestLevel
- ShipmentManifestSettings
- ShipmentStatus
- ShipmentStatusInfo
- ShipmentTerminalInfo
- ShipmentType
- ShipmentViewInfo
- SubmitShipmentRequest
- TaxType
- TelemetrySettings
- TrackingEventInfo
- TrackingParcelInfo
- UpdateBagLevelShipmentRequest
- UpdateManyParcelReferencesRequest
- UpdateShipmentRequest
- UploadManifestFileResponse
- UploadShipmentDocumentResponse
- UploadTrackingEventsFileResponse
- UpsertBagRequest
- X7TradeSettings
- Schemas
Create new shipment.
POST
https://api.test.post-plus.io/api/v1/shipments
Request
Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************or
Header Params
Body Params application/json-patch+json
Example
{
"arrivalInfo": {
"arrivalGateway": "string",
"transportNr": "string",
"originCountryCode": "string",
"totalWeight": 0,
"totalBags": 0,
"arrivalOn": "2019-08-24T14:15:22Z",
"notes": "string"
},
"type": "string",
"shipmentNr": "123-000000123",
"masterNr": "string",
"terminalCode": "string",
"updateIfExists": true
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.test.post-plus.io/api/v1/shipments' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"arrivalInfo": {
"arrivalGateway": "string",
"transportNr": "string",
"originCountryCode": "string",
"totalWeight": 0,
"totalBags": 0,
"arrivalOn": "2019-08-24T14:15:22Z",
"notes": "string"
},
"type": "string",
"shipmentNr": "123-000000123",
"masterNr": "string",
"terminalCode": "string",
"updateIfExists": true
}'Responses
🟢200OK
application/json
Body
Example
{
"status": {
"status": "Imported",
"hasErrors": true,
"hasWarnings": true,
"canUpdate": true,
"canUpdateArrivalInfoAndShipmentNr": true,
"canPrepare": true,
"canSubmit": true,
"createdOn": "2019-08-24T14:15:22Z",
"submittedOn": "2019-08-24T14:15:22Z",
"errorDetails": [
"string"
],
"warningDetails": [
"string"
]
},
"arrivalInfo": {
"arrivalGateway": "string",
"transportNr": "string",
"originCountryCode": "string",
"totalWeight": 0,
"totalBags": 0,
"arrivalOn": "2019-08-24T14:15:22Z",
"notes": "string"
},
"type": "VirtualDespatch",
"transactionType": "B2C",
"manifestLevel": "Parcel",
"id": 0,
"shipmentNr": "string",
"masterNr": "string",
"terminalCode": "string",
"totalItems": 0,
"totalItemsCancelled": 0,
"totalWeight": 0,
"totalWeightCancelled": 0,
"totalBags": 0,
"parcelWarnings": 0,
"parcelErrors": 0
}