Order Intake from Shopware into BC

Learn how orders are imported from Shopware into Business Central.

The Shopware 6 API Connector enables the automatic import of orders from your online shop into Business Central.

1. Order Import

Manual Import

1. Click "Shopware" "Download Orders".
2. The new orders are imported.

Automatic Import

For the automatic import:

1. Create a Job Queue Entry.
2. Select the corresponding codeunit.
3. Define the interval (for example, every 15 minutes)

2. Imported Data

Order Header

Shopware Field	BC Field
Order number	External Document No.
Order date	Document Date
Customer	Sell-to Customer No.
Billing address	Sell-to Address
Shipping address	Ship-to Address

Order Lines

Shopware Field	BC Field
Item number	No.
Item name	Description
Quantity	Quantity
Unit price	Unit Price
VAT	VAT %

Additional Data

• Shipping costs: are created as a separate line.
• Discounts: are processed as line discounts or vouchers.
• Payment information: the payment method is mapped.

3. Order Status Filter

You can filter which orders are imported:

Status	Description	Import recommended
open	New order	✅ Yes
in_progress	In progress	✅ Yes
completed	Completed	⚠️ Optional
cancelled	Canceled	❌ No

Frequently Asked Questions

As which document type is a Shopware order created in Business Central?

This is controlled by the “Download Order As” configuration option: Quote, Order or Invoice. The document is only created automatically if “Generate Sales Order” is also enabled. The number series used comes from “Sales Ord No.Series”, and the location from “Ord Download Location”.

How do I recognize in Business Central which Shopware order a document came from?

The connector stores the fields “SOUSHW Web Order ID”, “Web Order No” and “Web Order Auto Increment” on the sales document. In addition, the external document number is set in the format SW:{order number}, so that every BC order can be assigned unambiguously to the Shopware order.

How is the customer of an order determined?

The connector loads the Shopware customer via customer/{id} and looks for the matching customer using the “SOUSHW Web ID” or – depending on “Cust. Mapping Type” – by email, phone or mobile number. Guest orders are posted to the “Default Guest Cust.”; if “Create Unknown Cust.” is enabled, a new customer is created from the “Cust. Template” when no match is found.