• Zugangsdaten, Testdaten
• Nachrichten per FTP an Opticland
• Nachrichten per FTP von Opticland

Telefon:	09122/9386-0
Telefax:	09122/9386-68
eMail:	hel@softpoint.de

Sie erhalten

• den FTP Rechnernamen (FTP_HOST) zum Nachrichtenaustausch
• den FTP Benutzernamen (FTP_USER)
• das FTP Paßwort (FTP_PASS)
• eine Kunden/Lieferstelle-Kennung (KLK)
• einen Schlüssel zur Verschlüsselung/Entschlüsselung der auszutauschenden Nachrichten (MSG_SECRET)
• ein Paßwort (WEB_PASS), mit dem der Status eingegangener Bestellungen verfolgt werden kann:

  Webaddresse www.opticland.de/test/, Benutzername=<KLK>, Paßwort=<WEB_PASS>

• Testdaten, Testscripts, etc.

• Anmeldung beim FTP Server

  Die Anmeldung erfolgt am Rechner <FTP_HOST> mit Benutzernamen <FTP_USER> und Paßwort <FTP_PASS>.

• Übermittlung der Nachricht(en)
  • Alle Nachrichten müssen in binärform übermittelt werden (FTP Kommando "type i").

  • Nachrichten sind in das Verzeichnis "/in" abzustellen.

  • Jede Nachricht ist erst unter einem temporären Namen abzustellen und nach erfolgreicher Übermittlung umzubenennen. Dadurch wird sichergestellt, daß nur vollständig übermittelte Nachrichten weiterverarbeitet werden.

  • Der temporäre Dateiname lautet "/in/<SERNUM>-<KLK>-<MSG_TYPE>.tmp".

  • Der Name, in den die erfolgreich übermittelte Datei umzubennen ist, lautet "/in/<SERNUM>-<KLK>-<MSG_TYPE>.pgp".

  • Die im Namen enthaltene Seriennummer (SERNUM) bestimmt bei mehreren gleichzeitig im Verzeichnis "/in" vorhandenen Nachrichten die Reihenfolge Ihrer Weiterverarbeitung.

    Die Seriennummer (SERNUM) kann im Rahmen folgender Kriterien frei gewählt werden:

    • Maximale Länge 32 Zeichen.
    • Erlaubte Zeichen sind "a" bis "z", "A" bis "Z" und "0" bis "9".
    • Die Sortierreihenfolge basiert auf den ASCII-Zeichenwerten ohne Unterscheidung der Groß-/Kleinschreibung (lexikalische Sortierung), d. h. die Seriennummer "9abc" wird nach "10abc" verarbeitet.

• Auslösung der Weiterverarbeitung

  • Die Weiterverarbeitung wird durch die Übermittlung einer Trigger-Datei angestoßen. Der Dateiinhalt ist dabei ohne Bedeutung, diese Datei kann daher auch leer sein. Wichtig ist nur der Name der Datei: "/trg/in.trg". Achten Sie bitte auch darauf, dass diese Datei immer zuletzt übertragen wird (nach der vollständigen Übertragung der eigentlichen Nachrichten)

  • Dateien der Form "/in/<SERNUM>-<KLK>-<MSG_TYPE>.pgp" werden zu Beginn der Weiterverarbeitung aus dem Verzeichnis "/in" entfernt. Falls die Nachricht nicht entschlüsselt bzw. entpackt werden kann, wird sie unverändert in das Verzeichnis "/err" abgestellt. Zusätzlich wird eine Datei mit dem Namen "/err/<SERNUM>-<KLK>-<MSG_TYPE>.pgp-error.txt" erstellt, die die Fehlerursache dokumentiert.

  • Dateien, die nicht der Form "/in/<SERNUM>-<KLK>-<MSG_TYPE>.pgp" entsprechen, werden nach 48 Stunden unverändert in das Verzeichnis "/err" abgestellt und aus "/in" entfernt.

  • Dateien, die in das Verzeichnis "/err" gestellt wurden, werden nach 32 Tagen automatisch entfernt.

Kunden/Lieferstelle-Kennung (KLK):	"sopo-5"
Verschlüsselung (MSG_SECRET):	"sopo-5-sec"
FTP Benutzername (FTP_USER):	"ol-sopo-5"
FTP Paßwort (FTP_PASS):	"ol-sopo-5-pass"
Nachrichtentyp (MSG_TYPE):	Bestellungen (ORDERS)
Nachrichtenaufbau (MSG_FORMAT):	OL-PARTNER-TABSEP

