Zum Hauptinhalt springen

Versandmethoden

Sobald Sie die Auftragsdatei vorbereitet haben (in XML, CSV oder JSON), können Sie sie auf verschiedene Weisen an DARC Bridge senden. Wählen Sie die Methode, die am besten zu Ihrer Infrastruktur passt.

Email​

Die einfachste Methode: Senden Sie die Datei als Anhang an eine dedizierte E-Mail-Adresse.

Adresse: von Inciflex bei der Aktivierung bereitgestellt (z.B. ordini-IHRCODE@bridge.inciflex.it)

So geht's:

  1. Bereiten Sie die Auftragsdatei in einem der unterstützten Formate vor
  2. Hängen Sie sie an eine E-Mail an
  3. Senden Sie an die dedizierte Adresse

DARC Bridge prüft das Postfach, erkennt den Anhang, verarbeitet ihn und registriert den Auftrag.

Voraussetzungen: keine, Sie müssen lediglich E-Mails mit Anhängen versenden können.

Bestätigung

Sie erhalten eine Antwort-E-Mail mit dem Verarbeitungsergebnis: Auftrag angenommen oder Fehlerdetails.

FTP / SFTP​

Laden Sie die Datei in einen Remote-Ordner hoch. DARC Bridge überwacht diesen und holt neue Dateien automatisch ab.

Zugangsdaten: von Inciflex bei der Aktivierung bereitgestellt.

So geht's:

  1. Verbinden Sie sich mit den erhaltenen Zugangsdaten zum FTP/SFTP-Server
  2. Laden Sie die Datei in den Ordner /ordini/ hoch
  3. DARC Bridge erkennt und verarbeitet sie automatisch

Kommandozeilenbeispiel:

# SFTP
sftp benutzer@sftp.bridge.inciflex.it
put auftrag-2025-001234.xml /ordini/

# oder mit curl
curl -T auftrag-2025-001234.xml sftp://sftp.bridge.inciflex.it/ordini/ \
  -u benutzer:passwort

Voraussetzungen: FTP- oder SFTP-Client (FileZilla, WinSCP, oder in Ihrem Verwaltungssystem integriert).

Automatisierung

Wenn Ihr Verwaltungssystem Dateien in einen Ordner exportieren kann, können Sie einen geplanten Task einrichten, der sie automatisch via SFTP hochlädt.

REST API​

Für diejenigen, die eine direkte programmatische Integration wünschen. Senden Sie den Auftrag mit einem HTTP-POST-Aufruf.

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

Authentifizierung: API-Schlüssel im Header X-API-Key (von Inciflex bereitgestellt).

Beispiel mit JSON​

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

Beispiel mit XML-Datei​

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

Antwort​

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

Im Fehlerfall:

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

Voraussetzungen: Fähigkeit, HTTPS-Aufrufe durchzuführen (jede Programmiersprache, Postman, curl, usw.).

SOAP​

Für Systeme, die das SOAP/XML-Protokoll verwenden (typisch für Enterprise-Verwaltungssysteme und SAP).

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

Anfrage-Beispiel​

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

Voraussetzungen: SOAP-Client (SoapUI, SOAP-Bibliotheken in Ihrer Programmiersprache, oder native Integration des Verwaltungssystems).

Welche Methode sollten Sie wählen?​

SituationEmpfohlene Methode
Sie haben keine IT-Abteilung und möchten etwas SofortigesEmail
Ihr Verwaltungssystem exportiert Dateien in einen OrdnerFTP/SFTP
Sie haben Entwickler oder ein System mit IntegrationsfähigkeitenREST API
Sie verwenden ein Enterprise-ERP mit SOAP-Schnittstellen (z.B. SAP)SOAP

Alle Methoden sind funktional gleichwertig: Der Auftrag wird unabhängig von der Versandart gleich verarbeitet.

Nächste Schritte​