Integrare con Mover.Glass
Mover.Glass è il MES che governa il reparto di lavorazione del vetro: riceve i pezzi che il vostro sistema ha ordinato, li programma, li segue macchina per macchina e dice dove si trova ognuno.
Questa documentazione copre una sola superficie: /api/v1/integration/. Tre endpoint, una chiave API e un formato di file.
Cosa spetta a voi, e cosa a noi
L'integrazione fallisce quasi sempre perché nessuno ha messo per iscritto di chi è cosa. Quindi eccolo.
| Responsabilità | Di chi | Cosa significa |
|---|---|---|
| La chiave di business | Vostra | Il codice a barre identifica il pezzo. Lo scegliete voi, è vostro, ed è con quello che chiederete del pezzo in seguito |
| Non duplicare | Nostra | Inviate due volte lo stesso codice a barre e la seconda viene ignorata, non duplicata |
| Ripetere l'invio | Vostra | Se la rete cade, inviate di nuovo. È sicuro per progetto |
| Dire cosa è successo | Nostra | Ogni pezzo inviato torna con un esito, e ogni rifiuto torna con un motivo |
| Correggere il dato | Vostra | Noi rifiutiamo il dato sbagliato e diciamo perché. Non indoviniamo mai un valore plausibile |
L'ultima riga merita una seconda lettura. Se una misura non può essere letta con certezza, il pezzo viene rifiutato con un motivo — non diventa zero, e non diventa "abbastanza vicino". Un pezzo rifiutato è un messaggio su cui potete agire; un pezzo corretto in silenzio è vetro tagliato della misura sbagliata.
Cosa non fa parte di questo contratto
Tutto ciò che sta fuori da /api/v1/integration/.
Mover.Glass ha molti altri endpoint. Servono le nostre schermate e la nostra app, cambiano senza preavviso e non sono documentati qui. Se vi serve qualcosa che non è su questa superficie, chiedeteci di aggiungerlo qui invece di chiamare una rotta interna — una rotta interna che oggi funziona è una coincidenza, non una promessa.
Una nota sui nomi
Le rotte, i campi JSON e i valori enumerati sono in inglese — e soltanto qui. Tutto ciò che sta dentro Mover.Glass resta in portoghese, perché chi legge quel codice ogni giorno è il team, e il vocabolario della vetreria brasiliana è più preciso della sua traduzione.
La traduzione avviene su questo confine e da nessun'altra parte. È voluto: un solo posto da cambiare, un solo posto in cui sbagliare.
I nomi sono stabili. Se un giorno cambieranno, sarà una v2 — la v1 resta attiva, perché non dovreste mai dover migrare nello stesso momento in cui il server viene aggiornato.
Da dove iniziare
- Autenticazione — ottenere una chiave e verificare che funzioni
- Inviare pezzi — un pezzo, o un ordine intero
- Formato del file — le colonne, e come vengono letti i numeri
- Stato della produzione — rileggere dove si trova ogni pezzo