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.

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.

• 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.

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):

Unter Lieferscheine → Kopf:

Unter Artikel (OITM):

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

Die folgenden Schalter werden in @CMP\_CONFIG konfiguriert und müssen mit `0` (deaktiviert) oder `1` (aktiviert) gesetzt werden:

In Umgebungen mit automatischer Rechnungserstellung kann COBI.shipping einen Coresuite Print anstoßen. Die folgenden Konfigurationswerte müssen gesetzt werden: