CPL API
Užitečné odkazy
  • Developer
  • Sandbox
Užitečné odkazy
  • Developer
  • Sandbox
Switch to english
  1. Shipment
  • Back to home
  • API Metody
  • AccessPoint
    • Seznam výdejních míst
  • AddressWhisper
    • Našeptávač adres
  • Codelist
    • Číselník pro službu kontroly věku příjemce
    • Číselník produktů
    • Číselník typů externích čísel
    • Číselník zemí + povolení COD
    • Číselník povolených měn
    • Metoda pro získání poskytovaných služeb k zásilkám.
    • Metoda pro získání minimálních a maximálních hodnot u služeb
    • Fáze zásilky
    • Statusy zásilky /shipment
    • Chybové hlášení
    • Typy osobních dokladů
  • Customer
    • Informace k zákazníkovi – povolené měny
    • Zákazníkovy adresy
  • Info
    • info
  • Order
    • Získání informace o objednávce přepravy
  • OrderBatch
    • Slouží k vytvoření objednávky. Odpověď je v header (Location)
    • Získaní stavu objednávky
  • OrderEvent
    • Zrušení objednání svozu nebo balíku z libovolné adresy
  • Shipment
    • Slouží k získání informací (trackingu) k zásilce
      GET
  • ShipmentBatch
    • Vytvoření zásilky
    • Slouží k úpravě výstupního formátu štítku
    • Získání stavu importu zásilky
    • Získání etikety
  • ShipmentEvent
    • storno zásilky
    • úprava kontaktu
  • VersionInformation
    • informace o novinkách
  1. Shipment

Slouží k získání informací (trackingu) k zásilce

GET
/shipment
Shipment
Maintainer:Not configured

Request

Query Params
ShipmentNumbers
array[string]
optional
Čísla zásilek
<= 50 items
InvoiceNumbers
array[string]
optional
Čísla zakázek
<= 50 items
CustomerReferences
array[string]
optional
Zákaznická reference
<= 50 items
VariableSymbols
array[string]
optional
Variabilní symbol
<= 50 items
DateFrom
string <date-time>
optional
Datum od
DateTo
string <date-time>
optional
Datum do
ShipmentStates
enum<string> 
optional
Stavy zásilek
Allowed values:
NoneUndeliveredDeliveredPickedUpFromSenderDeliveredToPickupPointOutForDeliveryNotDeliveredCodPaidDateBackToSenderRejectedDataShipmentActiveCanceledDormant
Limit
integer <int32>
required
>= 1<= 1000
Offset
integer <int32>
required
>= 0
Header Params
Accept-Language
string 
optional
Language specification, default language: cs-CZ
X-Correlation-ID
string 
optional
Correlation Id of request
X-LogLevel
enum<string> 
optional
The forced log level
Allowed values:
TraceDebugInformationWarningErrorCritical

Request 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 GET '/shipment?ShipmentNumbers&InvoiceNumbers&CustomerReferences&VariableSymbols&DateFrom&DateTo&ShipmentStates&Limit&Offset' \
--header 'Accept-Language;' \
--header 'X-Correlation-ID;' \
--header 'X-LogLevel;'

Responses

