Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- edi-schnittstelle:kundenbestellungen_einlesen [2026/09/03 09:15] – [Weiteres] Isabel Pinder
+++ edi-schnittstelle:kundenbestellungen_einlesen [2026/09/03 10:22] (aktuell) – [Kundenbestellungen über die Webservice-API einlesen] Isabel Pinder
@@ Zeile 302: / Zeile 302: @@
   * **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
-===== 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
-Voraussetzung ist das Recht zum Anlegen von Vorgängen.
-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>_<Zeitstempel>_<Auftragsnummer>.xml** abgelegt. Konnte kein Vorgang angelegt werden, entfällt die Auftragsnummer im Dateinamen.
-Die Protokollierung erfolgt nach derselben Logik wie beim EDI-Import.
 ===== Filteroptionen =====
@@ Zeile 442: / Zeile 372: @@
   * **Message**: Meldungstext
-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>
 Archivierung der Bestellung:
@@ Zeile 472: / Zeile 422: @@
 </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.
+Konnte kein Vorgang angelegt werden, entfällt die Auftragsnummer im Dateinamen.
 Die Protokollierung erfolgt nach derselben Logik wie beim EDI-Import.