Time Slot Control poskytuje programové rozhraní (API) pro integraci s externími systémy - ERP, WMS, BI nástroje a kamerové systémy. Veškerá komunikace probíhá výhradně přes HTTPS.
Programové rozhraní aplikace Time Slot Control nabízí dva rozdílné způsoby komunikace a využití:
Primární rozhraní pro integraci s ERP systémy. Umožňuje čtení i zápis dat - práci s entitami Company, Order a OrderRow. Specifikaci OData podporují nativně lídři trhu - Microsoft, SAP, CA Technologies, Citrix Systems, IBM, Red Hat a další.
Entita
Reservationje přes OData rovněž dostupná, ale pouze pro čtení a pro zápis poznámky / vlastních polí (ExtCustomFieldVarchar1-15,ExtCustomFieldBit1-3) přes bound akciPatch. Vytvoření rezervace nebo zápis polí jako dopravce, typ vozidla, řidič či registrační značky přes OData nelze - použijte místo toho REST v3 koncové body níže.
Více informací: https://www.odata.org/
Specifické rozhraní pro tři účely:
Endpoint: POST /v3/{tenant}/Reservations
Tělo požadavku je přímý JSON objekt (bez wrapperu). Minimální povinná pole:
ResourceId
Guid
Start
DateTimeOffset
2026-04-15T08:00:00Z)UnitId
Guid
NumberOfUnits
int
Nepovinná pole pro dopravce / vozidlo / řidiče:
CarrierId
Guid
Carrier
string
CarrierDriverFullName
string
VehicleTypeId
Guid
VehicleNumberPlate
string
TrailerNumberPlate
string
Příklad volání (cURL s Basic auth):
curl -X POST "https://api.tscsandbox.com/v3/{tenant}/Reservations" \
-H "Content-Type: application/json" \
-u "api@vasedomena.com:heslo" \
-d '{
"ResourceId": "<resource-guid>",
"Start": "2026-04-15T08:00:00Z",
"UnitId": "<unit-guid>",
"NumberOfUnits": 10,
"CarrierId": "<carrier-guid>",
"CarrierDriverFullName": "Jan Novák",
"VehicleTypeId": "<vehicletype-guid>",
"VehicleNumberPlate": "1AB2345",
"TrailerNumberPlate": "1CD6789"
}'
Endpoint: PUT /v3/{tenant}/Reservations/{id}
Na rozdíl od OData akce Patch (omezené jen na poznámku a vlastní pole) tento endpoint přijímá celou sadu polí rezervace uvedenou výše, včetně dopravce, řidiče, typu vozidla a registračních značek.
curl -X PUT "https://api.tscsandbox.com/v3/{tenant}/Reservations/<reservation-guid>" \
-H "Content-Type: application/json" \
-u "api@vasedomena.com:heslo" \
-d '{
"CarrierId": "<carrier-guid>",
"CarrierDriverFullName": "Jan Novák",
"VehicleTypeId": "<vehicletype-guid>",
"VehicleNumberPlate": "1AB2345",
"TrailerNumberPlate": "1CD6789"
}'
Převod entit Order na rezervaci (obdoba ručního přetažení objednávek z košíku zakázek na plán v uživatelském rozhraní) se po vytvoření objednávek přes OData neprovede automaticky - je potřeba jej vyvolat explicitně, buď v UI, nebo přes tento endpoint:
Endpoint: POST /v3/{tenant}/Reservations/CreateFromOrders
OrderIds
Guid[]
ResourceId
Guid
Date
DateTimeOffset
CarrierId, VehicleTypeId, VehicleNumberPlate a další pole dopravce/vozidla z endpointu pro vytvoření rezervace lze zadat i zde. Po úspěšném volání se u příslušných objednávek nastaví ExistsInReservation = true a nová rezervace se objeví na plánu u dané rampy a času.
Úplný a aktuální seznam parametrů všech tří endpointů najdete v interaktivní API Reference (Scalar UI) - podrobnosti viz stránka o OData.
Aplikace Time Slot Control nabízí dvě prostředí - pro webovou aplikaci i pro API:
Sandbox prostředí je jednorázovou kopií produkce. Má deaktivované e-mailové a SMS notifikace - nedochází k matení uživatelů. Je ideální pro vývoj a testování integrace bez dopadu na produkci.
Sandbox není průběžně synchronizován s produkcí - jde o kopii vytvořenou v čase jeho zakládání.