Passa al contenuto principale

Formato del file

Un foglio con una riga per pezzo. .csv, .xlsx, oppure uno .zip che contenga uno dei due.

Il pacchetto ZIP​

esempio.zip
├── pieces.csv ← esattamente UN foglio, nella radice
├── images/ ← facoltativo: l'immagine originale dell'ordine
│ └── imagem.png
└── shapes/ ← facoltativo: SVG o RC2 della sagoma del pezzo
└── forma.svg

Esattamente un foglio nella radice. Due, o nessuno, rifiutano l'intero pacchetto prima di leggere qualsiasi riga.

Le colonne Drawing e Shape accettano il contenuto inline oppure il nome di un file dentro shapes/. Lo stesso vale per OrderImage e images/.

Colonne​

Il separatore è il punto e virgola (;).

ColonnaObbligatoriaNote
BarcodeSìLa vostra chiave di business. Vedi Panoramica
DescriptionSìChe pezzo è, in parole comprensibili
Width · HeightSìIn millimetri
ThicknessSìIn millimetri. Accetta decimali
ServicesSìLe lavorazioni, fra parentesi quadre: [SERVICE_A],[SERVICE_B]. Senza almeno una non esiste ciclo di lavorazione — salvo se la riga invia Phases (sotto)
GlassTypeSìTipo di vetro. Creata automaticamente se nuova
CustomerNameSìCreato automaticamente se nuovo
DueDateNoLa scadenza, nell'ora dello stabilimento e senza fuso orario: AAAA-MM-GG o AAAA-MM-GGTHH:MM[:SS] — vedi sotto. Se assente vale il giorno dello stabilimento più 30 giorni
QuantityNoSe assente vale pezzo singolo
ItemNoLa riga d'ordine, per il lotto seriale
CancelledNoTrue rifiuta il pezzo — vedi sotto
CustomerOrder · InternalOrderNoI vostri riferimenti d'ordine
UrgentNoAlza la priorità nella programmazione
NotesNoTesto libero, che arriva fino al reparto
RouteNoRotta di consegna
PriorityNoPriorità nella programmazione, come numero
CutoutsNoNumero di intagli
ParentBarcodeNoCodice a barre del pezzo padre, per gli assemblati
ShapeNoSagoma del pezzo in rc2. Contenuto inline, o il nome di un file in shapes/
DrawingNoDisegno tecnico (SVG). Contenuto inline, o il nome di un file in shapes/
OrderImageNoNome di un'immagine in images/
WeightNoIl peso di una unità, in kg. Assente o vuoto: Mover.Glass lo calcola dalla misura e dallo spessore
EdgingAllowanceNoLa sovramisura di molatura, in mm, uguale sui quattro lati (1,5). Vedi sotto
EdgingAllowanceSidesNoLa sovramisura di molatura per lato, in mm: quattro valori separati da trattino, sopra-destra-sotto-sinistra (1,5-3-1,5-0). Vedi sotto
PhasesNoI codici delle fasi ERP, al posto di Services: CODICE[*conteggio][@marca], separati da virgola (FL,FOR*2,TEMPCM@E). Vedi sotto
I nomi in portoghese continuano a funzionare

Il contratto pubblica i nomi in inglese qui sopra. I vecchi nomi in portoghese — CodigoBarra, Largura, Espessura, ServicosAplicaveis, Inativa e gli altri — restano accettati, quindi un file che già generate continua a funzionare. I due insiemi possono perfino comparire nella stessa riga di intestazione.

Una nuova integrazione deve usare i nomi in inglese: sono quelli che questa pagina continuerà a documentare.

Dal 9 novembre 2026 l'intestazione viene riconosciuta senza distinguere maiuscole e minuscole né gli spazi attorno al nome (edgingallowance funziona). Una colonna che il lettore non conosce resta ignorata, senza avviso.

Il layout .xlsx viene letto per posizione, non per intestazione. I nomi di colonna nel foglio sono ignorati — conta l'ordine. Se state partendo ora, usate il CSV: l'intestazione rende il file leggibile da una persona e tollerante all'aggiunta di una colonna in futuro.

