cobi.shipping
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| cobi.shipping [2025/08/25 08:49] – ` thuth | cobi.shipping [2025/08/25 12:57] (current) – [Coresuite Print configuration] thuth | ||
|---|---|---|---|
| Line 30: | Line 30: | ||
| - Delivered as a Windows service (installation via included batch files). \\ | - Delivered as a Windows service (installation via included batch files). \\ | ||
| - Requires Barcode Shipping software and Java 11. \\ | - Requires Barcode Shipping software and Java 11. \\ | ||
| - | - API endpoints are provided under `/api/v1/` with authentication through an API key. \\ | + | - API endpoints are provided under /api/v1/ with authentication through an API key. \\ |
| - | - Configuration is stored in SAP Business One (`@CMP_CONFIG`) and must be reloaded by restarting the service after changes. \\ | + | - Configuration is stored in SAP Business One (@CMP_CONFIG) and must be reloaded by restarting the service after changes. \\ |
| - Supports customizable UDF mappings for address fields, tracking numbers, and commodity codes. \\ | - Supports customizable UDF mappings for address fields, tracking numbers, and commodity codes. \\ | ||
| - Optional automatic invoice creation and Coresuite Print integration. \\ | - Optional automatic invoice creation and Coresuite Print integration. \\ | ||
| - | - Reads address and shipping information directly from SAP table `DLN12`. | + | - Reads address and shipping information directly from SAP table DLN12. |
| ===== Required UDFs in SAP Business One ===== | ===== Required UDFs in SAP Business One ===== | ||
| - | For COBI.shipping to function properly, several **User-Defined Fields (UDFs)** must be created in SAP Business One. These fields store address information, | + | For COBI.shipping to function properly, several **User-Defined Fields (UDFs)** must be created in SAP Business One. \\ |
| + | These fields store address information, | ||
| Under //Delivery Notes -> Lines (DLN12)//: | Under //Delivery Notes -> Lines (DLN12)//: | ||
| ^ Title ^ Data type ^ Size ^ Description | ^ Title ^ Data type ^ Size ^ Description | ||
| - | | cobi-shipping\_firstNameField | + | | cobi-shipping_firstNameField |
| - | | cobi-shipping\_lastNameField | + | | cobi-shipping_lastNameField |
| - | | cobi-shipping\_companyField | + | | cobi-shipping_companyField |
| - | | cobi-shipping\_phoneField | + | | cobi-shipping_phoneField |
| - | | cobi-shipping\_emailField | + | | cobi-shipping_emailField |
| Under //Delivery Notes -> Header//: | Under //Delivery Notes -> Header//: | ||
| ^ Title ^ Data type ^ Size ^ Description | ^ Title ^ Data type ^ Size ^ Description | ||
| - | | cobi-shipping\_trackingInHeaderField | + | | cobi-shipping_trackingInHeaderField |
| - | | cobi-shipping\_alarmGroupId | + | | cobi-shipping_alarmGroupId |
| Under //Items (OITM)//: | Under //Items (OITM)//: | ||
| ^ Title ^ Data type ^ Size ^ Description | ^ Title ^ Data type ^ Size ^ Description | ||
| - | | cobi-shipping\_oitmCommodityCodeField | + | | cobi-shipping_oitmCommodityCodeField |
| Line 67: | Line 68: | ||
| * Download and install Barcode Shipping from the internal archive (N: | * Download and install Barcode Shipping from the internal archive (N: | ||
| * During setup, choose **Shop → Eigenentwicklung** and **Shipper → Einfacher Versender**, | * During setup, choose **Shop → Eigenentwicklung** and **Shipper → Einfacher Versender**, | ||
| - | * Install **Java 11** (required by Barcode Shipping). Instructions: | + | * Install **Java 11** (required by Barcode Shipping). |
| + | * Instructions: | ||
| * Log in to Barcode Shipping with COMP.net credentials. | * Log in to Barcode Shipping with COMP.net credentials. | ||
| Line 92: | Line 94: | ||
| * (example: http:// | * (example: http:// | ||
| * API Version: V2 | * API Version: V2 | ||
| - | * API Key: Y29iaXNoaXBwaW5nOkRoNUchNnM= | ||
| - | * | ||
| + | ===== Optional toggles (Boolean, 0/1) ===== | ||
| + | |||
| + | The following toggles are configured in @CMP_CONFIG and must be set to 0 (disabled) or 1 (enabled). | ||
| + | |||
| + | ^ Key ^ Meaning ^ | ||
| + | | 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/ | ||
| + | | 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. | | ||
| + | |||
| + | ===== Coresuite Print configuration ===== | ||
| + | |||
| + | For environments with automatic invoice creation, COBI.shipping can trigger Coresuite Print. \\ | ||
| + | The following configuration values must be set: | ||
| + | |||
| + | ^ Key ^ Type / Example ^ Purpose ^ | ||
| + | | cobi-shipping_printService | URL (e.g. http:// | ||
| + | | 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 | | ||
cobi.shipping.1756104558.txt.gz · Last modified: by thuth