Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Qargo Use case / Subcontractor dispatch API

Required api role: not applicable (push/push)Purpose: This interface allows an external party to integrate with 3rd party transport management systems for subcontracting.The subcontractor dispatch uses a push/push model: Qargo pushes a dispatch payload to an external endpoint.The third party then updates Qargo using our webhook endpoint:![dispatch flow](/docs/static/subco_dispatch_flow.svg)Subsequent updates or cancellations will also be sent via this webhook, using the same payload format.The dispatch format has the following structure:![dispatch payload](/docs/static/dispatch_subco_payload.svg)The destination of this webhook can be a RESTful interface or file base protocol like SFTPThe [status update endpoint](/docs/use-case-subcontractor-dispatch/subcontractor-status-update-webhook) can be used to receive information about the stops back to Qargo.Status update date-time values, including `event_time`, `eta_start`, and `eta_end`, must include a timezone offset such as `Z` or `+02:00`.

Qargo Use case / Subcontractor dispatch API is one of 26 APIs that Qargo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Use case / Subcontractor dispatch. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 3 operations across 3 paths, and defines 104 schemas. It is described by OpenAPI 3.1.0, at version 1.2.0.

Requests are made against a single base URL, https://api.qargo.com.

3 operations 3 paths 104 schemas 3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.2.0
Base URL
https://api.qargo.com
Authentication
OAuth 2.0, HTTP Basic
Resource Areas
1

Authentication & Security 2

Qargo Use case / Subcontractor dispatch API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (oAuth2ClientCredentials) using the clientCredentials flow. It accepts HTTP basic authentication (BasicAuthWebhookCredentials).

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 POST. Each is listed below with its method, path, parameters, and response codes.

Use case / Subcontractor dispatch 3

Required api role: not applicable (push/push) Purpose: This interface allows an external party to integrate with 3rd party transport management systems for subcontracting. The sub…

POST
/v1/webhook/subco-document-upload
External Document Update With Payload
subcontractor-document-upload-webhook 2 params body → 200400401403422429500503
POST
/v1/webhook/subco-status-update
External Status Update
subcontractor-status-update-webhook body → 200400401403422429500503
POST
https://
Subcontractor Dispatch Payload
subcontractor-dispatch-payload body → 200400401403422429500503

Schemas 104

The contract defines 104 schemas that model the data the API accepts and returns. The most detailed are DispatchOrder (30 properties), GoodOutput-Input (28 properties), CompanyOutput-Input (21 properties), StopOutput-Input (19 properties). Each schema is shown below with its type and property counts.

AdditionalExportBorderProcessEnum
string
Incoterm
string
HSCode
object
2 properties
ServiceLevel
object
3 properties
OrderMatch
object
3 properties
DispatchOrder
object
30 properties 3 required
AdditionalImportBorderProcessEnum
string
StopMatch
object
2 properties
ConsignmentOutput-Input
object
17 properties 3 required
BasePaymentTerm
object
1 property 1 required
ConsignmentMatch
object
2 properties
ValidationErrorResponse
object
2 properties 2 required
TimeWindow
object
7 properties
StopStatusUpdateEnum
string
VehicleResource-Input
object
17 properties
GenericResource-Input
object
8 properties
Department
object
2 properties
ImportDeclarationTypeEnum
string
StopOutput-Input
object
19 properties 2 required
KuehneNagelExtraFields
object
2 properties
ContainerResource-Input
object
13 properties
HTTPValidationError
object
1 property
ResourceTypeEnum
string
ADR-Input
object
14 properties
PackagedItemCommercialInvoiceExtraField
object
1 property
StopMatchTarget
object
1 property
TransporeonOrderExtraFields
object
2 properties
TaxTypeEnum
string
ContainerScenario
string
ConsignmentCustomsTransitInfoOutput
object
9 properties 2 required
ADRPhysicalState
string
PalletforceConsignmentExtraFields
object
1 property
BaseStatusUpdate
object
2 properties 2 required
BuyerSellerCompanyOutput-Input
object
10 properties 2 required
ConsignmentTransportNetwork
object
3 properties
ContainerType
object
4 properties
PackagingSize
object
8 properties
ValidationError
object
3 properties 3 required
ImportExportExtraFields
object
3 properties
StopType
string
PackagedItemOutput-Input
object
14 properties 1 required
ADRPackagingType
string
PalletlineConsignmentExtraFields
object
1 property
PalletlineExtraFields
object
1 property
TransporeonConsignmentExtraFields
object
1 property
ResourceAllocation-Input
object
1 property 1 required
ErrorStatus
object
2 properties 1 required
AdditionalTransitBorderProcessEnum
string
CustomerStatus
string
PackagedItemsImportExportExtraFields
object
7 properties
ExtraField
object
3 properties
DachserExtraFields
object
1 property
VehicleCategory
object
3 properties
TransitOffice
object
1 property
PalletforceExtraFields
object
5 properties
ConsignmentCustomsExportInfo
object
8 properties
ErrorType
string
SubcontractorStatusUpdatePayload
object
1 property 1 required
FieldMatchInput
object
1 property
PackagingType
object
5 properties
Entity
object
2 properties
CustomsMetadata
object
1 property
SubcontractorDispatch
object
2 properties 2 required
BarcodeOutput
object
2 properties
DispatchOperation
string
HandlingUnitOutput-Input
object
2 properties 1 required
StopMatchInput
object
4 properties
Product
object
4 properties
ExportDeclarationTypeEnum
string
ContactType
string
PaymentTermCode
string
BankAccount
object
2 properties
Position
object
2 properties 2 required
LocationWithTerminalOutput-Input
object
15 properties
TerminalMetadata
object
5 properties
DriverResource-Input
object
16 properties
CentralTransportNetworkConsignmentExtraFields
object
3 properties
SubcontractorDispatchResponse
object
Response schema for the subcontractor dispatch payload. This schema is used to return errors or success messages.
1 property
ConsignmentImportExportExtraFieldsOutput-Input
object
4 properties
SignatureType
string
ValidationErrorDetail
object
4 properties 1 required
TransitDeclarationTypeEnum
string
LocationOutput
object
13 properties
GoodOutput-Input
object
28 properties 1 required
ADRType
string
SubcontractorDispatchOutput
object
6 properties 4 required
ConsignmentCommercialInvoiceExtraField
object
3 properties
ConsignmentBuyerSellerOutput-Input
object
2 properties
AmazonExtraFields
object
8 properties
Gateway
object
1 property 1 required
TripMatch
object
1 property
ConsignmentCustomsImportInfo
object
9 properties
Incident
object
4 properties
StopStatusUpdate
object
Update a stop from an external source. Can update status and data of a stop. Updates on the data happen based on the defined integrationdatamapping in the inte…
6 properties
CompanyContactOutput
object
6 properties
StopExtra
object
3 properties
CompanyOutput-Input
object
21 properties 3 required
CompanyReferenceNumbers
object
5 properties
Signature
object
4 properties 1 required
OrderPricingOutput
object
5 properties
ContainerExtraFields
object
15 properties
BarcodeSource
string
StopDepotOutput
object
8 properties
LocationReference
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

qargo-use-case-subcontractor-dispatch-api-openapi.yml Raw ↑

Other APIs Qargo publishes across the network.

Qargo Subcontractor API
Qargo Customer API
Qargo API / Accounting API
Qargo API / Authentication API
Qargo API / Company API
Qargo API / Document API
Qargo API / Order API
Qargo API / Resource API
Qargo API / Task API
Qargo API / Trip API
Qargo System API
Qargo Use case / Accounting API