Passa al contenuto principale

Metodi di Invio

Una volta preparato il file con l'ordine (in XML, CSV o JSON), puoi inviarlo a DARC Bridge in diversi modi. Scegli quello più adatto alla tua infrastruttura.

Email​

Il metodo più semplice: invia il file come allegato ad un indirizzo email dedicato.

Indirizzo: fornito da Inciflex durante l'attivazione (es. ordini-TUOCODICE@bridge.inciflex.it)"

Come fare:

  1. Prepara il file dell'ordine in uno dei formati supportati
  2. Allegalo ad una email
  3. Invia all'indirizzo dedicato

DARC Bridge controlla la casella, rileva l'allegato, lo elabora e registra l'ordine.

Requisiti: nessuno, basta poter inviare email con allegati.

Conferma

Riceverai una email di risposta con l'esito dell'elaborazione: ordine accettato o dettaglio degli errori.

FTP / SFTP​

Deposita il file in una cartella remota. DARC Bridge la monitora e preleva automaticamente i nuovi file.

Credenziali: fornite da Inciflex durante l'attivazione.

Come fare:

  1. Connettiti al server FTP/SFTP con le credenziali ricevute
  2. Carica il file nella cartella /ordini/
  3. DARC Bridge lo rileva e lo elabora automaticamente

Esempio con riga di comando:

# SFTP
sftp utente@sftp.bridge.inciflex.it
put ordine-2025-001234.xml /ordini/

# oppure con curl
curl -T ordine-2025-001234.xml sftp://sftp.bridge.inciflex.it/ordini/ \
  -u utente:password
```"

**Requisiti**: client FTP o SFTP (FileZilla, WinSCP, o integrato nel gestionale).

:::tip[Automazione]
Se il tuo gestionale può esportare file in una cartella, puoi configurare un task schedulato che li carica via SFTP automaticamente.
:::

---

## API REST

Per chi vuole un'integrazione programmatica diretta. Invia l'ordine con una chiamata HTTP POST.

**Endpoint**: `https://bridge.inciflex.it/api/v1/ordini`"

**Autenticazione**: API Key nell'header `X-API-Key` (fornita da Inciflex).

### Esempio con JSON

```bash
curl -X POST https://bridge.inciflex.it/api/v1/ordini \
  -H "Content-Type: application/json" \
  -H "X-API-Key: LA_TUA_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"
      }
    ]
  }'
```"

### Esempio con file XML

```bash
curl -X POST https://bridge.inciflex.it/api/v1/ordini \
  -H "Content-Type: application/xml" \
  -H "X-API-Key: LA_TUA_API_KEY" \
  -d @ordine-2025-001234.xml
```"

### Risposta

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

In caso di errore:

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

Requisiti: capacità di fare chiamate HTTPS (qualsiasi linguaggio di programmazione, Postman, curl, ecc.).

SOAP​

Per sistemi che usano il protocollo SOAP/XML (tipico di gestionali enterprise e SAP).

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

Esempio di richiesta​

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

Requisiti: client SOAP (SoapUI, librerie SOAP nel tuo linguaggio, o integrazione nativa del gestionale).

Quale metodo scegliere?​

SituazioneMetodo consigliato
Non hai un reparto IT e vuoi qualcosa di immediatoEmail
Il tuo gestionale esporta file in una cartellaFTP/SFTP
Hai sviluppatori o un sistema con capacità di integrazioneAPI REST
Usi un ERP enterprise con interfacce SOAP (es. SAP)SOAP

Tutti i metodi sono equivalenti dal punto di vista funzionale: l'ordine viene elaborato allo stesso modo indipendentemente da come lo invii.

Prossimi Passi​