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 (;).
| Colonna | Obbligatoria | Note |
|---|---|---|
Barcode | Sì | La vostra chiave di business. Vedi Panoramica |
Description | Sì | Che pezzo è, in parole comprensibili |
Width · Height | Sì | In millimetri |
Thickness | Sì | In millimetri. Accetta decimali |
Services | Sì | Le lavorazioni, fra parentesi quadre: [SERVICE_A],[SERVICE_B]. Senza almeno una non esiste ciclo di lavorazione — salvo se la riga invia Phases (sotto) |
GlassType | Sì | Tipo di vetro. Creata automaticamente se nuova |
CustomerName | Sì | Creato automaticamente se nuovo |
DueDate | No | La 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 |
Quantity | No | Se assente vale pezzo singolo |
Item | No | La riga d'ordine, per il lotto seriale |
Cancelled | No | True rifiuta il pezzo — vedi sotto |
CustomerOrder · InternalOrder | No | I vostri riferimenti d'ordine |
Urgent | No | Alza la priorità nella programmazione |
Notes | No | Testo libero, che arriva fino al reparto |
Route | No | Rotta di consegna |
Priority | No | Priorità nella programmazione, come numero |
Cutouts | No | Numero di intagli |
ParentBarcode | No | Codice a barre del pezzo padre, per gli assemblati |
Shape | No | Sagoma del pezzo in rc2. Contenuto inline, o il nome di un file in shapes/ |
Drawing | No | Disegno tecnico (SVG). Contenuto inline, o il nome di un file in shapes/ |
OrderImage | No | Nome di un'immagine in images/ |
Weight | No | Il peso di una unità, in kg. Assente o vuoto: Mover.Glass lo calcola dalla misura e dallo spessore |
EdgingAllowance | No | La sovramisura di molatura, in mm, uguale sui quattro lati (1,5). Vedi sotto |
EdgingAllowanceSides | No | La sovramisura di molatura per lato, in mm: quattro valori separati da trattino, sopra-destra-sotto-sinistra (1,5-3-1,5-0). Vedi sotto |
Phases | No | I codici delle fasi ERP, al posto di Services: CODICE[*conteggio][@marca], separati da virgola (FL,FOR*2,TEMPCM@E). Vedi sotto |
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.
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 inviate | Diventa | Perché |
|---|---|---|
6.5 · 6,5 | 6,5 | Un separatore solo, fuori dalla posizione delle migliaia, è il decimale |
1.234,5 · 1,234.5 | 1234,5 | Con entrambi presenti, l'ultimo è il decimale. Le due convenzioni concordano |
1.234.567 | 1234567 | Lo stesso separatore ripetuto può essere solo raggruppamento |
1.234 | RIFIUTATO | Davvero ambiguo: milleduecentotrentaquattro, oppure uno virgola duecentotrentaquattro? |
abc · 12mm · vuoto | RIFIUTATO | Non è un numero |
Tre garanzie che ne discendono:
- Niente diventa un valore plausibile. Un numero illeggibile rifiuta il pezzo; non diventa
0in una misura né1in una quantità. - Il motivo indica quale campo, ed elenca in una volta tutti quelli sbagliati della riga, così il foglio si corregge in un passaggio solo.
- Il risultato non dipende dal nostro server. Lo stesso input viene letto allo stesso modo, a prescindere dalla lingua impostata sulla macchina.
1.234 intendendo milleInviate 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 inviate | Risultato |
|---|---|
2026-11-10 | Il 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:00 | Quell'ora nello stabilimento |
2026-11-10T08:00:00Z · 2026-11-10T08:00:00+02:00 | RIFIUTATO, 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 UTC | RIFIUTATO, 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/A | CREATO (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 |
| vuoto | Il 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).
DueDate rifiuta il pezzoConvertirlo 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.
| Inviate | Risultato |
|---|---|
| Le due colonne assenti o vuote | Il pezzo eredita la sovramisura della tipologia sui quattro lati |
EdgingAllowance = 1,5 | 1,5 mm sui quattro lati; 0 significa nessuna |
EdgingAllowanceSides = 1,5-3-1,5-0 | Un valore per lato, sopra-destra-sotto-sinistra |
| Entrambe, con gli stessi valori | Accettato |
| Entrambe, con valori diversi | RIFIUTATO, 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.
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.
| Inviate | Risultato |
|---|---|
| La colonna assente | Nessun cambiamento: la riga usa Services |
Phases compilata e Services vuoto | La 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 compilato | L'elenco già pronto, come sempre |
Phases e Services compilati | RIFIUTATO: è 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 registrato | RIFIUTATO, 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 riga | RIFIUTATO, con il codice nel reason |
| Fasi che non danno nessun servizio | RIFIUTATO |
| Un servizio della mappatura che lo stabilimento ha registrato due volte con la stessa descrizione | RIFIUTATO, con il servizio nel reason |
| Fasi che danno un solo servizio | RIFIUTATO dal ciclo, come l'elenco già pronto con un solo servizio |
- Mantenete il campo
Phasesin ogni riga. La riga conPhaseseServicesentrambi vuoti, e la riga che finisce prima del campoPhases(il generatore di CSV che taglia i separatori finali), non sono in questa tabella: inviate i separatori fino alla colonnaPhases. - 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
warningquando la tipologia era nuova. - La sagoma è, per ora, lo
Shapeo ilDrawinginviati nel file; il rettangolo che Mover.Glass disegna dalla misura non conta. Questa regola è provvisoria e può cambiare. Il.xlsxnon ha le colonneShapeeDrawing: un pezzo inviato in.xlsxnon ha mai la sagoma. - Nel
.xlsx,Phasesviene 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.