Formatos de datos compatibles
DARC Bridge acepta pedidos en tres formatos: XML, CSV y JSON. Utiliza el que resulte más cómodo para tu sistema de gestión.
Los tres formatos contienen la misma información. A continuación encontrarás la estructura de cada uno con un ejemplo completo.
Campos del pedido
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
codice_cliente | string | ✅ | Tu código de cliente en Inciflex |
riferimento_ordine | string | ✅ | El número de pedido en tu sistema |
data_ordine | fecha (YYYY-MM-DD) | ✅ | Fecha de emisión del pedido |
data_consegna | fecha (YYYY-MM-DD) | Fecha de entrega solicitada | |
note | string | Observaciones del pedido | |
righe | lista | ✅ | Al menos una línea de pedido |
Campos de línea
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
codice_articolo | string | ✅ | Código de artículo en Inciflex |
descrizione | string | Descripción del artículo | |
quantita | number | ✅ | Cantidad pedida |
unita_misura | string | Unidad de medida (p. ej. PZ, KG, MT) | |
prezzo_unitario | number | Precio unitario acordado | |
note_riga | string | Observaciones por línea |
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>Entrega en almacén central</note>
<righe>
<riga>
<codice_articolo>ART-500</codice_articolo>
<descrizione>Brida 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>Junta DN50</descrizione>
<quantita>100</quantita>
<unita_misura>PZ</unita_misura>
<prezzo_unitario>1.80</prezzo_unitario>
<note_riga>Material EPDM</note_riga>
</riga>
</righe>
</ordine>
El esquema XSD para validación está disponible a petición del soporte técnico de Inciflex.
CSV
El archivo CSV usa ; (punto y coma) como separador. La primera fila es la cabecera.
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;Brida DN50 PN16;100;PZ;12.50;Entrega en almacén central;
CLI001;ORD-2025-001234;2025-10-15;2025-11-01;ART-601;Junta DN50;100;PZ;1.80;;Material EPDM
Cada fila del CSV corresponde a una línea de pedido. Los campos de cabecera (codice_cliente, riferimento_ordine, etc.) deben repetirse en cada fila.
El archivo debe estar codificado en UTF-8. Si usas Excel para generarlo, verifica que la exportación sea en formato CSV UTF-8.
JSON
{
"codice_cliente": "CLI001",
"riferimento_ordine": "ORD-2025-001234",
"data_ordine": "2025-10-15",
"data_consegna": "2025-11-01",
"note": "Entrega en almacén central",
"righe": [
{
"codice_articolo": "ART-500",
"descrizione": "Brida DN50 PN16",
"quantita": 100,
"unita_misura": "PZ",
"prezzo_unitario": 12.50
},
{
"codice_articolo": "ART-601",
"descrizione": "Junta DN50",
"quantita": 100,
"unita_misura": "PZ",
"prezzo_unitario": 1.80,
"note_riga": "Material EPDM"
}
]
}
El esquema JSON para validación está disponible a petición del soporte técnico de Inciflex.
¿Qué formato debo elegir?
| Situación | Formato recomendado |
|---|---|
| Tu sistema exporta archivos estructurados | XML |
| Usas Excel o hojas de cálculo | CSV |
| Tu sistema tiene APIs o produce datos estructurados | JSON |
| No estás seguro | Contacta al soporte de Inciflex, te ayudamos |
El formato no afecta la funcionalidad: DARC Bridge procesa los tres de la misma manera.
Próximos pasos
- Métodos de envío — Elige cómo transmitir el archivo a Inciflex
- Botón "Enviar a Inciflex" — Integración directa para sistemas cerrados