1.	Erzeugung einer Datei "orders_h.txt" (Bestellkopf) gemäß Spezifikation ORDERS/OL-PARTNER-TABSEP.
2.	Erzeugung einer Datei "orders_p.txt" (Bestellpositionen) gemäß Spezifikation ORDERS/OL-PARTNER-TABSEP.
3.	Erzeugung einer Datei "orders.tar", bestehend aus "orders_h.txt" und "orders_p.txt". Das dazu benötigte Programm "tar" ist frei verfügbar (Windows: "tar.exe", UNIX: "tar"). Sie können es auch von SoftPoint erhalten.
4.	Verschlüsseln von "orders.tar" zu "orders.pgp" mit dem Schlüssel "sopo-5-sec" (MSG_SECRET). Das dazu benötigte Programm "gnupg" ist frei verfügbar (Windows: "gnupg.exe", UNIX: "gpg"). Sie können es auch von SoftPoint erhalten.
5.	Verbindungsaufbau zum FTP-Server <FTP_HOST> mit Benutzername "ol-sopo-5" (FTP_USER) und Paßwort "ol-sopo-5-pass" (FTP_PASS).
6.	Binären Übertragungsmodus anschalten mit dem FTP Kommando "type i".
7.	Datei "orders.pgp" auf dem FTP-Server unter "/in/2000032812430100-sopo-5-orders.tmp" ablegen, z. B. mit dem FTP-Kommando "put orders.pgp /in/2000032812430100-sopo-5-orders.tmp". Beachten Sie die Verwendung der Kunden/Lieferstelle-Kennung (KLK) "sopo-5" im Dateinamen!
8.	Datei "/in/2000032812430100-sopo-5-orders.tmp" nach "/in/2000032812430100-sopo-5-orders.pgp" umbenennen, z. B. mit dem FTP-Kommando "rename /in/2000032812430100-sopo-5-orders.tmp /in/2000032812430100-sopo-5-orders.pgp".
9.	Eine beliebige, kurze (auch leere) Datei auf dem FTP-Server unter "/trg/in.trg" ablegen, um eine sofortige Weiterverarbeitung anzustoßen.

Nachrichten per FTP von Opticland

• Anmeldung beim FTP Server

  Die Anmeldung erfolgt am Rechner <FTP_HOST> mit Benutzernamen <FTP_USER> und Paßwort <FTP_PASS>.

• Abfragen der zur Abholung bereit stehenden Nachrichten

  • Alle zur Abholung bereit stehenden Nachrichten können durch Auflisten des Verzeichnisses "/out" angezeigt werden.

  • Die Nachrichten sind in Dateien der Form "/out/<SERNUM>-<KLK>-<MSG_TYPE>.pgp" bzw. "/out/<SERNUM>-<KLK>-<MSG_TYPE>.tar" abgelegt.

• Übermittlung der Nachricht(en)

  • Alle Nachrichten müssen in binärform übermittelt werden (FTP Kommando "type i").

  • Nach erfolgreicher Abholung einer Datei sollte Sie auf dem FTP-Server gelöscht werden.

Kunden/Lieferstelle-Kennung (KLK):	"sopo-5"
Verschlüsselung (MSG_SECRET):	"sopo-5-sec"
FTP Benutzername (FTP_USER):	"ol-sopo-5"
FTP Paßwort (FTP_PASS):	"ol-sopo-5-pass"
Nachrichtentyp (MSG_TYPE):	Bestellbestätigung (ORDRSP)
Nachrichtenaufbau (MSG_FORMAT):	OL-PARTNER-TABSEP

1.	Verbindungsaufbau zum FTP-Server <FTP_HOST> mit Benutzername "ol-sopo-5" (FTP_USER) und Paßwort "ol-sopo-5-pass" (FTP_PASS).
2.	Binären Übertragungsmodus anschalten mit dem FTP Kommando "type i".
3.	Auflisten der zur Abholung bereit stehenden Nachrichten im Vezeichnis "/out", z. B. mit dem FTP Kommando "dir /out". Dieses Beispiel geht davon aus, daß eine Bestellbestätigung (ORDRSP) mit dem Dateinamen "/out/2000032920304001-sopo-5-ordrsp.pgp" bereit steht.
4.	Abholung der Datei, z. B. mit dem FTP Kommando "get /out/2000032920304001-sopo-5-ordrsp.pgp ordrsp.pgp".
5.	Löschen der Datei auf dem FTP-Server, z. B. mit dem FTP Kommando "delete /out/2000032920304001-sopo-5-ordrsp.pgp".
6.	Entschlüsseln von "ordrsp.pgp" zu "ordrsp.tar" mit dem Schlüssel "sopo-5-sec" (MSG_SECRET). Das dazu benötigte Programm "gnupg" ist frei verfügbar (Windows: "gnupg.exe", UNIX: "gpg"). Sie können es auch von SoftPoint erhalten. Dieser Schritt ist nur bei verschlüsselten Nachrichten notwendig.
7.	Entpacken von "ordrsp.tar" zu "ordrsp_h.tar" und "ordrsp_p.tar". Das dazu benötigte Programm "tar" ist frei verfügbar (Windows: "tar.exe", UNIX: "tar"). Sie können es auch von SoftPoint erhalten.
8.	Sie erhalten die Datei "ordrsp_h.txt" (Bestellbestätigungskopf) und im Falle von Fehlern die Datei "ordrsp_p.txt" (Bestellbestätigungspositionen) gemäß Spezifikation ORDRSP/OL-PARTNER-TABSEP zur Weiterverarbeitung.

Zurück zur Übersicht