Ci sono tre eccezioni, trovate per intestazione in qualsiasi colonna (senza distinguere maiuscole e minuscole): il peso, Weight, la sovramisura di molatura, EdgingAllowance e EdgingAllowanceSides, e le fasi ERP, Phases. Senza l'intestazione non vengono lette. Nel .xlsx vale solo il nome Phases (non il portoghese Fases). Se l'intestazione Phases si trova nella posizione di Services (la colonna 20), quella colonna viene letta solo come Phases; in un'altra colonna che il foglio legge per posizione (1, da 4 a 9, 11, da 21 a 24), l'intero file viene rifiutato, con la colonna nel messaggio.

Le lavorazioni usano la virgola, non il punto e virgola

Dentro il file, separate le lavorazioni con una virgola: [SERVICE_A],[SERVICE_B].

Il file stesso è delimitato da punto e virgola, quindi un ; dentro un campo diventa una nuova colonna e sposta in silenzio il resto della riga.

Come vengono letti i numeri​

Vale per Width, Height, Thickness, Quantity, Weight e la sovramisura di molatura (EdgingAllowance e ogni lato di EdgingAllowanceSides), in tutti e tre i formati.

Il separatore decimale può essere il punto o la virgola — il sistema capisce quale, invece di imporre un formato. Quello che non fa è indovinare quando indovinare è impossibile:

Voi inviateDiventaPerché
6.5 · 6,56,5Un separatore solo, fuori dalla posizione delle migliaia, è il decimale
1.234,5 · 1,234.51234,5Con entrambi presenti, l'ultimo è il decimale. Le due convenzioni concordano
1.234.5671234567Lo stesso separatore ripetuto può essere solo raggruppamento
1.234RIFIUTATODavvero ambiguo: milleduecentotrentaquattro, oppure uno virgola duecentotrentaquattro?
abc · 12mm · vuotoRIFIUTATONon è un numero

Tre garanzie che ne discendono:

  1. Niente diventa un valore plausibile. Un numero illeggibile rifiuta il pezzo; non diventa 0 in una misura né 1 in una quantità.
  2. Il motivo indica quale campo, ed elenca in una volta tutti quelli sbagliati della riga, così il foglio si corregge in un passaggio solo.
  3. Il risultato non dipende dal nostro server. Lo stesso input viene letto allo stesso modo, a prescindere dalla lingua impostata sulla macchina.
Se il vostro gestionale scrive 1.234 intendendo mille

Inviate 1234. Non c'è modo per l'altro capo di distinguerlo da un decimale, e indovinare è esattamente ciò che ci rifiutiamo di fare.

Quantity assente vale pezzo singolo. Quantity frazionaria viene rifiutata invece che troncata — 2,5 pezzi è un errore di ciò che ha generato il file, e arrotondare a 2 lo nasconderebbe.

Come viene letta la scadenza​

DueDate è l'ora locale dello stabilimento, senza fuso orario. Lo stesso file significa la stessa cosa su qualsiasi server.

