Skip to main content

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

CampoTipoObligatorioDescripción
codice_clientestringTu código de cliente en Inciflex
riferimento_ordinestringEl número de pedido en tu sistema
data_ordinefecha (YYYY-MM-DD)Fecha de emisión del pedido
data_consegnafecha (YYYY-MM-DD)Fecha de entrega solicitada
notestringObservaciones del pedido
righelistaAl menos una línea de pedido

Campos de línea

CampoTipoObligatorioDescripción
codice_articolostringCódigo de artículo en Inciflex
descrizionestringDescripción del artículo
quantitanumberCantidad pedida
unita_misurastringUnidad de medida (p. ej. PZ, KG, MT)
prezzo_unitarionumberPrecio unitario acordado
note_rigastringObservaciones 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>
XSD

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.

Encoding

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"
}
]
}
JSON Schema

El esquema JSON para validación está disponible a petición del soporte técnico de Inciflex.


¿Qué formato debo elegir?

SituaciónFormato recomendado
Tu sistema exporta archivos estructuradosXML
Usas Excel o hojas de cálculoCSV
Tu sistema tiene APIs o produce datos estructuradosJSON
No estás seguroContacta al soporte de Inciflex, te ayudamos

El formato no afecta la funcionalidad: DARC Bridge procesa los tres de la misma manera.

Próximos pasos