Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edi-schnittstelle:kundenbestellungen_einlesen [2026/08/20 10:18] – Christoph Thum
+++ edi-schnittstelle:kundenbestellungen_einlesen [2026/09/03 10:22] (aktuell) – [Kundenbestellungen über die Webservice-API einlesen] Isabel Pinder
@@ Zeile 301: / Zeile 301: @@
   * **SammelRechnung**=#1 ;0 - nein, 1 - ja
   * **SbMitarbeiterNr** =# kein Eintrag oder Wert=0 - es wird der lt. CO zuständige Sachbearbeiter ermittelt, Wert > 0 - der vorgegebene Wert wird als Sachbearbeiternummer verwendet, Wert=-1 - der aktuell angemeldete Mitarbeiter wird verwendet
+===== Filteroptionen =====
+Damit nur wirkliche Bestellungen eingelesen werden, sind Filter in der Konfiguration sinnvoll. Bei XML-Bestellungen ist der Filter ***.xml** geeignet. Ausnahme bildet hier der offene Soennecken-Shop. Hier haben die Dateien verschiedene Endungen. In diesem Fall ist der Filter **order_FH_12704*** sinnvoll.
+===== Weiteres =====
+<html>
+<table width="100%" style="border:0px;">
+<tr>
+   <td style="border:3px solid #87220a; padding:5px; background-color:#ffebcd;">
+      <table width="100%" style="border:0px; margin:0px">
+         <tr>
+            <td width="100px" style="border:0px; text-align:center; padding:5px;" >
+               <img src="./scpictures/rechte.png">
+	    </td>
+	    <td style="border:0px; padding:10px;">
+<p><a href="http://www.software-concept.de/wiki/doku.php?id=administration:rechteverwaltung" style="color:#56B04F;">Sonderrecht</a> Kundenbestellungen einlesen</p>
+<p> Steuert, ob der Benutzer das Recht hat Kundenbestellungen einzulesen. </p>
+<ul style="color: #333333;">
+<li>  Ja
+<li>  Nein
+</ul>
+	    </td>
+	 </tr>
+      </table></td></tr></table>
+</html>
+{{tag>Edi-Schnittstelle OEXXML Kundenbestellungen}}
 ===== Kundenbestellungen über die Webservice-API einlesen =====
@@ Zeile 315: / Zeile 347: @@
 Die Pfade gelten unterhalb des hinterlegten Endpunktes für den Service Host, also z.B. unterhalb von %%http://<server>:<port>/Office/CoServiceRestApi/%%
-  * **office/currentUser/authentication** (POST): Anmeldung. Der Body enthält Benutzer und Kennwort, die Antwort den Token mit **Login**, **Key** und **Mandant**.
   * **office/auftraege/importOpenTrans?section=<Sektion>&token=<Token>** (POST): Import. Der Dateiinhalt wird als Bytestream im Body übergeben. Als **section** sind nur Sektionen zulässig, die in der //Kundenbestellung_einlesen.ini// angelegt sind.