Voi inviateRisultato
2026-11-10Il giorno, senza ora: il pezzo scade alla fine di quel giorno, e può partire in un carico che parte a qualsiasi ora di quel giorno
2026-11-10T08:00 · 2026-11-10T08:00:00 · 2026-11-10 08:00Quell'ora nello stabilimento
2026-11-10T08:00:00Z · 2026-11-10T08:00:00+02:00RIFIUTATO, e il reason cita ciò che avete inviato
Un fuso orario scritto per nome: 2026-11-10T08:00:00 GMT · … UTC · … CET · 2026-11-10T08:00+01:00[Europe/Rome] · 2026-11-10 08:00:00 +0100 CET · 10/11/2026 08.00 cet · 2026-11-10 UTCRIFIUTATO, come la Z
Una parola dopo l'ora o la data che non è un fuso orario: 2026-11-10 08:00 HS · … HRS · … ORE · … TURNO · 10/11/2026 N/ACREATO (CREATED) con la data predefinita e il warning, come la riga sotto
Un testo che non si legge e non ha fuso orario: 20261110 · 2026-02-30 · 08:00 (un'ora senza data)CREATO (CREATED) con la data predefinita, il giorno dello stabilimento più 30 giorni, e un warning sull'elemento che cita ciò che avete inviato
vuotoIl giorno dello stabilimento più 30 giorni, senza ora, e nessun warning

Quali nomi contano come fuso orario. Solo queste sigle, maiuscole o minuscole: UTC, GMT, Z, CET, CEST, EET, EEST, WET, WEST, BST, MSK, EST, EDT, CST, CDT, MST, MDT, PST, PDT, BRT, BRST, ART, IST, JST, AEST, AEDT. Contano dopo l'ora (08:00 o 08.00, e dopo AM o PM) o dopo una data senza ora, anche tra parentesi tonde o quadre. Un nome IANA conta per la sua area (Europe/Rome, America/…, Etc/… e le altre, anche tra parentesi quadre), e così uno scostamento dopo l'ora. Ogni altra parola è testo illeggibile, quindi il pezzo entra con la data predefinita e il warning. Vale anche per l'id di fuso orario di Windows (W. Europe Standard Time).

Un fuso orario in DueDate rifiuta il pezzo

Convertirlo distruggerebbe il significato della data senza ora: a Roma, 2026-11-10T00:00:00Z è l'01:00, non più mezzanotte, e la scadenza si sposterebbe di quasi un giorno intero prima. Fino al 5 novembre 2026, un fuso orario veniva invece convertito in silenzio all'orologio del server, e un fuso orario scritto per nome diventava in silenzio la data predefinita. Inviate l'ora locale dello stabilimento, senza Z, scostamento o nome del fuso. Vale anche per una data che non è ISO.

Una data illeggibile non rifiuta il pezzo. Rifiutarlo toglierebbe dalla produzione un ordine valido a causa della sua scadenza, quindi il pezzo entra con la stessa data predefinita di un file senza la colonna, e il warning vi dice che cosa è arrivato. Leggetelo: la scadenza su cui lavora lo stabilimento non è quella che intendeva il vostro gestionale. Fino al 5 novembre 2026 succedeva senza alcun avviso.

Una data che non è ISO (10/11/2026) viene letta nella lingua della richiesta, che per il Mover.Glass Connector è il portoghese (prima il giorno). L'intestazione Accept-Language cambia la lettura: con en, 10/11/2026 è l'11 ottobre, e 13/11/2026 non si legge (mese 13), quindi riceve la data predefinita e il warning. Inviate l'ISO: è l'unico formato che si legge allo stesso modo ovunque.

La sovramisura di molatura​

La molatura asporta un po' di vetro da ogni lato, quindi il pezzo viene tagliato più grande e la molatura lo riporta alla misura finale. Width e Height restano la misura finale — quella dell'etichetta, dei m² e del peso. Mover.Glass somma la sovramisura solo quando chiede il piano di taglio. Le due colonne sono facoltative: un file senza di esse continua a funzionare, e il pezzo usa la sovramisura della sua tipologia.

InviateRisultato
Le due colonne assenti o vuoteIl pezzo eredita la sovramisura della tipologia sui quattro lati
EdgingAllowance = 1,51,5 mm sui quattro lati; 0 significa nessuna
EdgingAllowanceSides = 1,5-3-1,5-0Un valore per lato, sopra-destra-sotto-sinistra
Entrambe, con gli stessi valoriAccettato
Entrambe, con valori diversiRIFIUTATO, con le due nel reason: indovinare quale vale è il modo in cui il vetro viene tagliato alla misura sbagliata
Un valore che non è un numero (abc, 1.234)RIFIUTATO, con il campo nel reason — la stessa regola di Width
Un valore negativo (-1)RIFIUTATO: per ereditare la sovramisura della tipologia, lasciate la colonna vuota
Più o meno di quattro lati, o un lato vuoto (1,5-3, 1,5--3-0)RIFIUTATO

La sovramisura ereditata vale solo per il pezzo con la molatura nel ciclo; il valore che inviate (o 0) vale sempre. Un pezzo sagomato (Shape il cui contorno non è un rettangolo; un rettangolo con fori conta come rettangolo) registra la sovramisura ma non la usa ancora nel taglio.

Le fasi ERP​

Al posto dell'elenco dei servizi già pronto in Services, la riga può inviare i codici delle fasi del vostro ERP in Phases, e Mover.Glass li traduce in servizi tramite la mappatura delle fasi ERP dello stabilimento (un dizionario di codici e regole tenuto in stabilimento). La colonna è facoltativa: un file senza di essa continua a funzionare.

Il formato è CODICE[*conteggio][@marca], separati da virgola: FL,FOR*2,FOR*4,TEMPCM@E. Il conteggio è un intero positivo (1 quando manca); la marca (interna o esterna) resta come arriva, maiuscole comprese. Il codice non distingue maiuscole e minuscole. Un * da solo è riservato alla fase ERP implicita dello stabilimento, le cui regole valgono per ogni riga.

Ancora da confermare

I separatori * (conteggio) e @ (marca) sono provvisori: saranno confermati con i codici delle fasi del vostro ERP, e possono cambiare se i codici stessi usano questi caratteri.

InviateRisultato
La colonna assenteNessun cambiamento: la riga usa Services
Phases compilata e Services vuotoLa mappatura: il pezzo nasce con i servizi che ha dato, nel ciclo di sempre, nell'ordine standard dello stabilimento, e le fasi vengono registrate come sono arrivate. La mappatura decide quali fasi di lavorazione ha il pezzo, non il loro ordine: il FixedRouting non vale per la riga inviata con Phases, e l'elemento porta un warning quando arrivava attivo
Phases vuota e Services compilatoL'elenco già pronto, come sempre
Phases e Services compilatiRIFIUTATO: è ambiguo; inviate una delle due
Una fase scritta male (FL,,TEM, FOR*0, BIS@, un * nella riga)RIFIUTATO, con Phases='…' e il motivo, insieme ai numeri illeggibili della riga
Un codice che lo stabilimento non ha registratoRIFIUTATO, con i codici nel reason; vanno nella coda dei codici da registrare dello stabilimento. Registrato il codice, inviate di nuovo la riga
Un codice disattivato, una regola la cui condizione non si può valutare, o un codice con regole di cui nessuna vale per la rigaRIFIUTATO, con il codice nel reason
Fasi che non danno nessun servizioRIFIUTATO
Un servizio della mappatura che lo stabilimento ha registrato due volte con la stessa descrizioneRIFIUTATO, con il servizio nel reason
Fasi che danno un solo servizioRIFIUTATO dal ciclo, come l'elenco già pronto con un solo servizio
  • Mantenete il campo Phases in ogni riga. La riga con Phases e Services entrambi vuoti, e la riga che finisce prima del campo Phases (il generatore di CSV che taglia i separatori finali), non sono in questa tabella: inviate i separatori fino alla colonna Phases.
  • Il materiale della regola (stratificato o no) è quello della tipologia già registrata: una tipologia creata dall'importazione nasce monolitica, quindi registrate prima le tipologie stratificate. L'elemento porta un warning quando la tipologia era nuova.
  • La sagoma è, per ora, lo Shape o il Drawing inviati nel file; il rettangolo che Mover.Glass disegna dalla misura non conta. Questa regola è provvisoria e può cambiare. Il .xlsx non ha le colonne Shape e Drawing: un pezzo inviato in .xlsx non ha mai la sagoma.
  • Nel .xlsx, Phases viene trovata per intestazione.

Pezzi annullati​

Cancelled=True restituisce REJECTED, e non viene salvato nulla — né il pezzo, né la tipologia o il cliente che avrebbe creato.

È voluto. Registrare qualcosa che è già annullato è rumore, e restituire CREATED per un pezzo che il vostro stesso sistema ha annullato sarebbe tecnicamente vero e fuorviante nella pratica.

Rifiutare non riserva nulla: il codice a barre resta libero. Se l'annullamento viene revocato e reinviate il pezzo attivo, entra normalmente.

Ottenere un esempio​

Il Mover.Glass Connector che gira presso di voi porta con sé un pacchetto di esempio funzionante. Il pulsante Send sample lo deposita nella cartella di ingresso e il ciclo normale lo elabora — un modo per provare il percorso da un capo all'altro senza aspettare il vostro gestionale.