Kaufland Orders

List of the orders imported from Kaufland, newest first. Every Kaufland order is a merchantCENTRAL marketplace order; the list shows the Kaufland marketplace orders with the columns only Kaufland has – storefront, Kaufland status, and the date by which the units must be shipped. It is read-only; clicking an order opens it on the Marketplace Order card.

In the list of sales orders, the Kaufland action group shows only the sales orders from Kaufland orders with Kaufland Orders, and all of them again with All Orders. The group only appears when Kaufland is set up and switched on in merchantCENTRAL.

Opening the Page

Via search: Kaufland Orders
Via the Kaufland Dashboard → Orders
Via the merchantCENTRAL dashboard → Waiting for you → Kaufland · orders that did not come in: opens the list with the orders with status Error or On Hold that have no sales order yet. An order that Kaufland has cancelled in the meantime is not counted there.

The same orders also appear in the merchantCENTRAL marketplace orders, there without the Kaufland columns.

From Kaufland Order to Sales Order

Import. The scheduled task IMPORT-ORDERS (every 15 minutes) or the Import Orders action reads, for each storefront whose sales channel is switched on, the orders that changed since the last import (the last 30 days on the first import of a storefront), and reads each of them in full with units, buyer, and addresses. Each order is saved as a merchantCENTRAL marketplace order in a transaction of its own, each unit as an order line of its own. If Kaufland does not return the details of an order, it is listed with Details Pending and the reason in Error Message and is read first in the next import – the other orders of the storefront carry on. An order from a storefront the Kaufland connector does not know yet is not imported.
Waiting while a unit is open. An order gets a sales order only once Kaufland has released all units that are not cancelled. During the first 15 minutes after the purchase a unit is Open: the buyer can still cancel, and Kaufland withholds the addresses. As long as Units Not Released on the card is greater than 0, the order waits – otherwise the open unit would be missing from the sales order for good. If a unit stays open for more than 24 hours, Error Message names it; the order keeps waiting until Kaufland releases or cancels the unit. Check it in the Kaufland Seller Portal then. If Kaufland cancels all units before the order has a sales order, it gets the status Cancelled.
Sales order. If Create Sales Orders is switched on in the Kaufland Setup, merchantCENTRAL creates the sales order after the import, as for every marketplace: customer, gross prices as the buyer paid them, shipping costs, and the Latest Ship Date. The second line of the shipping address receives the DHL post number of a Packstation, the ID of the pickup location (Packstation, parcel shop, or locker) unless the street already names it, and the buyer's address addition. Each order is created in a transaction of its own. If one fails, it gets the status Error, and Error Message gives the reason; this does not hold up the other orders. The next run tries again, Import Again and the Create Sales Orders action at once.
Item and variant. merchantCENTRAL finds the item by the unit's EAN – as the item's GTIN or as an item reference of type bar code. The search runs immediately before the sales order is created, so an EAN you add to the item after the import counts. If the EAN belongs to a variant, merchantCENTRAL sets that variant on the sales line; the line's price, discount, and description stay as they were.

Unknown Item

If Business Central finds no item for an EAN, merchantCENTRAL decides:

If merchantCENTRAL knows the unit's offer ID as a SKU – as a marketplace offer or as the SKU of a marketplace item –, the sales order is created with that item.
If Hold Order on Unknown Item is switched on on the marketplace card, merchantCENTRAL holds the order: it gets the status On Hold, and Error Message names the unknown item. Assign the unit's offer ID as a SKU and choose Import Again – here in the list or on the Marketplace Order card. On the card, Import Without Unknown Items creates the sales order without the unknown lines instead.
Otherwise no sales order is created: the order gets the status Error, and Error Message names the EAN. Enter it as the GTIN or an item reference of the item; the next run creates the sales order, Import Again does so at once.

Fields

