Passa al contenuto principale

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:

ModificaIncompatibile?
Campo nuovo in una rispostaNo — ignorate ciò che non usate
Campo facoltativo nuovo accettato in una richiestaNo
Endpoint nuovoNo
Un campo sparisce o cambia tipoSì
Un campo cambia significatoSì, ed è il tipo peggiore — niente va in errore
Una rotta viene rinominataSì

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 in Services. Le due nella stessa riga vengono rifiutate. Nel .xlsx viene trovata per intestazione (solo il nome Phases), come Weight. 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) e EdgingAllowanceSides (uno per lato, sopra-destra-sotto-sinistra, separati da trattino). Nel .xlsx vengono trovate per intestazione, come Weight. 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 DueDatePrimaOra
Z o uno scostamento: 2026-11-10T08:00:00Z, 2026-11-10T08:00:00+02:00CREATED, convertito all'orologio del server e salvato come ora dello stabilimentoREJECTED, 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 silenzioREJECTED, come la Z
Un testo che non si legge: 20261110, 2026-02-30, 08:00CREATED con la data predefinita, in silenzioCREATED 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.

CosaPrimaOra
LATEl'inizio programmato era passatola 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
UNSCHEDULEDnon esisteva: queste fasi uscivano WAITINGnuova: non iniziata, non ancora programmata, con la scadenza del pezzo ancora davanti
WAITINGtutto ciò che non era iniziato e non era in ritardosolo una fase programmata e in orario
scheduledForl'ora locale dello stabilimento con la Z: un istante 3 ore prima di quello realel'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.

EraOra è
/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 arquivofile
codigoBarra, desfecho, motivobarcode, outcome, reason
CRIADA, IGNORADA, RECUSADACREATED, IGNORED, REJECTED
AGUARDANDO, ATRASADA, CONCLUIDAWAITING, 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.

EraOra è
CodigoBarraBarcode
DescricaoDescription
Largura · AlturaWidth · Height
EspessuraThickness
ServicosAplicaveisServices
TipologiaGlassType
NomeClienteCustomerName
DataFinalizacaoDueDate
QtdeQuantity
InativaCancelled
PedidoCliente · PedidoInternoCustomerOrder · InternalOrder
UrgenteUrgent
ObservacaoNotes
RotaRoute
PrioridadePadraoPriority
RecortesCutouts
PecaPaiIdParentBarcode
Rc2Shape
SVGDrawing
ImagemPedidoOrderImage

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à".