🟢200OK
application/json
Success
Headers
X-Correlation-ID
string 
optional
Correlation Id of request otherwise id of response
X-Paging-Total-Items-Count
string 
optional
Total items in result
X-Paging-Offset
string 
optional
Paging offset
X-Paging-Limit
string 
optional
Page size
Body
array of:
shipmentNumber
string  | null 
optional
Číslo zásilky
productType
string  | null 
optional
Typ produktu viz /codelist/product
note
string  | null 
optional
Poznámka
depot
string  | null 
optional
Sklad
integratorId
integer <int32> | null 
optional
IntegratorId
lastUpdateDate
string <date-time> | null 
optional
Datum poslední aktualizace
shipmentState
enum<string> 
optional
Stav zásilky
Allowed values:
NoneUndeliveredDeliveredPickedUpFromSenderDeliveredToPickupPointOutForDeliveryNotDeliveredCodPaidDateBackToSenderRejectedDataShipmentActiveCanceledDormant
shipmentSet
optional
One of
masterShipmentNumber
string  | null 
optional
Číslo nosné zásilky
shipmentsInSet
integer <int32>
optional
Počet zásilek v sadě
shipmentInSetNumber
integer <int32>
optional
Pozice zásilky v sadě
sender
optional
Odesílatel
One of
name
string  | null 
optional
Jméno
name2
string  | null 
optional
street
string  | null 
optional
Ulice
city
string  | null 
optional
Město
zipCode
string  | null 
optional
PSČ
country
string  | null 
optional
Země
contact
string  | null 
optional
Kontakt
phone
string  | null 
optional
Telefon
email
string  | null 
optional
Email
recipient
optional
Příjemce
One of
AddressBaseModel
name
string  | null 
optional
Name
name2
string  | null 
optional
Name2
street
string  | null 
optional
Street
city
string  | null 
optional
City
zipCode
string  | null 
optional
ZipCode
country
string  | null 
optional
Country
contact
string  | null 
optional
Contact
phone
string  | null 
optional
Phone
email
string  | null 
optional
Email
specificDelivery
optional
Specifické požadavky na doručení
One of
specificDeliveryDate
string <date-time> | null 
optional
Specifické datum doručení
specificDeliveryTimeFrom
string <date-span> | null 
optional
Specifický čas doručení -Od
specificDeliveryTimeTo
string <date-span> | null 
optional
Specifický čas doručení -Do
specificTakeDate
string <date-time> | null 
optional
Specifické datum převzetí
specificTakeTimeFrom
string <date-span> | null 
optional
Specifické datum převzetí -Od
specificTakeTimeTo
string <date-span> | null 
optional
Specifické datum převzetí -Do
accessPointCode
string  | null 
optional
1.
ProductType pouze PRIV, PRID, CONN, COND, SMAR, SMAD !!
2.
Validace proti seznamu, který vrací metoda AccessPoint
externalNumbers
array [object {2}]  | null 
optional
Externí čísla
externalNumber
string  | null 
optional
Externí číslo
code
string  | null 
optional
Kód externího čísla
services
array [object {4}]  | null 
optional
Služby
additionalParameters
array [object]  | null 
optional
Další parametry
code
string  | null 
optional
Kód
price
number <double> | null 
optional
Cena
priceCurrency
string  | null 
optional
Měna
trackAndTrace
optional
Trackování zásilky
One of
externalShipmentId
string  | null 
optional
Externí číslo zásilky -platí pro zahraniční zásilky
partnerUrl
string  | null 
optional
Trackovací URL
lastEventCode
string  | null 
optional
Kód poslední události
lastEventDate
string <date-time> | null 
optional
Datum poslední události
lastEventName
string  | null 
optional
Jméno poslední události
events
array [object]  | null 
optional
události při trackování zásilky
shipmentWeightInfo
optional
Informace o hmotnosti
One of
weight
number <double> | null 
optional
hmotnost
weighedDate
string <date-time> | null 
optional
datum vážení
paymentInfo
optional
Informace o platbě
One of
paidByCard
boolean 
optional
true/false určení zda je platba kartou
codPaidDate
string <date-time> | null 
optional
datum zaplacení dobírky
invoiceNumber
string  | null 
optional
číslo faktury
bankAccount
string  | null 
optional
bankovní účet
bankCode
string  | null 
optional
bankovní kód
codBankStatementDate
string <date-time> | null 
optional
codCurrency
string  | null 
optional
měna dobírky
codPaymentAccDate
string <date-time> | null 
optional
codPrice
number <double> | null 
optional
cena
codVariableSymbol
string  | null 
optional
variabilní symbol dobírky
specificSymbol
string  | null 
optional
specifický symbol
deliveryFeature
optional
One of
loadDate
string <date-time> | null 
optional
Datum naložení zásilky pro doručení
delivDate
string <date-time> | null 
optional
Datum doručení
delivPerson
string  | null 
optional
Příjemce
notDelivDate
string <date-time> | null 
optional
Datum nedoručení
outDepDate
string <date-time> | null 
optional
Přijetí na doručovací depo
hubDate
string <date-time> | null 
optional
Příjem na centrálu
deliveryToAccessPoint
boolean 
optional
True/false určení zda bude zásilka doručena na výdejní místo
backShipmentFeature
optional
One of
backDate
string <date-time> | null 
optional
Datum odeslání zpět
dormantShipmentFeature
optional
One of
dormantShipmentNumber
string  | null 
optional
Číslo zpětné zásilky
dormantShipmentNumberActive
boolean  | null 
optional
true/false informuje zda je zpětná zásilka aktivní
accessPointFeature
optional
One of
accessPointDaysInStorage
integer <int32> | null 
optional
Počet dnů na výdejním místě
accessPointDaysInStorageRemain
integer <int32> | null 
optional
Počet zbyvajících dnů uložení zásilky na výdejním místě
accessPointHoursInStorageRemain
integer <int32> | null 
optional
Počet zbyvajících hodin uložení zásilky na výdejním místě
routingFeature
optional
One of
routingNumber
string  | null 
optional
Číslo trasy
Example
[
  {
    "shipmentNumber": "string",
    "productType": "string",
    "note": "string",
    "depot": "string",
    "integratorId": 0,
    "lastUpdateDate": "2019-08-24T14:15:22Z",
    "shipmentState": "None",
    "shipmentSet": {
      "masterShipmentNumber": "string",
      "shipmentsInSet": 0,
      "shipmentInSetNumber": 0
    },
    "sender": {
      "name": "string",
      "name2": "string",
      "street": "string",
      "city": "string",
      "zipCode": "string",
      "country": "string",
      "contact": "string",
      "phone": "string",
      "email": "string"
    },
    "recipient": {
      "name": "string",
      "name2": "string",
      "street": "string",
      "city": "string",
      "zipCode": "string",
      "country": "string",
      "contact": "string",
      "phone": "string",
      "email": "string"
    },
    "specificDelivery": {
      "specificDeliveryDate": "2019-08-24T14:15:22Z",
      "specificDeliveryTimeFrom": "string",
      "specificDeliveryTimeTo": "string",
      "specificTakeDate": "2019-08-24T14:15:22Z",
      "specificTakeTimeFrom": "string",
      "specificTakeTimeTo": "string",
      "accessPointCode": "string"
    },
    "externalNumbers": [
      {
        "externalNumber": "string",
        "code": "string"
      }
    ],
    "services": [
      {
        "additionalParameters": [
          {}
        ],
        "code": "string",
        "price": 0,
        "priceCurrency": "string"
      }
    ],
    "trackAndTrace": {
      "externalShipmentId": "string",
      "partnerUrl": "string",
      "lastEventCode": "string",
      "lastEventDate": "2019-08-24T14:15:22Z",
      "lastEventName": "string",
      "events": [
        {}
      ]
    },
    "shipmentWeightInfo": {
      "weight": 0,
      "weighedDate": "2019-08-24T14:15:22Z"
    },
    "paymentInfo": {
      "paidByCard": true,
      "codPaidDate": "2019-08-24T14:15:22Z",
      "invoiceNumber": "string",
      "bankAccount": "string",
      "bankCode": "string",
      "codBankStatementDate": "2019-08-24T14:15:22Z",
      "codCurrency": "string",
      "codPaymentAccDate": "2019-08-24T14:15:22Z",
      "codPrice": 0,
      "codVariableSymbol": "string",
      "specificSymbol": "string"
    },
    "deliveryFeature": {
      "loadDate": "2019-08-24T14:15:22Z",
      "delivDate": "2019-08-24T14:15:22Z",
      "delivPerson": "string",
      "notDelivDate": "2019-08-24T14:15:22Z",
      "outDepDate": "2019-08-24T14:15:22Z",
      "hubDate": "2019-08-24T14:15:22Z",
      "deliveryToAccessPoint": true
    },
    "backShipmentFeature": {
      "backDate": "2019-08-24T14:15:22Z"
    },
    "dormantShipmentFeature": {
      "dormantShipmentNumber": "string",
      "dormantShipmentNumberActive": true
    },
    "accessPointFeature": {
      "accessPointDaysInStorage": 0,
      "accessPointDaysInStorageRemain": 0,
      "accessPointHoursInStorageRemain": 0
    },
    "routingFeature": {
      "routingNumber": "string"
    }
  }
]
🟠400Bad Request
🟠404Record Not Found
🔴500Server Error
🔴503Service Unavailable
Modified at 2025-02-04 09:15:19
Previous
Zrušení objednání svozu nebo balíku z libovolné adresy
Next
ShipmentBatch
Built with