Changelog
Tutto ciò che è cambiato nella v1, dal più recente.
Cosa conta come modifica incompatibile
Solo una modifica incompatibile impone una versione nuova. Questa è la linea:
| Modifica | Incompatibile? |
|---|---|
| Campo nuovo in una risposta | No — ignorate ciò che non usate |
| Campo facoltativo nuovo accettato in una richiesta | No |
| Endpoint nuovo | No |
| Un campo sparisce o cambia tipo | Sì |
| Un campo cambia significato | Sì, ed è il tipo peggiore — niente va in errore |
| Una rotta viene rinominata | Sì |
Una modifica incompatibile diventa v2, e la v1 resta attiva. Non dovreste mai dover migrare nello stesso momento in cui il vostro server viene aggiornato.
09/11/2026 — le fasi ERP
Aggiuntiva. Un file che non invia la nuova colonna non vede alcun cambiamento.
- Una colonna facoltativa,
Phases: i codici delle fasi del vostro ERP (CODICE[*conteggio][@marca], separati da virgola), tradotti in servizi dalla mappatura delle fasi ERP dello stabilimento, al posto dell'elenco già pronto inServices. Le due nella stessa riga vengono rifiutate. Nel.xlsxviene trovata per intestazione (solo il nomePhases), comeWeight. La regola è nel formato del file. - I separatori
*e@sono provvisori, da confermare con i codici del vostro ERP. - Un codice che lo stabilimento non ha registrato rifiuta la riga, con i codici nel
reason; inviate di nuovo la riga dopo che lo stabilimento lo ha registrato.
09/11/2026 — la sovramisura di molatura, e l'intestazione senza distinguere maiuscole
Aggiuntiva. Un file che non invia le nuove colonne non vede alcun cambiamento in ciò che invia; il pezzo usa la sovramisura della sua tipologia.
- Due colonne facoltative:
EdgingAllowance(lo stesso valore sui quattro lati) eEdgingAllowanceSides(uno per lato, sopra-destra-sotto-sinistra, separati da trattino). Nel.xlsxvengono trovate per intestazione, comeWeight. La regola è nel formato del file. - L'intestazione del CSV viene riconosciuta senza distinguere maiuscole e minuscole né gli spazi attorno al nome. Una colonna che prima veniva ignorata per le maiuscole ora viene letta.
05/11/2026 — un fuso orario in DueDate viene rifiutato
Modifica incompatibile per un file che invia un fuso orario, senza v2, per decisione del titolare dello stabilimento. Un file che invia l'ora locale dello stabilimento, come fanno gli esempi e il Mover.Glass Connector, non vede alcun cambiamento.
Inviate in DueDate | Prima | Ora |
|---|---|---|
Z o uno scostamento: 2026-11-10T08:00:00Z, 2026-11-10T08:00:00+02:00 | CREATED, convertito all'orologio del server e salvato come ora dello stabilimento | REJECTED, con il reason che cita il testo |
Un fuso orario scritto per nome: … GMT, … UTC, … CET, …+01:00[Europe/Rome] | CREATED con la data predefinita, in silenzio | REJECTED, come la Z |
Un testo che non si legge: 20261110, 2026-02-30, 08:00 | CREATED con la data predefinita, in silenzio | CREATED con la data predefinita e un warning sull'elemento, che cita il testo |
Il warning è un campo nuovo sull'elemento, che potete ignorare. Inviate AAAA-MM-GG o AAAA-MM-GGTHH:MM[:SS], nell'ora dello stabilimento. La regola è in formato del file.
20/10/2026 — la situazione della fase segue la regola dello stabilimento
Modifica incompatibile, senza v2, per decisione del titolare dello stabilimento. Tre situazioni cambiano significato, una è nuova e scheduledFor si sposta di 3 ore. I valori vecchi erano sbagliati (vedi sotto), e una v2 avrebbe tenuto in vita quelli sbagliati. Niente nella risposta HTTP vi avvisa: leggete questo prima del rilascio.
| Cosa | Prima | Ora |
|---|---|---|
LATE | l'inizio programmato era passato | la fase programmata finirà dopo la data entro cui deve essere pronta (o adesso l'ha già superata); la fase senza programmazione, dopo che la scadenza del pezzo è passata. Un lotto diviso è LATE se una qualsiasi parte non iniziata è in ritardo, anche con un'altra parte in macchina, già passata o presso il fornitore |
UNSCHEDULED | non esisteva: queste fasi uscivano WAITING | nuova: non iniziata, non ancora programmata, con la scadenza del pezzo ancora davanti |
WAITING | tutto ciò che non era iniziato e non era in ritardo | solo una fase programmata e in orario |
scheduledFor | l'ora locale dello stabilimento con la Z: un istante 3 ore prima di quello reale | l'istante reale, in UTC |
Le 3 ore. L'ora locale dello stabilimento veniva confrontata con l'UTC: LATE usciva 3 ore in anticipo, e scheduledFor mostrava un istante 3 ore prima di quello reale. Se sommavate 3 ore a scheduledFor per compensare, smettete il giorno del rilascio.
Se avete generato un enum dalla vecchia lista delle situazioni, aggiungete UNSCHEDULED, oppure trattate le situazioni sconosciute come informative. La regola completa è in stato della produzione.
18/09/2026 — rotte e campi in inglese
Modifica incompatibile, fatta senza diventare una v2. Fino a quel giorno l'unico consumatore di questa API era il nostro stesso Connector, nello stesso repository, quindi la rinomina non è costata nulla a nessuno. Una volta che avrete scritto codice contro di essa, una modifica del genere diventa una v2 — le uniche eccezioni da allora sono la situazione della fase e il fuso orario in DueDate (le voci sopra), per decisione del titolare dello stabilimento.
| Era | Ora è |
|---|---|
/api/v1/integracao/conexao | /api/v1/integration/connection |
/api/v1/integracao/pecas/arquivo | /api/v1/integration/pieces/import |
/api/v1/integracao/situacao | /api/v1/integration/production-status |
campo multipart arquivo | file |
codigoBarra, desfecho, motivo | barcode, outcome, reason |
CRIADA, IGNORADA, RECUSADA | CREATED, IGNORED, REJECTED |
AGUARDANDO, ATRASADA, CONCLUIDA | WAITING, LATE, DONE |
POST /api/v1/integracao/pecas è stato rimosso. L'endpoint del pezzo singolo non aveva consumatori. Se vi serve inviare i pezzi uno alla volta invece che via file, chiedetecelo: tornerà come endpoint documentato, non per caso.
Anche i nomi delle colonne del CSV sono in inglese, e quelli in portoghese continuano a funzionare.
| Era | Ora è |
|---|---|
CodigoBarra | Barcode |
Descricao | Description |
Largura · Altura | Width · Height |
Espessura | Thickness |
ServicosAplicaveis | Services |
Tipologia | GlassType |
NomeCliente | CustomerName |
DataFinalizacao | DueDate |
Qtde | Quantity |
Inativa | Cancelled |
PedidoCliente · PedidoInterno | CustomerOrder · InternalOrder |
Urgente | Urgent |
Observacao | Notes |
Rota | Route |
PrioridadePadrao | Priority |
Recortes | Cutouts |
PecaPaiId | ParentBarcode |
Rc2 | Shape |
SVG | Drawing |
ImagemPedido | OrderImage |
Non si rompe nulla. Ogni nome a sinistra resta accettato, quindi un file che già generate continua a funzionare — i due insiemi possono perfino condividere la stessa intestazione. Usate quelli inglesi per ciò che è nuovo: sono quelli che questa documentazione continuerà a descrivere.
Il layout .xlsx viene letto per posizione, quindi lì non è cambiato nulla.
18/09/2026
I numeri con la virgola vengono letti correttamente. Una misura scritta 6,5 veniva letta come 65, perché la virgola era trattata come separatore delle migliaia. Riguarda spessore, larghezza, altezza e quantità, in tutti e tre i formati di file.
Un numero illeggibile ora rifiuta il pezzo con un motivo, invece di diventare 0 in una misura o 1 in una quantità. Vedi come vengono letti i numeri.
Se il vostro sistema invia 1.234 intendendo milleduecentotrentaquattro, quel valore viene ora rifiutato perché ambiguo — inviate 1234.
Lo spessore frazionario funziona nei fogli di calcolo. I file Excel leggevano lo spessore come numero intero, quindi il vetro da 6,5 mm non poteva essere importato affatto, nemmeno scritto con il punto.
17/09/2026
I pezzi annullati vengono rifiutati invece che creati attivi. Inativa=True veniva letto dal file e poi scartato: il pezzo veniva creato attivo, otteneva un ciclo di lavorazione ed entrava nel piano di taglio, mentre la risposta diceva CREATED.
Ora restituisce REJECTED e non salva nulla — né il pezzo, né la tipologia o il cliente che avrebbe creato. Vedi pezzi annullati.
La scadenza inviata dal vostro sistema viene preservata. Un pezzo creato tramite l'endpoint del pezzo singolo si vedeva sovrascrivere dataFinalizacao con il momento della richiesta. Un ordine con consegna a fine anno nasceva già scaduto lo stesso giorno.
Entrambi i separatori delle lavorazioni sono accettati. L'endpoint del pezzo singolo richiedeva il punto e virgola mentre il messaggio di rifiuto mostrava la virgola. Ora funzionano entrambi.
16/09/2026
È stata pubblicata la superficie di integrazione, con le garanzie descritte qui: una chiave API per installazione, tre esiti per pezzo e transazioni per singolo pezzo nell'importazione da file.
Prima di questo, un reinvio restituiva successo in silenzio, senza modo di distinguere "creato" da "esisteva già".