Métodos de envío
Una vez que hayas preparado el archivo de pedido (en XML, CSV o JSON), puedes enviarlo a DARC Bridge de varias formas. Elige la que mejor se adapte a tu infraestructura.
Email
El método más sencillo: envía el archivo como adjunto a una dirección de correo dedicada.
Dirección: proporcionada por Inciflex durante la activación (p. ej. ordini-YOURCODE@bridge.inciflex.it)"
Cómo hacerlo:
- Prepara el archivo de pedido en uno de los formatos admitidos
- Adjunta el archivo al correo
- Envía el correo a la dirección indicada
DARC Bridge revisa el buzón, detecta el adjunto, lo procesa y registra el pedido.
Requisitos: ninguno; solo necesitas poder enviar correos con adjuntos.
Recibirás un correo de respuesta con el resultado del procesamiento: pedido aceptado o detalles del error.
FTP / SFTP
Sube el archivo a una carpeta remota. DARC Bridge la supervisa y recoge automáticamente los archivos nuevos.
Credenciales: proporcionadas por Inciflex durante la activación.
Cómo hacerlo:
- Conéctate al servidor FTP/SFTP con las credenciales recibidas
- Sube el archivo a la carpeta
/ordini/ - DARC Bridge detecta y procesa el archivo automáticamente
Ejemplo en línea de comandos:
# SFTP
sftp user@sftp.bridge.inciflex.it
put order-2025-001234.xml /ordini/
# o con curl
curl -T order-2025-001234.xml sftp://sftp.bridge.inciflex.it/ordini/ \\"
-u user:password
Requisitos: cliente FTP/SFTP (FileZilla, WinSCP, o integrado en tu sistema de gestión).
Si tu sistema puede exportar archivos a una carpeta, puedes programar una tarea que los suba automáticamente vía SFTP.
REST API
Para quien necesite integración programática directa. Envía el pedido con una llamada HTTP POST.
Endpoint: https://bridge.inciflex.it/api/v1/ordini"
Autenticación: API Key en la cabecera X-API-Key (proporcionada por Inciflex).
Ejemplo con JSON
curl -X POST https://bridge.inciflex.it/api/v1/ordini \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"
"codice_cliente": "CLI001",
"riferimento_ordine": "ORD-2025-001234",
"data_ordine": "2025-10-15",
"data_consegna": "2025-11-01",
"righe": [
{
"codice_articolo": "ART-500",
"quantita": 100,
"unita_misura": "PZ"
}
]
}'
Ejemplo con archivo XML
curl -X POST https://bridge.inciflex.it/api/v1/ordini \
-H "Content-Type: application/xml" \
-H "X-API-Key: YOUR_API_KEY" \
-d @order-2025-001234.xml
```"
### Respuesta
```json
{
"esito": "ok",
"id_ordine": "DARC-2025-005678",
"messaggio": "Ordine ricevuto e in elaborazione"
}
En caso de error:
{
"esito": "errore",
"errori": [
{ "campo": "righe[0].codice_articolo", "messaggio": "Codice articolo non trovato" }
]
}
Requisitos: capacidad para realizar llamadas HTTPS (cualquier lenguaje, Postman, curl, etc.).
SOAP
Para sistemas que usan el protocolo SOAP/XML (típico en ERPs empresariales y SAP).
WSDL: https://bridge.inciflex.it/ws/ordini?wsdl
"
Ejemplo de petición
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ord="https://bridge.inciflex.it/ws/ordini">"
<soapenv:Header>
<ord:Autenticazione>
<ord:ApiKey>YOUR_API_KEY</ord:ApiKey>
</ord:Autenticazione>
</soapenv:Header>
<soapenv:Body>
<ord:InviaOrdine>
<ord:codice_cliente>CLI001</ord:codice_cliente>
<ord:riferimento_ordine>ORD-2025-001234</ord:riferimento_ordine>
<ord:data_ordine>2025-10-15</ord:data_ordine>
<ord:righe>
<ord:riga>
<ord:codice_articolo>ART-500</ord:codice_articolo>
<ord:quantita>100</ord:quantita>
<ord:unita_misura>PZ</ord:unita_misura>
</ord:riga>
</ord:righe>
</ord:InviaOrdine>
</soapenv:Body>
</soapenv:Envelope>
Requisitos: cliente SOAP (SoapUI, librerías SOAP en tu lenguaje o integración nativa del sistema).
¿Qué método debería elegir?
| Situación | Método recomendado |
|---|---|
| No tienes departamento de TI y quieres algo inmediato | |
| Tu sistema exporta archivos a una carpeta | FTP/SFTP |
| Tienes desarrolladores o capacidades de integración | REST API |
| Usas un ERP empresarial con interfaces SOAP (p. ej. SAP) | SOAP |
Todos los métodos son funcionalmente equivalentes: el pedido se procesa igual independientemente de cómo lo envíes.
Próximos pasos
- Formatos de datos — Detalle de XML, CSV, JSON
- Métodos de envío — Envío vía Email, FTP, REST, SOAP