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.
18/09/2026 — rotte e campi in inglese
Modifica incompatibile, e l'unica che avverrà senza diventare una v2. Fino a oggi 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.
| 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à".