Skip to main content

Sending Methods

Once you've prepared the order file (in XML, CSV, or JSON), you can send it to DARC Bridge in several ways. Choose the one that best suits your infrastructure.

Email​

The simplest method: send the file as an attachment to a dedicated email address.

Address: provided by Inciflex during activation (e.g. ordini-YOURCODE@bridge.inciflex.it)

How to do it:

  1. Prepare the order file in one of the supported formats
  2. Attach it to an email
  3. Send to the dedicated address

DARC Bridge checks the mailbox, detects the attachment, processes it, and registers the order.

Requirements: none, you just need to be able to send emails with attachments.

Confirmation

You will receive a reply email with the processing result: order accepted or error details.

FTP / SFTP​

Upload the file to a remote folder. DARC Bridge monitors it and automatically picks up new files.

Credentials: provided by Inciflex during activation.

How to do it:

  1. Connect to the FTP/SFTP server with the credentials received
  2. Upload the file to the /ordini/ folder
  3. DARC Bridge detects and processes it automatically

Command line example:

# SFTP
sftp user@sftp.bridge.inciflex.it
put order-2025-001234.xml /ordini/

# or with curl
curl -T order-2025-001234.xml sftp://sftp.bridge.inciflex.it/ordini/ \
  -u user:password

Requirements: FTP or SFTP client (FileZilla, WinSCP, or built into your management system).

Automation

If your management system can export files to a folder, you can set up a scheduled task that uploads them via SFTP automatically.

REST API​

For those who want direct programmatic integration. Send the order with an HTTP POST call.

Endpoint: https://bridge.inciflex.it/api/v1/ordini

Authentication: API Key in the X-API-Key header (provided by Inciflex).

Example with 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"
      }
    ]
  }'

Example with XML file​

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

Response​

{
  "esito": "ok",
  "id_ordine": "DARC-2025-005678",
  "messaggio": "Ordine ricevuto e in elaborazione"
}

In case of error:

{
  "esito": "errore",
  "errori": [
    { "campo": "righe[0].codice_articolo", "messaggio": "Codice articolo non trovato" }
  ]
}

Requirements: ability to make HTTPS calls (any programming language, Postman, curl, etc.).

SOAP​

For systems using the SOAP/XML protocol (typical of enterprise management systems and SAP).

WSDL: https://bridge.inciflex.it/ws/ordini?wsdl

Request example​

<?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>

Requirements: SOAP client (SoapUI, SOAP libraries in your language, or native management system integration).

Which method should you choose?​

SituationRecommended method
You don't have an IT department and want something immediateEmail
Your management system exports files to a folderFTP/SFTP
You have developers or a system with integration capabilitiesREST API
You use an enterprise ERP with SOAP interfaces (e.g. SAP)SOAP

All methods are functionally equivalent: the order is processed the same way regardless of how you send it.

Next Steps​