Schemas
RecipientAddress
RecipientNameName of the recipient
StreetStreet address
ZipCodeZIP code
CityCity name
CountryCodeISO country code (2 letters)
CompanyNameName of the company
StreetDetailAdditional street details
PhonePhone number
EmailEmail address
ParcelShopIdRequired if you want to send shipment to parcel shop
Shipment
TotalPriceValue of shipment
CurrencyCurrency code
ShippingDateDate of shipment pickup by courier (format yyyy-MM-dd)
NoteNote for the shipment
DriverNoteNote for the driver
PackageDescriptionDescription of items inside package
CodPrice
ValueValue of cash on delivery
CurrencyCurrency of cash on delivery
VariableSymbolVariable symbol of payment cash on delivery
Notifications
EmailEnable email notifications
PhoneEnable phone notifications
SmsEnable SMS notifications
Package
WeightWeight of package in the unit specified by WeightUnit (kilograms when WeightUnit is omitted)
WeightUnitUnit of the Weight field. When omitted, Weight is interpreted in kilograms.
CoverPackage cover type
VolumeVolume of package
WidthWidth of package in the unit specified by DimensionUnit
HeightHeight of package in the unit specified by DimensionUnit
LengthLength of package in the unit specified by DimensionUnit
DimensionUnitUnit of the Width, Height and Length fields. When omitted, the courier's default unit applies (centimeters for most couriers).
List of ADR (dangerous goods) items in the package
AdrItem
UnNumber^\d+$ · requiredUN number identifying the dangerous substance or article
WeightWeight of the dangerous goods in kilograms
NumberOfPiecesNumber of pieces containing this dangerous good
VolumeVolume of the dangerous goods in liters
ProperShippingNameOfficial shipping name of the dangerous goods
PackingGroupUN packing group indicating the degree of danger
PackageTypeType of packaging used for the dangerous goods
AdrClassADR hazard class (e.g. "3", "4.1")
LimitedQuantityWhether the goods are shipped as limited quantity
EnvironmentallyHazardousWhether the goods are environmentally hazardous
EmptyContainerWhether this is an empty uncleaned container
TechnicalNameTechnical chemical name of the dangerous goods
NetExplosiveMassNet explosive mass in kilograms (for class 1 goods)
TunnelCodeADR tunnel restriction code (e.g. "C/D", "E")
ShippingOrder
ReferenceNumberUnique value that identify entity in the application Chameleoon
ExternalReferenceReference that identify entity in your system
ReferenceSourceOptional. System the shipment is attributed to. Defaults to api when omitted, empty or blank, so existing integrations that never send this field are unaffected. Notification triggers, statistics attribution and order-state synchronization back to your e-shop or ERP are keyed on the ReferenceSource + SourceIdentifier pair, so set it when you want a shipment routed as if it originated in one of your connected systems. Use the identifier of a source connected to your account (see GET /configurations/sources).
The pair is validated against the sources activated on your account (see GET /configurations/sources); a pair that matches none of them is rejected with 422. The values must match the configured source and profile ids exactly, casing included. The pair api / default is always accepted.
ReferenceSource and SourceIdentifier must be supplied together — send both or neither.
SourceIdentifierOptional. Identifier of the concrete instance of ReferenceSource, used to distinguish several instances of the same source (for example two e-shops on the same platform). Defaults to default when omitted, empty or blank.
ReferenceSource and SourceIdentifier must be supplied together — send both or neither.
ShippingOrderResponse
idID of shipping order
referenceNumberReference number of shipping order
externalReferenceExternal reference
referenceSourceSource of data
sourceIdentifierSource identifier
courierID of courier
courierProfileID of courier profile
shippingNumberShipping numbers returned by courier
createdDate and time when shipping order was created (format yyyy-MM-ddTHH:mm:ss)
codPriceShipmentTracking
stateCurrent state of shipment (created, shipping, ready_for_pickup, ready_for_pickup_2_days, not_delivered, delivered, returned, unknown)
TrackingHistoryItem
codeTracking code from courier
textTracking message
dateDate and time of tracking event (format yyyy-MM-ddTHH:mm:ss)
stateState of shipment at this point
ValidationResult
statusStatus of validation result, one of OK, WARNING, ERROR
referenceNumberReference number of sent shipping order
ValidationMessage
statusStatus of validation item result, one of WARNING, ERROR
propertyName of invalid attribute
messageValidation message
SuccessUploadItem
idID of shipping order
referenceNumberReference number of shipping order
referenceSourceSource of data
shippingNumbersShipping numbers returned by courier
propertiesAdditional properties
FailedUploadItem
referenceNumberReference number of shipping order
referenceSourceSource of data
errorCodeError code
originalMessageMessage returned by courier API
errorMessageRewritten error message, can be same as originalMessage
informationPagedList
pageCurrent page number
pageSizeNumber of items per page
totalPagesTotal number of pages
nextPageIndicates if there is a next page
previousPageIndicates if there is a previous page
itemsCountTotal number of items
Array of result items
CourierFeatures
createPickupIndicates whether the courier allows the creation of an order pickup
printManifestIndicates whether the courier allows the printing of a shipment manifest
ConfigurationProfile
idThe ID of the configuration
titleA user-friendly name for the configuration
SourceConfiguration
idThe ID of the source — send this as ReferenceSource
Instances of this source configured on the account
PickupItem
shippingOrderIdID of shipping order
referenceNumberReference number
referenceSourceSource of reference
sourceIdentifierSource identifier
courierIdID of courier
profileConfiguration profile
shippingNumberShipping number
addresseeName of addressee
streetStreet address
cityCity
zipCodeZIP code
paymentTypePayment type
variableSymbolVariable symbol
totalPriceCurrencyCurrency of total price
totalPriceTotal price
codPriceCurrencyCurrency of COD price
codPriceCOD price
hasPickupIndicates if pickup was created
createdAtDate and time when shipping order was created (format yyyy-MM-ddTHH:mm:ss)
PickupRequest
ShippingNumbersList of shipping numbers, all of which must belong to the same courier
ShippingLabelRequest
PositionPosition on the page
FormatLabel format (a4)
ShippingNumbersList of shipping numbers
PrinterIdID of the printer. If provided, the label will be printed on the specified printer.
ProblemDetails
titleA short, human-readable summary of the problem
statusThe HTTP status code
detailA human-readable explanation of the problem
instanceA URI reference that identifies the specific occurrence of the problem
requestIdUnique request identifier
errorsAdditional error details