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://api.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://api.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​

curl -X POST https://api.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 (201 Created)​

{
  "esito": "ok",
  "id_ordine": "57138",
  "numero_ordine": "2026-104",
  "messaggio": "Ordine ricevuto e processato con successo"
}

In caso di errore (400 Bad Request):

{
  "statusCode": 400,
  "message": [
    "codice_cliente must be a string",
    "righe must contain at least 1 elements"
  ],
  "error": "Bad Request"
}

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

Integrazioni Connettori Terzi (Esko Cloudflow / SAP)​

Per connettori dedicati di prestampa (es. Esko Cloudflow) o flussi custom strutturati, il server supporta l'ingestione specializzata tramite header di sicurezza dedicato sotara-x-key e binding sui siti di produzione.

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 (JSON/XML)
Integrazioni flussi prestampa dedicati (Cloudflow/SAP)Connettori Specializzati

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

Prossimi Passi​