Číselníky, výdejní místa a pomocné metody

Číselníky

GET /codelists/{name}?limit=1000&offset=0 → GET codelist/{name} v PPL. Podporované názvy:

Název	Obsah
`product`	produkty/služby (BUSS, PRIV, COPL, ...)
`country`	země + povolení dobírky (COD)
`currency`	povolené měny
`service`	doplňkové služby k zásilkám
`servicePriceLimit`	min/max hodnoty služeb (dobírka, připojištění)
`ageCheck`	varianty kontroly věku příjemce (15/18+)
`externalNumber`	typy externích čísel (např. CUST)
`shipmentPhase`	fáze zásilky
`status`	statusy zásilky (tracking)
`validationMessage`	chybové kódy a hlášení
`proofOfIdentityType`	typy osobních dokladů
`documentFileType`	typy dokumentů (celní dokumenty)

Stránkování se předává v hlavičkách X-Paging-Total-Items-Count, X-Paging-Offset, X-Paging-Limit.

Výdejní místa

GET /access-points?countryCode=CZ&limit=100&offset=0 → GET accessPoint. Filtry: zipCode, city, accessPointCode, accessPointTypes (ParcelShop/ParcelBox/AlzaBox), GPS latitude+longitude+radius (km), pickupEnabled, activeCardPayment, activeCashPayment, sizes (S/M/L/XL). Odpověď: adresa, otevírací doba, GPS, kapacity dle velikostí.

Našeptávač adres

GET /address-whisper?street=...&city=...&zipCode=...&calledFrom=Street → GET addressWhisper. Vrací kandidáty adres vč. pole valid — vhodné pro validaci adresy před vytvořením zásilky.

Routing

GET /routing?country=CZ&zipCode=60200&... → GET routing. Vrací routeCode, depotCode, depotPosition, region, secondWave.

Zákazník

GET /customer → GET customer — bankovní účty (měny pro dobírku, SWIFT)
GET /customer/addresses → GET customer/address — registrované adresy
POST /customer/number-range → POST customer/numberRange — přidělení číselné řady zásilek {productType, quantity} → packNumberFrom/To

Ostatní

GET /cpl-info → GET info — stav/verze CPL API
GET /version-information → GET versionInformation — novinky API
GET /data/{dataGuid} → GET data/{dataGuid} — binární tisková data etikety

Generická proxy

/proxy/{cesta} (GET/POST/PUT/PATCH/DELETE) předá request 1:1 na CPL API s doplněným Bearer tokenem — pokrývá vše, co nemá typovaný endpoint, i budoucí metody. Příklad:

GET /proxy/codelist/product?Limit=10&Offset=0
POST /proxy/shipment/batch   (tělo 1:1 dle PPL dokumentace, bez transliterace)

2.6 KiB Raw Blame History