Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edi-schnittstelle:kundenbestellungen_einlesen [2026/07/28 13:27] – [Einleseoptionen] Isabel Pinder
+++ edi-schnittstelle:kundenbestellungen_einlesen [2026/09/03 10:22] (aktuell) – [Kundenbestellungen über die Webservice-API einlesen] Isabel Pinder
@@ Zeile 59: / Zeile 59: @@
   * **_AnschriftenUeberKostenstelle**: bei >0 werden die Anschriften über die Kostenstelle ermittelt, sofern der Kunde vorhanden und eine Kostenstelle angegeben ist
   * **_APBestellungInBestellnummer**: bei >0 wird der AP für die Bestellung (gegebenenfalls nach der Bestellnummer und dem Bestelldatum) in das Bestellnummern-Feld von CO eingetragen
+  * **_ApiArchivVerzeichnis**: Verzeichnis, in dem Kundenbestellungen abgelegt werden, die über die Webservice-API importiert wurden und zu einem Vorgang geführt haben. Es ist ein vollständiger Pfad anzugeben; ohne Angabe erfolgt keine Archivierung. Gilt nicht für das Einlesen aus einem Verzeichnis. Siehe Abschnitt „Kundenbestellungen über die Webservice-API einlesen“.
+  * **_ApiFehlerArchivVerzeichnis**: wie _ApiArchivVerzeichnis, jedoch für übermittelte Bestellungen, aus denen kein Vorgang angelegt werden konnte.
   * **_ArtikelErstausstattungHinzufuegen**: bei>0 werden zugeordnete Erstausstattungsartikel automatisch hinzugefügt
   * **_APLieferungInLieferadresse**: bei >0 wird der Ansprechpartner für die Lieferung (gegebenenfalls nach dem Liefername und der Abteilung) in die Lieferanschrift (Feld //Liefername//) eingetragen.
@@ Zeile 299: / 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 =====
@@ Zeile 328: / Zeile 332: @@
 {{tag>Edi-Schnittstelle OEXXML Kundenbestellungen}}
+===== Kundenbestellungen über die Webservice-API einlesen =====
+Neben dem Einlesen aus einem Verzeichnis können Kundenbestellungen auch direkt über den [[allgemein:webservice|Concept Office Webservice]] übergeben werden. Das anbindende System übermittelt die Bestellung als Datenstrom und erhält unmittelbar zurück, ob ein Vorgang angelegt wurde und unter welcher Auftragsnummer. Eine Dateiablage ist dafür nicht erforderlich.
+Unterschiede zum Einlesen aus einem Verzeichnis:
+  * Es wird ausschließlich das Format **OpenTrans** unterstützt.
+  * Pro Aufruf wird genau eine Bestellung verarbeitet.
+  * Das zu verwendende Übernahmeschema (die Sektion aus der //Kundenbestellung_einlesen.ini//) wird beim Aufruf mitgegeben.
+  * Die Rückmeldung erfolgt sofort in der Antwort des Aufrufs.
+Die Pfade gelten unterhalb des hinterlegten Endpunktes für den Service Host, also z.B. unterhalb von %%http://<server>:<port>/Office/CoServiceRestApi/%%
+  * **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.
+<html>
+<table width="100%" style="border:0px;">
+<tr>
+   <td style="border:3px solid #228b22; padding:5px; background-color:#d9fdd9;">
+      <table width="100%" style="border:0px; margin:0px">
+         <tr>
+            <td width="100px" style="border:0px; text-align:center; padding:5px;" >
+               <img src="./scpictures/beispiel.png">
+        </td>
+        <td style="border:0px; padding:10px; ">
+<p><b>Beispiel:</b>Übergabe einer Bestellung</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>
+     </tr>
+      </table></td></tr></table>
+</html>
+Die Antwort enthält:
+  * **AuftragsNummer**: Nummer des angelegten Vorgangs, **0** wenn kein Vorgang angelegt werden konnte
+  * **Erfolgreich** bzw. **HatFehler**: Ergebnis des Imports
+  * **Message**: Meldungstext
+<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>
+Archivierung der Bestellung:
+  * **_ApiArchivVerzeichnis**
+  * **_ApiFehlerArchivVerzeichnis**
+<html>
+<table width="100%" style="border:0px;">
+<tr>
+   <td style="border:3px solid #228b22; padding:5px; background-color:#d9fdd9;">
+      <table width="100%" style="border:0px; margin:0px">
+         <tr>
+            <td width="100px" style="border:0px; text-align:center; padding:5px;" >
+               <img src="./scpictures/beispiel.png">
+        </td>
+        <td style="border:0px; padding:10px; ">
+<p><b>Beispiel:</b></p>
+<p><code>_ApiArchivVerzeichnis=#\\fileserver\co\edi\api\archiv</code>
+<br><code>_ApiFehlerArchivVerzeichnis=#\\fileserver\co\edi\api\fehler</code></p>
+<p>Ergibt z.B. die Datei <code>API_xmlOEXOrderImport_20260818_142212_230000627.xml</code></p>
+        </td>
+     </tr>
+      </table></td></tr></table>
+</html>
+<note important>
+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>_<YYYYMMDD>_<HHMMSS>_<Auftragsnummer>.xml** abgelegt.
+Konnte kein Vorgang angelegt werden, entfällt die Auftragsnummer im Dateinamen.
+Die Protokollierung erfolgt nach derselben Logik wie beim EDI-Import.