Aller au contenu principal

Méthodes d'Envoi

Une fois le fichier de commande préparé (en XML, CSV ou JSON), vous pouvez l'envoyer à DARC Bridge de plusieurs manières. Choisissez celle qui convient le mieux à votre infrastructure.

Email​

La méthode la plus simple : envoyez le fichier en pièce jointe à une adresse email dédiée.

Adresse : fournie par Inciflex lors de l'activation (ex. ordini-VOTRECODE@bridge.inciflex.it)

Comment faire :

  1. Préparez le fichier de commande dans l'un des formats supportés
  2. Joignez-le à un email
  3. Envoyez à l'adresse dédiée

DARC Bridge vérifie la boîte mail, détecte la pièce jointe, la traite et enregistre la commande.

Prérequis : aucun, il suffit de pouvoir envoyer des emails avec pièces jointes.

Confirmation

Vous recevrez un email de réponse avec le résultat du traitement : commande acceptée ou détail des erreurs.

FTP / SFTP​

Déposez le fichier dans un dossier distant. DARC Bridge le surveille et récupère automatiquement les nouveaux fichiers.

Identifiants : fournis par Inciflex lors de l'activation.

Comment faire :

  1. Connectez-vous au serveur FTP/SFTP avec les identifiants reçus
  2. Téléchargez le fichier dans le dossier /ordini/
  3. DARC Bridge le détecte et le traite automatiquement

Exemple en ligne de commande :

# SFTP
sftp utilisateur@sftp.bridge.inciflex.it
put commande-2025-001234.xml /ordini/

# ou avec curl
curl -T commande-2025-001234.xml sftp://sftp.bridge.inciflex.it/ordini/ \
  -u utilisateur:motdepasse

Prérequis : client FTP ou SFTP (FileZilla, WinSCP, ou intégré dans votre système de gestion).

Automatisation

Si votre système de gestion peut exporter des fichiers dans un dossier, vous pouvez configurer une tâche planifiée qui les télécharge via SFTP automatiquement.

API REST​

Pour ceux qui veulent une intégration programmatique directe. Envoyez la commande avec un appel HTTP POST.

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

Authentification : Clé API dans l'en-tête X-API-Key (fournie par Inciflex).

Exemple avec JSON​

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

Exemple avec fichier XML​

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

Réponse​

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

En cas d'erreur :

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

Prérequis : capacité à effectuer des appels HTTPS (tout langage de programmation, Postman, curl, etc.).

SOAP​

Pour les systèmes utilisant le protocole SOAP/XML (typique des systèmes de gestion d'entreprise et SAP).

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

Exemple de requête​

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

Prérequis : client SOAP (SoapUI, bibliothèques SOAP dans votre langage, ou intégration native du système de gestion).

Quelle méthode choisir ?​

SituationMéthode recommandée
Vous n'avez pas de service informatique et voulez quelque chose d'immédiatEmail
Votre système de gestion exporte des fichiers dans un dossierFTP/SFTP
Vous avez des développeurs ou un système avec des capacités d'intégrationAPI REST
Vous utilisez un ERP d'entreprise avec interfaces SOAP (ex. SAP)SOAP

Toutes les méthodes sont fonctionnellement équivalentes : la commande est traitée de la même manière quel que soit le mode d'envoi.

Prochaines Étapes​