-<note>
-Der Token kann auf zwei Arten übergeben werden: als JSON (dann URL-kodiert) oder als **base64:<Wert>**, wobei <Wert> die url-sichere Base64-Kodierung des Token-JSON ist (**+** wird zu **-**, **/** wird zu **_**, Füllzeichen **=** entfallen). Die zweite Variante ist im Alltag praktikabler, da im Aufruf keine Sonderzeichen auftreten.
-</note>
 <html>
@@ Zeile 332: / Zeile 359: @@
         </td>
         <td style="border:0px; padding:10px; ">
-<p><b>Beispiel:</b> Anmeldung und Übergabe einer Bestellung</p>
+<p><b>Beispiel:</b>Übergabe einer Bestellung</p>
-<p><code>curl -X POST "http://localhost:8080/Office/CoServiceRestApi/office/currentUser/authentication" -H "Content-Type: application/json" -d "{ \"UserName\": \"&lt;Benutzer&gt;\", \"Password\": \"&lt;Kennwort&gt;\" }"</code></p>
 <p><code>curl -X POST "http://localhost:8080/Office/CoServiceRestApi/office/auftraege/importOpenTrans?section=xmlOEXOrderImport&amp;token=base64:&lt;Token&gt;" -H "Content-Type: application/xml" --data-binary "@bestellung.xml"</code></p>
         </td>
@@ Zeile 346: / Zeile 372: @@
   * **Message**: Meldungstext
-<note tip>
-Ein Vorgang kann angelegt werden und trotzdem Prüffehler enthalten, etwa bei einzelnen fehlerhaften Positionen. Diese Prüffehler werden wie beim Einlesen aus einem Verzeichnis in der //Dispo-Bemerkung// des Vorgangs protokolliert.
-</note>
-Voraussetzung ist das Recht zum Anlegen von Vorgängen.
+<html>
+<table width="100%" style="border:0px;">
+<tr>
+   <td style="border:3px solid #87220a; padding:5px; background-color:#ffebcd;">
+      <table width="100%" style="border:0px; margin:0px">
+         <tr>
+            <td width="100px" style="border:0px; text-align:center; padding:5px;" >
+               <img src="./scpictures/rechte.png">
+	    </td>
+	    <td style="border:0px; padding:10px;">
+<p><a href="http://www.software-concept.de/wiki/doku.php?id=administration:rechteverwaltung" style="color:#56B04F;"></a>Voraussetzung ist das Recht zum Anlegen von Vorgängen</p>
+<p></p>
+<ul style="color: #333333;">
+</ul>
+	    </td>
+	 </tr>
+      </table></td></tr></table>
+</html>
-Beim Einlesen aus einem Verzeichnis bleibt die eingelesene Datei erhalten und wird über die Einstellungen der EDI-Konfiguration archiviert. Bei der Übergabe über die API existiert keine solche Datei. Damit die übermittelten Bestellungen dennoch nachvollziehbar bleiben, können im Übernahmeschema zwei Verzeichnisse hinterlegt werden:
+Archivierung der Bestellung:
-  * **_ApiArchivVerzeichnis**: für Bestellungen, aus denen ein Vorgang entstanden ist
+  * **_ApiArchivVerzeichnis**
-  * **_ApiFehlerArchivVerzeichnis**: für Bestellungen ohne Vorgang
+  * **_ApiFehlerArchivVerzeichnis**
 <html>
@@ Zeile 377: / Zeile 419: @@
 <note important>
-Beide Angaben müssen vollständige Pfade sein. Relative Angaben werden ignoriert und im Protokoll der EDI-Schnittstelle vermerkt. Ist kein Verzeichnis angegeben, wird nicht archiviert. Diese Verzeichnisse gelten ausschließlich für den Import über die API.
+Ist kein Verzeichnis angegeben, wird nicht archiviert. Diese Verzeichnisse gelten ausschließlich für den Import über die API.
 </note>
-Die Dateien werden nach dem Muster **API_<Sektion>_<Zeitstempel>_<Auftragsnummer>.xml** abgelegt. Konnte kein Vorgang angelegt werden, entfällt die Auftragsnummer im Dateinamen.
+Die Dateien werden nach dem Muster **API_<Sektion>_<YYYYMMDD>_<HHMMSS>_<Auftragsnummer>.xml** abgelegt.
-===== Filteroptionen =====
+Konnte kein Vorgang angelegt werden, entfällt die Auftragsnummer im Dateinamen.
-Damit nur wirkliche Bestellungen eingelesen werden, sind Filter in der Konfiguration sinnvoll. Bei XML-Bestellungen ist der Filter ***.xml** geeignet. Ausnahme bildet hier der offene Soennecken-Shop. Hier haben die Dateien verschiedene Endungen. In diesem Fall ist der Filter **order_FH_12704*** sinnvoll.
-===== Weiteres =====
-<html>
+Die Protokollierung erfolgt nach derselben Logik wie beim EDI-Import.
-<table width="100%" style="border:0px;">
-<tr>
-   <td style="border:3px solid #87220a; padding:5px; background-color:#ffebcd;">
-      <table width="100%" style="border:0px; margin:0px">
-         <tr>
-            <td width="100px" style="border:0px; text-align:center; padding:5px;" >
-               <img src="./scpictures/rechte.png">
-	    </td>
-	    <td style="border:0px; padding:10px;">
-<p><a href="http://www.software-concept.de/wiki/doku.php?id=administration:rechteverwaltung" style="color:#56B04F;">Sonderrecht</a> Kundenbestellungen einlesen</p>
-<p> Steuert, ob der Benutzer das Recht hat Kundenbestellungen einzulesen. </p>
-<ul style="color: #333333;">
-<li>  Ja
-<li>  Nein
-</ul>
-	    </td>
-	 </tr>
-      </table></td></tr></table>
-</html>
-{{tag>Edi-Schnittstelle OEXXML Kundenbestellungen}}