Field	Description
External Order No.	The ID Kaufland gives the order. The sales order carries it as the marketplace order no., and the Kaufland Seller Portal shows the order under it.
Storefront	Kaufland storefront (country) in which the order was placed.
Kaufland Order Status	Status of the order at Kaufland (color-coded): Open (the buyer can still cancel, addresses still withheld) and To Be Sent yellow, Sent and Received green, Cancelled and Returned gray. Kaufland itself only knows a status per unit; the order shows the status of the unit that still needs the most work. It is Cancelled only once all units are cancelled.
Status	Where the order stands in Business Central (color-coded as on all merchantCENTRAL order pages): Imported – waiting for its sales order –, On Hold because of an unknown item, Error, Partially Shipped, Shipped, Invoiced, or Cancelled. The colors are explained in the help for the Marketplace Order card.
Order Date	Time of the purchase at Kaufland.
Ship Open Units By	By when Kaufland expects shipment – the earliest date of the units still to be sent. Yellow on its last day, red once it has passed.
Customer Name	Name of the customer, from the billing address.
Total Amount	Total amount of the units that are not cancelled, including VAT.
Currency Code	Currency of the storefront (e.g., EUR; CZK in the Czech Republic, PLN in Poland). The sales order gets this currency.
No. of Units	Number of units of the order.
Sales Order No.	Sales order in Business Central. Clicking it opens it. Empty as long as none has been created; Error Message then gives the reason.
Error Message	Why the order has no sales order yet or why its details could not be read from Kaufland, for example: Kaufland could not return its details, a unit open for more than 24 hours, no item for the EAN, held by merchantCENTRAL. The next run tries again.
Invoice Uploaded	Whether an invoice has been uploaded to Kaufland – automatically, with Upload Invoice on the Marketplace Order card, or with Upload Invoice on the posted sales invoice.
Import Date/Time	Time of the import into Business Central.

Ship-to City and Details Pending are hidden; you can show them via Personalize.

FactBox “Kaufland Order”

On the right, the Kaufland Order FactBox shows the selected order in brief: status at Kaufland and in Business Central, Ship Open Units By, shipment confirmations not sent, units without a sales line, and the invoice upload.

Actions

Action	Description
Show Sales Order	Opens the sales order of the selected order. Only active if there is one; if it no longer exists, a message says so.
Import Orders	After a confirmation, imports the changed orders of all storefronts that are switched on and creates the sales orders of those ready to ship, as described above. If a unit is cancelled only after the sales order has been created, the import reports the cancellation to merchantCENTRAL, see Cancellation and Sales Order. The summary names the orders imported, the orders Kaufland did not return in full, and each storefront whose orders Kaufland did not return, with the reason (e.g., HTTP 401 for a wrong secret key).
Import Again	Creates the sales orders of the selected orders at once instead of in the next run – after the reason in Error Message has been fixed or the unknown item of an order on hold has been assigned; an order held by merchantCENTRAL is imported again there. The same conditions apply as for the scheduled run: Create Sales Orders must be switched on in the Kaufland Setup; the action skips orders with a sales order, orders with units still open, anonymized orders, and orders of a storefront whose sales channel is switched off. With several orders selected, it asks first. At the end, it shows the same summary as the scheduled run.
Refresh Order	Reads the selected order from Kaufland again: the status of its units, shipments, and cancellations from the Kaufland Seller Portal. The action does not create a sales order; the next run or Import Again does.
Create Sales Orders	Creates the sales orders of all Kaufland orders that are ready to ship and have no sales order now, instead of in the next run of the scheduled task PROCESS-TO-BC – for all storefronts whose sales channel is switched on, as long as the Create Sales Orders switch in the Kaufland Setup is on. Orders in which the buyer can still cancel a unit keep waiting. The summary names the orders created, failed, waiting, and on hold.
Create Playground Order	Only visible while Use Playground is switched on in the Kaufland Setup: creates a test order for an offer in the Kaufland Playground to check the order import. The action refuses to run against the live API.
Setup	Opens Kaufland on the merchantCENTRAL marketplace card, where the Kaufland connector is set up.