Differences

This shows you the differences between two versions of the page.

--- de:cobi.shipping [2025/08/26 09:49] – Translation page created thuth
+++ de:cobi.shipping [2025/09/01 09:33] (current) – thuth
@@ Line 1: / Line 1: @@
 ====== COBI.shipping ======
+COBI.shipping ist ein **REST-API-Dienst**, der als Connector zwischen **Barcode Shipping** und **SAP Business One** fungiert.
+Der Hauptzweck besteht im Austausch von Liefer- und Versanddaten: \\
+  * Offene Lieferscheine werden aus SAP Business One abgerufen und
+  * nach erfolgtem Versand werden Versandinformationen (einschließlich Trackingnummern, Gewichten und Artikeldetails) zurückgemeldet.
+===== Funktionen =====
+**Abruf von Lieferscheinen:**
+COBI.shipping stellt Barcode Shipping offene (oder optional auch geschlossene) Lieferscheine aus SAP Business One zur Verfügung. Es werden nur Lieferscheine mit zugelassenen Versandarten und nicht zugeordneten (noch nicht verpackten) Positionen berücksichtigt.
+**Versandbestätigung:**
+Nach erfolgtem Versand in Barcode Shipping überträgt COBI.shipping die Versanddetails zurück an SAP Business One, einschließlich Trackingnummern, Versandgewicht und Paket-Zuordnungen.
+**Automatische Lieferscheinerstellung:**
+Falls für einen Auftrag kein Lieferschein existiert, kann COBI.shipping diesen automatisch aus dem zugehörigen Kundenauftrag erzeugen und dabei Seriennummern oder Lagerplätze korrekt zuordnen.
+**Status-Updates:**
+Der Dienst aktualisiert Lieferscheine mit Versandstatus – „In Bearbeitung“ bei Teillieferungen oder „Abgeschlossen“ bei vollständigem Versand – und kann optional eine automatische Rechnungserstellung auslösen.
+**Integration mit Coresuite Print:**
+Nach der Rechnungserstellung kann COBI.shipping automatisch einen Ausdruck über den **COBI.wms Printservice** anstoßen, basierend auf vordefinierten Layouts und Druckdefinitionen.
+**Rückmeldung an Shop/Partner:**
+Sobald ein Versand abgeschlossen ist, kann COBI.shipping Status-Updates (einschließlich Trackingnummern, Lieferscheinnummern und Kundencodes) an angebundene Shops oder Geschäftspartner zurückmelden.
+===== Implementierungsdetails =====
+  * Bereitgestellt als Windows-Dienst (Installation über mitgelieferte Batch-Dateien). \\
+  * Erfordert Barcode Shipping Software und **Java 11**. \\
+  * API-Endpunkte sind unter /api/v1/ erreichbar, Authentifizierung per API-Key. \\
+  * Konfiguration erfolgt in SAP Business One (**@CMP\_CONFIG**) und muss nach Änderungen durch Neustart des Dienstes neu eingelesen werden. \\
+  * Unterstützt anpassbare UDF-Mappings für Adressfelder, Trackingnummern und Zolltarifnummern. \\
+  * Optionale automatische Rechnungserstellung und Integration mit Coresuite Print. \\
+  * Liest Adress- und Versandinformationen direkt aus der SAP-Tabelle **DLN12**.
+===== Erforderliche UDFs in SAP Business One =====
+Damit COBI.shipping ordnungsgemäß funktioniert, müssen in SAP Business One mehrere **User-Defined Fields (UDFs)** angelegt werden.
+Diese speichern Adressinformationen, Versanddaten und Zollinformationen.
+Unter //Lieferscheine → Zeilen (DLN12)//:
+^ Feld                           ^ Datentyp       ^ Größe  ^ Beschreibung                        ^
+| cobi-shipping\_firstNameField   | Alphanumerisch | 50     | Vorname des Empfängers              |
+| cobi-shipping\_lastNameField    | Alphanumerisch | 50     | Nachname des Empfängers             |
+| cobi-shipping\_companyField     | Alphanumerisch | 100    | Firmenname des Empfängers           |
+| cobi-shipping\_phoneField       | Alphanumerisch | 30     | Telefonnummer des Empfängers        |
+| cobi-shipping\_emailField       | Alphanumerisch | 100    | E-Mail-Adresse des Empfängers       |
+Unter //Lieferscheine → Kopf//:
+^ Feld                                  ^ Datentyp       ^ Größe  ^ Beschreibung                                     ^
+| cobi-shipping\_trackingInHeaderField   | Alphanumerisch | 100    | Feld zur Speicherung der Trackingnummer(n) im Belegkopf |
+| cobi-shipping\_alarmGroupId            | Numerisch      | 11     | Alarmgruppe für Rechnungsfehler                  |
+Unter //Artikel (OITM)//:
+^ Feld                                  ^ Datentyp       ^ Größe  ^ Beschreibung                                   ^
+| cobi-shipping\_oitmCommodityCodeField  | Alphanumerisch | 20     | Zolltarifnummer für Export-/Importabwicklung   |
+===== Installation =====
+**1. Installation Barcode Shipping**
+  * Barcode Shipping aus dem internen Archiv herunterladen und installieren (`N:\Entwicklung\Barcode Shipping\Downloads.7z`).
+  * Bei der Installation:
+  * **Shop → Eigenentwicklung** wählen
+  * **Shipper → Einfacher Versender** wählen
+  * Gewünschte Zusatzfunktionen aktivieren
+  * **Java 11** installieren (Pflicht für Barcode Shipping). \\
+  * Anleitung: (https://www.barcodeshipping.de/java-installation)
+  * Mit COMP.net-Zugangsdaten in Barcode Shipping einloggen.
+**2. Installation COBI.shipping-Dienst**
+  * Die cobi-shipping-ZIP-Datei entpacken (empfohlener Pfad: C:\cobi-shipping).
+  * In der Datei `cobi-shipping-service.exe.config` die SAP-Datenbankverbindungswerte eintragen.
+  * Die mitgelieferten Batch-Dateien ausführen:
+  * InstallService.bat → installiert den Windows-Dienst
+  * DeleteService.bat → deinstalliert den Windows-Dienst
+**3. Konfiguration Barcode Shipping**
+  * Barcode Shipping öffnen → Datei → Einstellungen
+  * Allgemein:
+  * Standard-Versender: *Einfacher Versender*
+  * „Bestellstatus prüfen“ deaktivieren
+  * „Mausmodus“ aktivieren
+  * Standard-Shop: *Connector*
+  * Connector:
+  * API URL: http://COBI.shipping-Server-IP:Port/api/v1/ (Beispiel: http://127.0.0.1:62005/api/v1/) \\
+  * API Version: V2
+===== Optionale Schalter (Boolean, 0/1) =====
+Die folgenden Schalter werden in **@CMP\_CONFIG** konfiguriert und müssen mit `0` (deaktiviert) oder `1` (aktiviert) gesetzt werden:
+^ Schlüssel                                     ^ Bedeutung                                                          ^
+| cobi-shipping\_companyFromCardName             | Verwendet den **CardName** als Firmenname in der Lieferadresse.     |
+| cobi-shipping\_firstLastNameFromContacts       | Übernimmt Vor-/Nachnamen aus der verknüpften Kontaktperson.          |
+| cobi-shipping\_firstNameLastNameFromCardName   | Leitet Vor-/Nachnamen aus dem **CardName** ab.                      |
+| cobi-shipping\_companyFirstNameLastNameFromAddress3 | Liest Firmen-/Vor-/Nachname aus dem Feld **Address3**.             |
+| cobi-shipping\_addressFromAddress2             | Verwendet **Address2** als Straßenadresse.                          |
+| cobi-shipping\_companyAddressFromAddress2      | Verwendet Name/Firma aus **Address2**.                              |
+| cobi-shipping\_privateAddressFromAddress2      | Behandelt **Address2** als Privatadresse.                           |
+| cobi-shipping\_createInvoiceAfterFullyPacked   | Erstellt automatisch eine Rechnung, wenn der Lieferschein vollständig gepackt ist. |
+| cobi-shipping\_invoiceDateEqDeliveryNoteDate   | Setzt Rechnungsdatum = Lieferscheindatum für automatisch erstellte Rechnungen. |
+| cobi-shipping\_displayClosedDeliveryNotes      | Zeigt auch geschlossene Lieferscheine in Barcode Shipping an.        |
+===== Coresuite Print Konfiguration =====
+In Umgebungen mit automatischer Rechnungserstellung kann COBI.shipping einen **Coresuite Print** anstoßen.
+Die folgenden Konfigurationswerte müssen gesetzt werden:
+^ Schlüssel                     ^ Typ / Beispiel                      ^ Zweck                                                        ^
+| cobi-shipping\_printService    | URL (z. B. http://127.0.0.1:62005) | URL des COBI.wms Printservice-Endpunkts                       |
+| cobi-shipping\_printDefinition | Text / ID (z. B. DeliveryNoteLayout)| ID der zu verwendenden Druckdefinition                        |
+| cobi-shipping\_layoutId        | Text / ID (z. B. 1001)              | Layout-ID für das Dokument                                    |
+| cobi-shipping\_printMode       | Text (Print oder Email)           | Legt fest, ob die Rechnung gedruckt oder per E-Mail gesendet wird |