Formati Dati Supportati

DARC Bridge accetta ordini in tre formati: XML, CSV e JSON. Puoi usare quello più comodo per il tuo sistema gestionale.

Tutti e tre i formati contengono le stesse informazioni. Qui sotto trovi la struttura di ciascuno con un esempio completo.

Campi dell'Ordine

Campo	Tipo	Obbligatorio	Descrizione
codice_cliente	stringa	✅	Il tuo codice cliente Inciflex
riferimento_ordine	stringa	✅	Il numero d'ordine nel tuo gestionale
data_ordine	data (YYYY-MM-DD)	✅	Data di emissione dell'ordine
data_consegna	data (YYYY-MM-DD)		Data di consegna richiesta
note	stringa		Note libere sull'ordine
righe	lista	✅	Almeno una riga d'ordine

Campi Riga

Campo	Tipo	Obbligatorio	Descrizione
codice_articolo	stringa	✅	Codice articolo Inciflex
descrizione	stringa		Descrizione dell'articolo
quantita	numero	✅	Quantità ordinata
unita_misura	stringa		Unità di misura (es. PZ, KG, MT)
prezzo_unitario	numero		Prezzo unitario concordato
note_riga	stringa		Note sulla riga

---

XML

<?xml version="1.0" encoding="UTF-8"?>
<ordine>
  <codice_cliente>CLI001</codice_cliente>
  <riferimento_ordine>ORD-2025-001234</riferimento_ordine>
  <data_ordine>2025-10-15</data_ordine>
  <data_consegna>2025-11-01</data_consegna>
  <note>Consegna presso magazzino centrale</note>
  <righe>
    <riga>
      <codice_articolo>ART-500</codice_articolo>
      <descrizione>Flangia DN50 PN16</descrizione>
      <quantita>100</quantita>
      <unita_misura>PZ</unita_misura>
      <prezzo_unitario>12.50</prezzo_unitario>
    </riga>
    <riga>
      <codice_articolo>ART-601</codice_articolo>
      <descrizione>Guarnizione DN50</descrizione>
      <quantita>100</quantita>
      <unita_misura>PZ</unita_misura>
      <prezzo_unitario>1.80</prezzo_unitario>
      <note_riga>Materiale EPDM</note_riga>
    </riga>
  </righe>
</ordine>

XSD

Lo schema XSD per la validazione è disponibile su richiesta al supporto tecnico Inciflex.

---

CSV

Il file CSV usa il separatore ; (punto e virgola). La prima riga è l'intestazione.

codice_cliente;riferimento_ordine;data_ordine;data_consegna;codice_articolo;descrizione;quantita;unita_misura;prezzo_unitario;note;note_riga
CLI001;ORD-2025-001234;2025-10-15;2025-11-01;ART-500;Flangia DN50 PN16;100;PZ;12.50;Consegna presso magazzino centrale;
CLI001;ORD-2025-001234;2025-10-15;2025-11-01;ART-601;Guarnizione DN50;100;PZ;1.80;;Materiale EPDM

Ogni riga del CSV corrisponde a una riga d'ordine. I campi di testata (codice_cliente, riferimento_ordine, ecc.) vanno ripetuti su ogni riga.

Encoding

Il file deve essere codificato in UTF-8. Se usi Excel per generarlo, verifica che l'esportazione sia in formato CSV UTF-8.

---

JSON

{
  "codice_cliente": "CLI001",
  "riferimento_ordine": "ORD-2025-001234",
  "data_ordine": "2025-10-15",
  "data_consegna": "2025-11-01",
  "note": "Consegna presso magazzino centrale",
  "righe": [
    {
      "codice_articolo": "ART-500",
      "descrizione": "Flangia DN50 PN16",
      "quantita": 100,
      "unita_misura": "PZ",
      "prezzo_unitario": 12.50
    },
    {
      "codice_articolo": "ART-601",
      "descrizione": "Guarnizione DN50",
      "quantita": 100,
      "unita_misura": "PZ",
      "prezzo_unitario": 1.80,
      "note_riga": "Materiale EPDM"
    }
  ]
}

JSON Schema

Lo schema JSON per la validazione è disponibile su richiesta al supporto tecnico Inciflex.

---

Quale formato scegliere?

Situazione	Formato consigliato
Il tuo gestionale esporta file strutturati	XML
Usi Excel o fogli di calcolo	CSV
Il tuo sistema ha API o produce dati strutturati	JSON
Non sei sicuro	Contatta il supporto Inciflex, ti aiutiamo noi

Il formato non influisce sulle funzionalità: DARC Bridge elabora tutti e tre allo stesso modo.

Prossimi Passi

• Metodi di Invio - Scegli come trasmettere il file a Inciflex
• Pulsante "Invia ad Inciflex" - Integrazione diretta per sistemi chiusi