Connect a BL company and choose a safe direction for products, available stock, customers, and orders.
This guide is for administrators with Abicart's BL Administration integration and a BL company stored in the cloud. BL is an option in Pro's included ERP choices; the supplier's agreement and integration access are required separately. The company key used by BL is for integration context, not a general customer password.
1. Prepare data and sync direction
Each product and variant/customer choice needs a unique item number and name.
Prices are entered excluding VAT in BL. A full product import reads Sales prices 1/sellPrice1.
Activate the relevant currencies in BL before exporting orders in those currencies.
Variants must first be created in Abicart and exported to BL so that the identities match.
Determine the source for price, product data, available stock, and customers. Do not activate competing imports and exports for the same data.
2. Activate the integration in BL and connect the company
In BL Administration, select File → BL integration.
Select Abicart from the available integrations and activate it.
Confirm Yes, start the integration when it is the correct company.
Open the integration settings (gear icon) and copy the company's public integration key.
In Abicart, go to Settings → External connections → BL Administration.
Paste the company key under Connection and save.
Verify that the connection is for the correct BL company before activating sync events. Missing feature access and a rejected key are different errors.
3. Map fee items
Create items in BL for Shipping, Cash on delivery, Transaction fee, Discount, and Other payment. Enter their item numbers in the integration settings:
Here is an example of a shipping item and its accounting entry:
Account 3520 in the example is not a universal requirement. Fees, gift cards, VAT, and currency must be mapped according to the company's actual accounting workflow, with the correct signs and document handling.
4. Choose product import or export
Product export: choose whether all products should be exported on the next event and if the customer choice name should be included in the product name.
Product import: choose full import or Import stock balance only.
Import choice | Actual meaning |
Full import | Updates product details according to the BL fields, with the price from sellPrice1 and available stock from availableStock. |
Stock balance only | Preserves name/price and does not import new products, but it is not completely free from other effects: product visibility, normal product type, and inventory management are set by the import, and the variant flag can be changed. |
Variants | Matching is done using the product/variant number. The initial setup bootstrap must be completed. |
Import stock balance only does not protect product visibility. The import can also change visibility, a variant's active status, ordinary product type and stock management. Do not use this mode for intentionally hidden products without first checking these effects. Reconcile the correct BL company, unique product/variant numbers and available stock before automatic import. A full import can also change prices and other product details.
Available stock is not the same as the physical count on the premises.
5. Set up events and review results
Export order: choose when the order is transferred. Queued processing can take time despite Update immediately.
Export item on add/change or Item import: choose an intended source/direction.
Export customer list or Import customer: choose the corresponding customer flow.
Check a limited, allowed basis: correct company, item/variant number, Sales prices 1, availableStock, visibility, currency, and fee lines. In case of an uncertain outcome, check existing supplier references before trying again; a successful connection is no general guarantee against duplicate order/invoice data.
Quick start
Check the cloud company, access, and unique numbers.
Activate the BL integration and connect the correct company key in Abicart.
Map fees and choose a source/direction.
Review the import's price/stock/visibility and the export's document reference.
Subscription and access
BL Administration is an option in Pro's included ERP choices. A BL agreement, cloud-stored company, and integration permission are also required. Plan access does not automatically provide a correct accounting or sync model.
