Perché OData v4?

OData (Open Data Protocol) è uno standard del settore supportato da Microsoft, SAP, IBM e Red Hat per la creazione e il consumo di API RESTful.

Standard del settore

Supportato da Microsoft, SAP, IBM e Red Hat — garanzia di stabilità a lungo termine e ampio supporto dell'ecosistema.

Supporto BI nativo

Connettività diretta con Power BI, Tableau ed Excel — nessun middleware necessario per reportistica e analisi.

Operazioni CRUD complete

Operazioni di creazione, lettura, aggiornamento ed eliminazione su aziende, ordini e articoli degli ordini con filtraggio e ordinamento avanzati.

Supporto IntegrationId

Collegate direttamente le chiavi primarie del vostro ERP — non è necessario prima recuperare gli ID interni di TSC, semplificando lo sviluppo dell'integrazione.

Integrazioni supportate

Collegate Time Slot Control con gli strumenti che la vostra organizzazione già utilizza.

SAP

Scambio dati bidirezionale con SAP ERP per l'elaborazione automatizzata degli ordini e la pianificazione logistica.

Power BI

Connettore OData nativo per dashboard in tempo reale, KPI e aggiornamento automatico dei report.

M3 (Infor)

Integrazione con Infor M3 per il coordinamento della logistica di produzione e distribuzione.

Business Central

Integrazione con Microsoft Dynamics 365 Business Central (ex Navision) per la logistica delle PMI.

Asseco Helios

Connessione con il diffuso sistema ERP ceco e slovacco per la sincronizzazione degli ordini.

Tableau

Fonte dati compatibile OData per analisi visive avanzate e dashboard interattive.

Microsoft Excel

Connessione diretta al feed dati OData per analisi ad-hoc e reportistica in Excel.

Timocom

Le aste di trasporto possono essere pubblicate sulla borsa carichi Timocom per raggiungere vettori al di fuori della vostra rete.

Sistemi di telecamere (LPR)

Interfaccia REST per la ricezione delle targhe da telecamere LPR di qualsiasi produttore – la base dell'Automatic Gate.

API a misura di sviluppatore

Tutto ciò di cui avete bisogno per costruire integrazioni robuste con sicurezza.

Ambiente sandbox

Copia completa della produzione per test sicuri — email e SMS disabilitati per evitare confusione agli utenti.

Modern Scalar UI

Playground API interattivo per esplorare gli endpoint, testare le query e prototipare le integrazioni.

Autenticazione sicura

Token JWT Bearer e autenticazione Basic — scegliete il metodo più adatto alla vostra infrastruttura.

Due ambienti

API di produzione su api.timeslotcontrol.com e sandbox su api.tscsandbox.com con endpoint identici.

Webhook in uscita

Configurate webhook per ricevere notifiche di eventi in tempo reale nei vostri sistemi — senza necessità di polling.

Documentazione e accesso per sviluppatori

Tutto ciò di cui il vostro IT ha bisogno per valutare l'integrazione è pubblico – senza NDA e senza incontri commerciali.

API Reference (Scalar)

Documentazione interattiva di 205 endpoint in 44 sezioni – Token, Reservation, Order, Company, Driver, Visitor e altri. Testate le chiamate direttamente nel browser sul sandbox.

Apri api.tscsandbox.com

Guida di riferimento all'API

Guida passo passo: creazione di un account API, ottenimento del token, le entità OData Company, Order e OrderRow e la procedura consigliata per l'integrazione con l'ERP.

Apri la guida sul wiki

Metadati OData

Descrizione leggibile dalle macchine di tutte le entità e i campi del vostro tenant all'indirizzo /odata/v1/{tenant}/$metadata – utilizzata da Power BI, Excel e dai generatori di client.

Come collegarsi da Excel e Power BI

Cosa ricevete e inviate tramite l'API

Company: Anagrafica delle aziende – vettori, fornitori, clienti, destinatari. Abbinamento con il vostro ERP tramite IntegrationId, senza dover ricercare ID interni.
Order / OrderRow: Ordini di trasporto e relative righe dall'ERP. Alimentano lo Stack of orders, da cui il vettore prenota senza ridigitare nulla.
Reservation: Prenotazioni di finestre orarie con stati, marche temporali e campi personalizzati. Creazione diretta da un sistema esterno tramite REST v3.
Workflow: Modifica programmatica dello stato della prenotazione: arrivo, inizio e fine della movimentazione, partenza – per collegare un WMS o la portineria.
LPR: Riceve le targhe lette dai sistemi di telecamere di qualsiasi produttore – arrivo e partenza del veicolo.
Callout (webhook): Chiama la vostra API al rilevamento di una targa o a ogni modifica di una prenotazione – senza polling.

Esempio: token e creazione di una prenotazione

Bastano due richieste. Il tenant è il nome della vostra istanza – per vostraazienda.timeslotcontrol.com è vostraazienda.

curl -X POST "https://api.tscsandbox.com/v1/{tenant}/Token"   -H "Content-Type: application/json"   -d '{"username": "api@yourcompany.com", "password": "..."}'

{ "token": "eyJhbGciOi..." }

curl -X POST "https://api.tscsandbox.com/v3/{tenant}/Reservations"   -H "Authorization: Bearer eyJhbGciOi..."   -H "Content-Type: application/json"   -d '{"ResourceId": "<resource-guid>",
       "Start": "2026-09-15T08:00:00Z",
       "UnitId": "<unit-guid>",
       "NumberOfUnits": 10}'

GET https://api.timeslotcontrol.com/odata/v1/{tenant}/$metadata

Dove scorrono i dati

Le linee verdi sono le integrazioni tramite OData v4, quelle grigie i dispositivi e le persone nel piazzale. Ogni freccia è un flusso di dati con un nome.

Flusso di integrazione

Come fluiscono i dati tra i vostri sistemi e Time Slot Control.

Il vostro ERP L'ERP invia gli ordini tramite API OData

OData API TSC elabora prenotazioni & pianificazione

Time Slot Control Gli aggiornamenti di stato fluiscono in tempo reale

BI & Report Gli strumenti BI generano report & dashboard

Avete bisogno di un'integrazione personalizzata?

Il nostro team tecnico vi aiuterà a progettare e implementare l'integrazione perfetta per la vostra infrastruttura.

Prenota una consulenza tecnica

Sicurezza e conformità: dove risiedono i dati e come sono protetti

Collegate TSC con l'intero vostro ecosistema