Bleckmann
1. Overview
The Bleckmann 3PL integration in XoroERP enables seamless communication between your ERP system and Bleckmann’s warehouse management environment. This integration supports automated export and import of operational data, ensuring that warehouse activities remain synchronized with XoroERP in real time.
Key capabilities include:
Exporting product and order data from XoroERP to Bleckmann
Receiving shipping confirmations and ASN confirmations from Bleckmann
Handling inventory adjustments and related warehouse transactions
Support for multiple receiving locations, damaged inventory locations, EU HS Codes, and hanging garment attributes
Scheduling recurring import/export jobs through automated tasks
Receiving instant and daily error notifications to stay informed of integration issues
This integration ensures accurate order fulfillment, real-time inventory tracking, and consistent operational flow between XoroERP and Bleckmann’s warehouse network.
2. Workflow
2.1 Data Export & Import
Product, order, ASN, and inventory data are exported from XoroERP to Bleckmann using FTP-based file exchange, following the configured target directories, archive directories, and file naming formats. Bleckmann’s systems continuously monitor these directories, pick up incoming files, and process them based on the defined integration rules.
2.2 Order Fulfillment
Sales orders exported from XoroERP are received and processed in Bleckmann. Orders are picked, packed, and shipped at the Bleckmann warehouse according to mapped carriers, ship services, and shipping terms. Once shipped, Bleckmann generates Ship Confirmation files, which are sent back to XoroERP to update order status, wave lines, shipped quantities, carrier details, and tracking information.
2.3 ASN Processing & Inventory Receiving
ASNs exported from XoroERP notify Bleckmann of inbound inventory or returns. Upon physical receipt of goods, Bleckmann sends ASN Confirmation files back to XoroERP. XoroERP automatically receives inventory into the configured batch receive locations, including separate locations for damaged inventory when applicable.
2.4 Inventory Updates & Adjustments
Inventory adjustments such as shortages, overages, damages, and cycle count corrections are generated by Bleckmann and transmitted back to XoroERP. These adjustments are imported using dedicated inventory adjustment directories, ensuring accurate stock levels and warehouse reconciliation across systems.
2.5 Automation & Notifications
Scheduled auto import/export jobs ensure continuous synchronization of products, orders, shipments, ASNs, and inventory adjustments between XoroERP and Bleckmann. Email notifications alert administrators and support teams to any import/export failures, file validation errors, or processing issues, enabling timely resolution and operational continuity.
3. Configuration Settings
The following settings define how XoroERP exchanges product, order, shipment, ASN, and inventory data with Bleckmann through an FTP-based 3PL integration. Each setting is listed in the exact order, structure, and documentation style aligned with the HighJump 3PL configuration.
3.1 Use Archive Directory (Checkbox)
When enabled, processed inbound and outbound files are automatically moved to their respective archive directories. This helps maintain clean target directories and supports audit and troubleshooting requirements.
3.2 Export Products to Bleckmann (Checkbox)
Enables exporting product master data from XoroERP to Bleckmann. Selecting this checkbox reveals additional product-related configuration fields.
3.3 Target Directory – Products (Field)
Specifies the FTP directory where product files are sent. Bleckmann monitors this directory to import SKU and item master information.
3.4 Product File Name (Field)
Defines the naming convention for product export files. The file name must align with Bleckmann’s expected format to ensure successful processing.
3.5 Link item(s) containing following tags (Field)
Allows mapping of item-level tags required by Bleckmann.
3.5.1 EU HS Code Field (Custom Field)
Defines the custom field that stores the EU HS Code for items, required for customs and compliance.
3.5.2 Hanging Garment Field (Custom Field)
Defines the custom field used to identify hanging garments for special handling at the warehouse.
3.6 Export Orders to Bleckmann (Checkbox)
Enables exporting sales orders from XoroERP to Bleckmann for fulfillment processing. Selecting this checkbox reveals additional configuration fields.
3.7 Drop order(s) from the following store(s) (Field – Dropdown)
Only orders created in the selected store(s) will be exported to Bleckmann. Useful when multiple stores exist but only specific stores are fulfilled by this 3PL.
3.8 Block waves created via QuickShip in Xoro from flowing into Bleckmann (Checkbox)
Prevents waves created through QuickShip from being exported to Bleckmann, avoiding unintended fulfillment requests.
3.9 Ship Method Name(s) (Field)
Ship methods listed here will not be dropped during export. Only orders using these methods are sent to Bleckmann.
3.10 Blocked SKU(s) (Field)
Item numbers listed here are excluded from export to Bleckmann. Used for SKUs not handled by the 3PL.
3.11 Allowed Customer(s) (Field)
Only orders for the specified customers will be exported to Bleckmann.
3.12 Target Directory – Order (Field)
Defines the FTP directory where order files are sent. Bleckmann retrieves order files from this location for processing.
3.13 Target Directory – Ship Confirmation (Field)
Specifies the FTP directory where Bleckmann places ship confirmation files after shipment processing.
3.14 Archive Directory – Ship Confirmation (Field)
Defines the directory where ship confirmation files are moved after successful processing in XoroERP.
3.15 Order File Name Format (Field)
[ClientId]_ORD_IN_[yyyyMMdd_HHmmssms]
Defines the naming format for order files sent to Bleckmann.
3.16 Disable Multishipment (Checkbox)
When enabled, the ship confirmation is treated as final. All wave lines are closed, and remaining quantities are unallocated.
3.17 Filter Name (Field – Dropdown)
Selects the order attribute used for filtering, such as Order Tags, Ship To Country, Third Party Source, or Order Date.
3.18 Operator (Field)
Defines the logical operator used with the selected filter.
3.19 Value (Field)
Specifies the value applied to the filter condition.
3.20 Default SKU (Field)
Defines the fallback SKU used when no SKU is provided on an order line.
3.21 Third Party Site ID (Field)
Identifies the Bleckmann site or warehouse used for order routing.
3.22 Shipping Markup (Field)
Applies a percentage-based markup to shipping costs received from Bleckmann.
3.23 Shipping Markup Order Type (Field)
Applies the shipping markup only to selected order types. If left blank, the markup applies to all orders.
3.24 Carrier Name (Field)
Specifies the carrier name used in XoroERP.
3.25 Third Party Carrier Name (Field)
Maps the XoroERP carrier to Bleckmann’s carrier name.
3.26 Ship Service Name (Field)
Specifies the ship service used in XoroERP.
3.27 Third Party Ship Service Name (Field)
Maps the ship service to Bleckmann’s corresponding service.
3.28 Shipping Terms (Field)
Defines the shipping terms used in XoroERP.
3.29 Third Party Shipping Terms (Field)
Maps shipping terms to Bleckmann’s expected values.
3.30 Export ASNs to Bleckmann (Checkbox)
Enables exporting Advanced Shipping Notices from XoroERP to Bleckmann. Checking this setting displays the following fields:
3.38 Batch Receive Location (Field)
Defines the default location for receiving inventory.
Format: StoreName@LocationName
3.39 Batch Receive Location for Damaged Inventory (Field)
Defines the location for receiving damaged inventory.
Format: DamageCode@StoreName@LocationName
3.40 Target Directory – ASN (Field)
Specifies the FTP directory where ASN files are sent.
3.41 Target Directory – ASN Confirmation (Field)
Defines the directory where ASN confirmation files are received.
3.42 Archive Directory – ASN Confirmation (Field)
Processed ASN confirmation files are moved here after import.
3.43 ASN File Name Format (Field)
[ClientId]_PRA_IN_[yyyyMMdd_HHmmssms]
Defines the naming format for ASN files.
3.44 Return ASN File Name Format (Field)
[ClientId]_RMA_IN_[yyyyMMdd_HHmmssms]
Defines the naming format for return ASN files.
3.45 Enable Inventory Adjustment (Checkbox)
Enables processing of inventory adjustment files from Bleckmann. Selecting this option reveals additional inventory adjustment fields.
3.46 Display Location Name (Field)
Displays location names in inventory adjustment records.
3.47 Target Directory – Inventory Adjustment (Field)
Defines the FTP directory where inventory adjustment files are received.
3.48 Archive Directory – Inventory Adjustment (Field)
Processed inventory adjustment files are moved to this directory for record keeping.
3.5 Time Zone & Automation Settings
Time Zone
Defines the time zone to be used for all scheduled import and export tasks. All automated Bleckmann sync processes—such as product export, order export, ship confirmation import, etc.—follow this time zone.
Enable Auto Import/Export (Checkbox)
Enables XoroERP to automatically run Bleckmann import/export jobs according to a defined schedule.
Fields that appear when enabled:
Integration Start Date – The date when automated jobs begin running
Hour – Hour of execution
Min – Minute of execution
Auto Import Start Time Offset – Negative minute value allowing earlier execution
If disabled, all Bleckmann-related tasks must be triggered manually from the Operations Page.
Error Handling & Notifications
Receive Import Error Notifications by Email (Checkbox)
When enabled, XoroERP sends instant email alerts whenever an import or export related to Bleckmann fails.
Field:
Instant Error Email(s) – Comma-separated list of email addresses for immediate notifications
Send Daily Error Email (Checkbox)
Enables a consolidated daily summary of all Bleckmann import/export errors.
Daily Error Email(s)
Enter email(s) by "," seperating values.
Exclude Logs
Allows entering comma-separated keywords to filter out specific log messages or known noise patterns using wildcards (e.g., *Inventory*).
4. Operations Page
The Operations Page is the central workspace for monitoring, managing, and troubleshooting all day-to-day interactions between XoroERP and Bleckmann. It provides access to account management, manual import/export actions, operational tabs, and detailed logs.
Header Options
At the top of the Operations Page, you can access key actions for managing the Bleckmann integration:
Add Account
Adds a new Bleckmann account to XoroERP. This allows multiple Bleckmann accounts to be configured for different stores, regions, clients, or environments.
Change Account
Switch between existing Bleckmann accounts or update credentials for an already configured account.
Remove Account
Disconnects a Bleckmann account from XoroERP. All associated exports and imports will stop until another account is selected.
Settings
Opens the configuration panel where you can manage:
Data Export Settings
Import / Export Scheduling
Store mappings
Filters, ship methods, customers, SKUs
Email notifications and error handling
Import Button
Purpose
Manually fetches and processes incoming files from Bleckmann, including:
Ship Confirmations
ASN Confirmations
Inventory Adjustments
Transfer Confirmations
Functionality
Reads files from the configured Target Directories
Updates order statuses, purchase orders, inventory levels, and ASN records
Logs processing results and errors
Sends email notifications if configured
These header options allow seamless movement between configuration and operational monitoring without leaving the integration context.
Previous Exports
View a history of previously exported data with options to manage and reprocess items.
4.1 Orders
Purpose
Export sales orders from XoroERP to Bleckmann for fulfillment.
Steps
Enable Export Orders to Bleckmann.
Configure store selection, filters (Allowed Customers, Blocked SKUs, Ship Methods), and quantity splitting if required.
Click Run Export to send orders to Bleckmann.
Information Displayed
Order # / Reference Unique order identifier from XoroERP.
Last Execution Date Timestamp of the last export attempt.
Status / Message Indicates success, failure, or pending state with relevant error details.
Actions
Run – Manually retries export for selected orders.
Mark as Resolved – Marks completed or handled records as resolved.
Mark as Unresolved – Reopens records requiring further action.
Filters
Hide Resolved – Shows only active or problematic orders.
Show Errors Only – Displays only orders that failed export.
This tab is the primary operational area for ensuring all orders intended for Bleckmann are successfully transmitted.
4.2 Ship Confirmations
Purpose
Monitor and process shipment confirmations sent back by Bleckmann.
Information Displayed
Ship Confirmation # / Reference
Last Execution Date
Message (success or error details)
Actions
Run – Manually reprocess selected ship confirmations.
Mark as Resolved / Unresolved – Update record status as needed.
Workflow
Verify Target Directory – Ship Confirmation and Archive Directory – Ship Confirmation are configured.
Ship confirmations can be imported manually or via scheduled jobs.
Order status, shipped quantities, tracking numbers, and custom fields (e.g., Order Status at WMS, Preparation Code) are updated automatically.
4.3 ASNs
Purpose
Export Advanced Shipping Notices (ASNs) from XoroERP to Bleckmann.
Steps
Enable Export ASNs to Bleckmann.
Configure:
Batch Receive Location
Batch Receive Location for Damaged Inventory
Set:
Target Directory – ASN
Target Directory – ASN Confirmation
Archive Directories
Click Run Export to generate ASN files.
4.4 ASN Confirmations
Purpose
Process ASN confirmations received from Bleckmann and update XoroERP records.
Workflow
ASN confirmation files are placed in Target Directory – ASN Confirmation.
XoroERP imports them automatically or manually.
Each ASN is matched with the related order or PO.
Quantities, locations, and statuses are updated.
Error Handling
Discrepancies (missing ASN, SKU mismatch, quantity issues) are flagged.
Errors are logged and email notifications are sent if enabled.
Actions
Run – Re-import selected confirmations.
Mark as Resolved / Unresolved
Filters & Search
Hide Resolved / Show Errors Only
ASN Confirmation #
Keyword (order number or supplier reference)
Information Displayed
Order #
Last Execution Date
Message
4.5 SKU
The SKU tab manages item master synchronization between XoroERP and Bleckmann. It supports both new SKU creation and updates (description, dimensions, UOM, weight).
Actions
Run – Push or update SKU data.
Mark as Resolved / Unresolved
Filters
Hide Resolved
Show Errors Only
Search Fields
SKU #
Keyword (product name, category, description)
Information Displayed
SKU #
Last Execution Date
Message
Example: If SKU dimensions or weight are updated in XoroERP, the changes are automatically synced with Bleckmann to ensure consistent product specifications.
4.6 Inventory Adjustment
Purpose
Synchronize inventory adjustments between Bleckmann and XoroERP.
Steps
Enable Enable Inventory Adjustment.
Verify:
Target Directory – Inventory Adjustment
Archive Directory
Configure Display Location Name if required.
Run import/export as needed.
Actions & Filters
Same as other operational tabs:
Run
Mark as Resolved / Unresolved
Hide Resolved / Show Errors Only
4.7 Logs Tab
The Logs tab provides a complete audit trail of all integration activity between XoroERP and Bleckmann, including:
Order, ASN, SKU, and inventory exports
Import processes
Scheduled job executions
Errors and warnings
Columns
Export / Import Date
Type (order export, ship confirmation, ASN, etc.)
Keyword / Reference
Message
Email Notification Alignment
Receive Import Error Notifications by Email
Exclude Logs to filter noise
Send Daily Error Email for consolidated reporting
Filters
Do Not Show Resolved Reports
The Logs tab is the primary tool for diagnosing issues, verifying scheduled jobs, and confirming that Bleckmann integration processes are functioning as expected.
Last updated
Was this helpful?