Differences

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

--- cobi.shipping [2025/08/22 13:29] – [Installation] thuth
+++ cobi.shipping [2025/08/22 13:40] (current) – [Installation] thuth
@@ Line 65: / Line 65: @@
 **1. Install Barcode Shipping**
-* Download and install Barcode Shipping from the internal archive (`N:\Entwicklung\Barcode Shipping\Downloads.7z`).
+  * 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.
+  * 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/)
+  * 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.
+  * 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`).
+  * 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).
+  * Configure the connection values in the file `cobi-shipping-service.exe.config` (SAP database settings).
-* Run the provided batch files:
+  * Run the provided batch files:
   * `InstallService.bat` → installs the Windows service.
@@ Line 81: / Line 81: @@
 **3. Configure Barcode Shipping**
-* Open Barcode Shipping → File → Settings.
+  * Open Barcode Shipping → File → Settings.
-* General:
+  * General:
   * Default shipper: *Einfacher Versender*
@@ Line 88: / Line 88: @@
   * Enable *Mouse Mode*
   * Default shop: *Connector*
-* Connector:
+  * Connector: \\
+  * API URL: http://<COBI.shipping server IP>:<Port>/api/v1 \\
-  * API URL: `http://<COBI.shipping server IP>:<Port>/api/v1/`
-    (example: `http://127.0.0.1:62005/api/v1/`)
-  * API Version: `V2`
-  * API Key: `Y29iaXNoaXBwaW5nOkRoNUchNnM=` (Base64 of `cobishipping:Dh5G!6s`)
-**4. Configure COBI.shipping in SAP Business One**
-* Go to **Extras → User-Defined Windows → @CMP\_CONFIG**.
-* Set the configuration values as documented (see sections *UDFs* and *Optional toggles*).
-* Mark shipping methods as “Barcode Shipping enabled”:
-  **Administration → Definition → Inventory Management → Shipping Methods**.
-⚠️ **Note:** Configuration values are only loaded at service startup. \\
-After making changes, always restart the COBI.shipping Windows service. \\
-===== Optional toggles (Boolean, 0/1) =====
-All of the following configuration keys are stored in **@CMP\_CONFIG** and are read **on service start** (restart the COBI.shipping service after changes).
-^ Key                                             ^ Meaning (EN)                                                                                                   ^
-| `cobi-shipping_companyFromCardName`             | Use **CardName** as company name on the delivery address.  |
-| `cobi-shipping_firstLastNameFromContacts`       | Take **first/last name** from the linked **Contact Person**.  |
-| `cobi-shipping_firstNameLastNameFromCardName`   | Derive **first/last name** from **CardName**.  |
-| `cobi-shipping_companyFirstNameLastNameFromAddress3` | Pull **company / first / last name** from **Address3** field.  |
-| `cobi-shipping_addressFromAddress2`             | Use **Address2** as the street address.  |
-| `cobi-shipping_companyAddressFromAddress2`      | Take **name/company** from **Address2**.  |
-| `cobi-shipping_privateAddressFromAddress2`      | Treat **Address2** as a **private** address.  |
-| `cobi-shipping_createInvoiceAfterFullyPacked`   | **Auto-create Invoice** when the delivery is fully packed.  |
-| `cobi-shipping_invoiceDateEqDeliveryNoteDate`   | Set **Invoice Date = Delivery Note Date** for auto-created invoices.  |
-| `cobi-shipping_displayClosedDeliveryNotes`      | Also **show closed Delivery Notes** to Barcode Shipping.  |
-===== Related non-boolean keys (for reference) =====
-These are **not** toggles, but often configured alongside the above:
-^ Key                                 ^ Type / Example                                               ^ Purpose                                                   ^
-| `cobi-shipping_trackingInHeaderFieldName` | Text (UDF name in Delivery header)                          | Stores tracking number(s) in the delivery header.  |
-| `cobi-shipping_alarmGroupId`        | Numeric (e.g., `11`)                                        | Alarm group used for invoice errors.  |
-| `cobi-shipping_oitmCommodityCodeField` | Text (UDF name on `OITM`)                                   | Customs tariff code mapping.  |
-| `cobi-shipping_alternativeRecipient` | Text (UDF name)                                             | Alternative recipient field.  |
-> Note: Address field mappings like `cobi-shipping_firstNameField`, `..._lastNameField`, `..._companyField`, `..._phoneField`, `..._emailField` remain part of the **address configuration** (DLN12 mapping).
-===== Coresuite Print configuration =====
-If the system is configured for automatic invoice creation, COBI.shipping can trigger a Coresuite Print job right after the invoice is generated.
-This requires that the COBI.wms Printservice is installed and reachable.
-^ Key ^ Type / Example ^ Purpose ^
-| cobi-shipping_printService | URL (e.g. http://127.0.0.1:62005) | URL of the COBI.wms Printservice endpoint |
-| cobi-shipping_printDefinition | Text / ID (e.g. DeliveryNoteLayout) | Print Definition ID to be used for output |
-| cobi-shipping_layoutId | Text / ID (e.g. 1001) | Layout ID for the document |
-| cobi-shipping_printMode | Text (Print or Email) | Determines whether the invoice is printed or sent by email |