Integrare Sun Tech WCS con il vostro WMS

Questa pagina è per chi deve mettere Sun Tech WCS sotto un WMS che esiste già: che cosa si scambiano i due sistemi, che cosa deve servire il WMS e in che ordine conviene lavorare. La guida completa, in inglese, è Writing a WMS adapter.

Tre contratti

• Dal WCS al WMS. Il WCS fa domande al WMS e gli comunica i fatti attraverso 43 rotte HTTP, che il WMS serve direttamente oppure attraverso un adapter messo davanti.
• Dai vostri sistemi al WCS. ERP, MES e schermi usano l'API del WCS e il suo canale di eventi. Anche il WMS, quando vuole far fare qualcosa al WCS, usa i comandi di quell'API: il contratto non prevede chiamate di ritorno dal WMS al WCS.
• Dal WCS alle macchine. Passa da un driver, su un contratto pubblico. Sun Tech fornisce il proprio driver; potete anche scriverne uno vostro.

Il WMS non spinge, il WCS chiede

Quando il motore è in marcia, una volta al secondo il WCS chiede al WMS il lavoro pendente. Il WMS resta la fonte di verità su merci e ordini, ed è lui a scegliere la cella: il WCS sa come arrivarci. I due non scrivono mai uno nel database dell'altro.

Che cosa deve servire il WMS

• Le 43 rotte del contratto, sotto un percorso comune, in JSON, con una chiave nell'intestazione X-Api-Key.
• Risposte che distinguono un rifiuto da un guasto: un errore 4xx è un rifiuto definitivo e la richiesta viene messa da parte, un 5xx, 408 o 429 viene ritentato.
• Ricevute per ogni fatto, legate al suo identificativo di operazione: lo stesso fatto ripetuto non si registra due volte.

L'elenco delle rotte, una per riga, sta in WMS routes; il contratto completo, con le regole su identificativi, enumerazioni e ritentativi, in WMS contract. Entrambi esistono anche come documento OpenAPI 3.1, generato dal codice.

I passi della guida

1. Si parte dal WMS d'esempio, che risponde a tutte le 43 rotte su un magazzino in memoria: si tengono la parte che espone le rotte e il controllo della chiave, e si sostituiscono i dati finti con le query sul vostro database.
2. Si preparano i dati che il WMS tiene per il WCS: i codici delle porte delle celle, le profondità, i dispositivi da cui ogni cella è raggiungibile, le prenotazioni con scadenza e le ricevute.
3. Si implementa in ordine: prima lo stoccaggio, poi l'estrazione, poi il resto. Una rotta non ancora pronta risponde 503, non con un rifiuto.
4. Si prova con il client del WCS stesso, usando come modello i test del WMS d'esempio.

In che linguaggio

Da .NET si usa la libreria dei contratti con un riferimento al progetto, da un clone del repository: pacchetti NuGet per ora non ce ne sono. In un altro linguaggio basta servire gli stessi percorsi con lo stesso JSON.

Volete che l'adapter lo scriva Sun Tech, o state collegando Kazam WMS? Raccontateci il vostro WMS e l'impianto: risponde un ingegnere. Parlate con un ingegnere

Da leggere dopo: funzionalità · come iniziare · WMS, WES e WCS: le differenze · Sun Tech WCS