COBI.shipping

COBI.shipping is a REST-API service that acts as a connector between Barcode Shipping and SAP Business One. Its primary purpose is to exchange delivery and shipping data:

1. It retrieves open delivery notes from SAP Business One and
2. reports back shipping information (including tracking numbers, weights, and item details) after the shipment has been processed.

Delivery note retrieval: COBI.shipping provides Barcode Shipping with open (or optionally closed) delivery notes from SAP Business One. Only delivery notes with allowed shipping methods and unassigned items (not yet packed) are included.

Shipping confirmation: After a shipment has been processed in Barcode Shipping, COBI.shipping sends shipping details back into SAP Business One, including tracking numbers, shipping weight, and item-package assignments.

Automatic delivery note creation: If no delivery note exists for an order, COBI.shipping can automatically generate one based on the corresponding Sales Order, ensuring correct serial number or bin location assignment.

Status updates: The service updates delivery notes with shipping statuses (“In progress” for partial shipments or “Completed” when fully shipped) and can optionally trigger automatic invoice creation.

Integration with Coresuite Print: After invoice creation, COBI.shipping can trigger automatic printing through the COBI.wms Printservice, using predefined layouts and print definitions.

Shop/Partner feedback: Once a shipment is completed, COBI.shipping can send status updates (including tracking numbers, delivery note references, and customer codes) back to connected shops or partners.

1. Delivered as a Windows service (installation via included batch files).
   
2. Requires Barcode Shipping software and Java 11.
   
3. API endpoints are provided under `/api/v1/` with authentication through an API key.
   
4. Configuration is stored in SAP Business One (`@CMP_CONFIG`) and must be reloaded by restarting the service after changes.
   
5. Supports customizable UDF mappings for address fields, tracking numbers, and commodity codes.
   
6. Optional automatic invoice creation and Coresuite Print integration.
   
7. Reads address and shipping information directly from SAP table `DLN12`.

For COBI.shipping to function properly, several User-Defined Fields (UDFs) must be created in SAP Business One. These fields store address information, shipping metadata, and customs information that are required by the integration.

Under Delivery Notes → Lines (DLN12):

Under Delivery Notes → Header:

Under Items (OITM):

1. Install Barcode Shipping

• Download and install Barcode Shipping from the internal archive (`N:\Entwicklung\Barcode Shipping\Downloads.7z`).
• During setup, choose Shop → Eigentwicklung and Shipper → Einfacher Versender, then enable additional functions as needed.
• Install Java 11 (required by Barcode Shipping). Instructions: [https://www.barcodeshipping.de/java-installation/](https://www.barcodeshipping.de/java-installation/)
• Log in to Barcode Shipping with COMP.net credentials.

2. Install COBI.shipping service

• Extract the `cobi-shipping` ZIP archive (recommended path: `C:\cobi-shipping`).
• Configure the connection values in the file `cobi-shipping-service.exe.config` (SAP database settings).
• Run the provided batch files:

• `InstallService.bat` → installs the Windows service.
• `DeleteService.bat` → removes the Windows service.

3. Configure Barcode Shipping

• Open Barcode Shipping → File → Settings.
• General:

• Default shipper: *Einfacher Versender*
• Disable *Check order status*
• Enable *Mouse Mode*
• Default shop: *Connector*
• Connector:
  
• API URL: http:<COBI.shipping server IP>:<Port>/api/v1