Kaufland Order on the “Marketplace Order” Card
A Kaufland order is a merchantCENTRAL marketplace order and opens on its Marketplace Order card – the same card as the orders of all other marketplaces. The Kaufland connector adds there what only Kaufland knows: the Kaufland section with storefront, Kaufland status, addresses, invoice upload, and synchronization, the Kaufland actions, Kaufland columns and actions in the Order Lines, and the Shipment Confirmations FactBox. All of this appears only on Kaufland orders.
The card is read-only: Kaufland is the source of the order; you work on it through the actions.
Opening the Page
- From the Kaufland Orders or the merchantCENTRAL marketplace orders by clicking an order
- From the sales order, the posted shipment, and the posted sales invoice of a Kaufland order → merchantCENTRAL action Show Marketplace Order, or by clicking the Marketplace Order No. field
- From the Kaufland Order FactBox on these documents and in the Kaufland orders → click the Order ID
- From the Kaufland Order Invoices, Refunds, Returns, Tickets, Shipment Confirmations, and Shipping Labels → action Show Marketplace Order
The “Marketplace Order” Card
The card is laid out and operated the same for all marketplaces. The title names marketplace and order (Kaufland - DK201147). General shows the Kaufland order ID as External Order No., the Status in Business Central, and the Sales Order No.; Errors appears for status Error or On Hold and gives in Error Message the reason why the order has no sales order. Then follow the Order Lines, the Order Details with total amount, currency, and the buyer's shipping costs (Shipping Amount), Shipping with the ship-to address as the sales order receives it, Contact with the buyer's email address, and Billing Address. The first action is Show Sales Order. All fields, the status colors, and the merchantCENTRAL actions – Import Again, Import Without Unknown Items, Tracking Entries, Cancellations, Show Order JSON – are described in the help for the Marketplace Order card.
How a Kaufland order gets its sales order, and what Error and On Hold mean for Kaufland, is described under From Kaufland Order to Sales Order.
“Kaufland” Section
The section is in the Channel Details group.
| Field | Description |
|---|---|
| Storefront | Kaufland storefront (country) in which the order was placed. It determines currency and sales channel. |
| Kaufland Order Status | Status of the order at Kaufland, worked out from its units: Open and To Be Sent yellow, Sent and Received green, Cancelled and Returned gray. See Kaufland Orders. |
| 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 after that. Unlike Latest Ship Date under General, which the sales order received when it was created, this field follows the units: it moves on as soon as a unit is reported as sent, and it is empty once none waits. |
| Units Not Released | How many units Kaufland has not released yet. Until then the buyer can cancel them; the sales order is created only once no unit is open any more. |
| Shipment Confirmations Not Sent | How many shipment confirmations of the order Kaufland does not have yet – they are waiting for the posted shipment or were refused. Yellow as soon as there is one. Clicking it opens them. |
| Units Deleted in BC, Open at Kaufland | How many units have lost their sales line in Business Central while Kaufland still expects them. Red as soon as there is one: cancel the unit with a reason or ship it, see Order Lines. |
| Total Amount (Net) | Total amount of the units that are not cancelled, excluding VAT. |
| Kaufland Buyer ID | Kaufland ID of the buyer; the order import uses it to find the customer of earlier orders again. Shown via Show more. |
| Details Pending | Kaufland has listed the order but not yet returned its details. The next import reads it again first; Error Message gives the reason. Shown via Show more. |
Delivery Address
Kaufland returns the address in parts; the sales order receives it put together (see Shipping on the card).
| Field | Description |
|---|---|
| Ship-to First Name / Ship-to Last Name / Ship-to Company | Recipient. |
| Ship-to Street / Ship-to House No. | Street and house number, separate at Kaufland; the sales order receives both in one line. |
| Ship-to Address 2 | The buyer's address addition, such as c/o or floor. It goes into the second address line of the sales order. |
| Ship-to City | City in full length, as Kaufland reports it. |
| Ship-to Phone | The buyer's phone number – the only one Kaufland returns; it also goes into the billing address of the sales order. |
| Pickup Provider / Pickup Location ID | Pickup location chosen by the buyer (such as a DHL Packstation, a parcel shop, or a locker) and its provider. Only visible if the buyer has chosen one. The ID goes into the second address line of the sales order unless the street already names it – otherwise the parcel would go to the street address of the shop. |
| DHL Post Number | The buyer's post number for a delivery to a Packstation. It comes first in the second address line of the sales order, where the label needs it. Only visible with a pickup location. |
Billing Address
| Field | Description |
|---|---|
| Bill-to Name | Full name of the invoice recipient. Bill-to First Name and Bill-to Last Name via Show more. |
| Bill-to Street / Bill-to House No. / Bill-to Address 2 / Bill-to City | Billing address as Kaufland reports it. |
Invoice
| Field | Description |
|---|---|
| Invoice Uploaded | Whether an invoice of the order is at Kaufland – the posted sales invoice or your own PDF file. If you delete the order's last invoice in the Kaufland Order Invoices, the field is off again. |
| Uploaded Sales Invoice No. | Posted sales invoice uploaded to Kaufland – by the UPLOAD-INVOICES task, with Upload Invoice on this card, or with Upload Invoice on the posted sales invoice. Stays empty when you upload your own PDF file. |
| Manual Invoice Upload | Whether the invoices of this order are uploaded by hand only. Set as soon as your own PDF file has been uploaded for the order or one of its invoices has been deleted with Delete Invoice. The UPLOAD-INVOICES task then no longer uploads any posted sales invoice of the order – otherwise the buyer would get a second invoice or the deleted one back. Upload Invoice still uploads. |
Synchronization
| Field | Description |
|---|---|
| Updated at Kaufland | Last change of a unit at Kaufland. |
| Last Read from Kaufland | When the order was last read from Kaufland. |
| Buyer Data Anonymized On | When the buyer data of the order was cleared after the retention period (see Data Protection). Empty as long as the order has its buyer data. Shown via Show more. |
FactBox “Shipment Confirmations”
On the right, the Shipment Confirmations FactBox shows the shipment confirmations of the order.
Kaufland Actions
The Kaufland actions follow Show Sales Order under Process, and the merchantCENTRAL actions under Navigate.
| Action | Description |
|---|---|
| Refresh Order | Reads the 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. |
| Send Shipment Confirmation | Opens the Send Shipment Confirmation dialog: tells Kaufland at once that the units Kaufland is waiting for were sent. Usually not needed – a shipping label or a tracking number on the sales order sends the shipment confirmation once the shipment is posted, see Kaufland Shipment Confirmations. |
| Upload Invoice | Opens the Upload Invoice dialog, prefilled with the newest posted sales invoice of the order. Instead of the posted invoice, you can also upload your own PDF file. The UPLOAD-INVOICES task uploads posted invoices automatically as well, see Automatic Invoice Upload. |
| Open Ticket | Opens the Open Ticket dialog for all units of the order – to ask the buyer something or to report a problem to Kaufland. For individual units, select their lines and choose Open Ticket in the order lines. |
| Shipment Confirmations (Navigate) | Opens the Kaufland Shipment Confirmations of this order. |
| Refunds (Navigate) | Opens the Kaufland Refunds to the buyer of this order. Refunds are sent per unit, see Send Refund. |
| Tickets (Navigate) | Opens the Kaufland Tickets for this order. |
| Order Invoices (Navigate) | Opens the Kaufland Order Invoices of this order. |
| Returns (Navigate) | Opens the Kaufland Returns of this order. |
The Create Shipping Label action is hidden, see Create Shipping Label.
Import Again on the card is the merchantCENTRAL action and is active only for On Hold. An order with status Error is created at once with Import Again in the Kaufland Orders; otherwise the next run tries it.
Order Lines
Kaufland keeps every item sold as a unit of its own (order unit) with its own status; every order line of a Kaufland order is such a unit. The lines are read-only.
For Kaufland, the merchantCENTRAL columns show:
| Field | Description |
|---|---|
| Line Type | Item for a unit that was to be sent at the import and goes into the sales order; Skip for one that gets no sales line, for example because it was already cancelled. |
| Item No. | Item in Business Central that the import found by the EAN (GTIN or item reference of type bar code), see Unknown Item. |
| SKU | Offer ID of the unit at Kaufland. |
| Description | The first 100 characters of the product title. |
| Quantity | Quantity, at Kaufland usually 1 per unit. |
| Unit Price / Line Amount | Price the buyer paid, including VAT and after your discounts; line amount = quantity × unit price. |
Via Personalize, you can show External Item No. (the EAN), External Line Reference (the order unit ID), and Sales Line No..
Kaufland Columns
| Field | Description |
|---|---|
| Unit Status | Status of the unit at Kaufland: Open and To Be Sent yellow, Sent and Received green, Cancelled, Returned, and Returned and Refunded gray. Returned and Refunded means: the unit was returned, and Kaufland has already refunded the amount to the buyer – there is no refund for it from Business Central any more. |
| Ship By | By when Kaufland expects the unit to be shipped. For a unit still to be sent, yellow on its last day, red after that. The earliest date of an order's units becomes the Latest Ship Date of its sales order. |
| Product Title | Title of the product in full length, as Kaufland showed it to the buyer. Hidden; shown via Personalize. |
| Refunded Amount | What was refunded to the buyer for the unit from Business Central, including VAT and including refunds not yet confirmed. Refunds in the Kaufland Seller Portal or by Kaufland itself are not included. Clicking it opens the Kaufland Refunds of the unit. |
| Fulfillment Type | Who ships the unit: Fulfilled by Merchant (you) or Fulfilled by Kaufland. |
| Shipped | Whether the unit has been reported to Kaufland as shipped. |
| Tracking Numbers | Tracking numbers with which the unit was reported, several separated by commas – additional parcels included. |
| Cancelled | Whether the unit was cancelled. |
| Cancel Reason | Reason for the cancellation as Kaufland reports it, e.g., Cancelled by Buyer or No Inventory. Empty if the unit is not cancelled or Kaufland reports a reason the Kaufland connector does not know yet. |
| Deleted in Business Central | The unit's sales line was deleted in Business Central while Kaufland still expects the unit. Kaufland knows nothing about this: cancel the unit with Cancel Line or ship it with Send Shipment Confirmation. |
Line Actions
The Kaufland line actions are in the order lines under Channel.
| Action | Description |
|---|---|
| Send Shipment Confirmation | Opens the Send Shipment Confirmation dialog for this one unit. Only active for a unit Kaufland is waiting for: status To Be Sent, neither cancelled nor already reported as shipped. A further parcel of a unit already shipped goes through the tracking of the sales order, see Kaufland Shipment Confirmations. |
| Cancel Line | Cancels this line – one unit at Kaufland. The Cancel Order Line dialog asks for the reason from the Kaufland list (required). Only active as long as the unit has not been shipped yet (Open or To Be Sent) and no shipment confirmation is waiting for it. Kaufland refunds the amount to the buyer. If the order already has a sales order, the cancellation goes into the sales order at once; the message afterwards says what merchantCENTRAL did there or what is still to be done by hand. See Cancellation and Sales Order. |
| Send Refund | Refunds an amount to the buyer for this unit, e.g., for a delivery delay, transport damage, or the shipping costs. Opens the Send Refund dialog. Only active for the statuses To Be Sent, Sent, Received, and Returned and as long as an amount is left to refund – so it is blocked while the unit is Open, if it is cancelled, or if Kaufland has already refunded it (Returned and Refunded). |
| Open Ticket | Opens the Open Ticket dialog for the selected units. Kaufland opens a ticket only for units of one order. |
Cancellation and Sales Order
If a unit is cancelled after its sales order has been created, merchantCENTRAL takes it out of the sales order. How this happens is set by Cancellation Handling on the merchantCENTRAL marketplace card: Automatic changes the sales order itself, Manual keeps the cancellation waiting in the merchantCENTRAL Order Cancellations until you apply it. Whatever cannot be done automatically stays there with the reason and appears on the merchantCENTRAL dashboard. The Cancellations action of the card shows the cancellations of the order.
- Cancelled with “Cancel Line”: merchantCENTRAL applies the cancellation to the sales order at once; with Manual, it stays in the order cancellations. The message afterwards gives the result or what is still to be done by hand.
- Cancelled at Kaufland (by the buyer or by Kaufland): the next order import reports the cancellation to merchantCENTRAL, which then applies it to the sales order. A shipment confirmation still waiting for the unit is removed in the process.
FactBox “Kaufland Order”
The sales order, the posted shipment, and the posted sales invoice of a Kaufland order show the Kaufland Order FactBox on the right, as do the Kaufland Orders for the selected order:
| Field | Description |
|---|---|
| Order ID | Clicking it opens the order on the Marketplace Order card. |
| Storefront | Kaufland storefront of the order. |
| Kaufland Order Status | Status at Kaufland, color-coded as above. |
| Status | Where the order stands in Business Central, color-coded as on the card: e.g., Imported (waiting for its sales order), On Hold, Error, Shipped, or Invoiced. |
| Ship Open Units By | The earliest ship date of the units still to be sent – yellow on its last day, red once it has passed. |
| Shipment Confirmations Not Sent | How many shipment confirmations of the order Kaufland does not have yet – they are waiting for the posted shipment or were refused. Yellow as soon as there is one. Clicking it opens them. |
| Units Deleted in BC, Open at Kaufland | Units without a sales line that Kaufland still expects; red as soon as there is one. |
| Invoice Uploaded / Uploaded Sales Invoice No. | Whether an invoice is at Kaufland, and which posted sales invoice. |
On the documents, the FactBox appears only on documents of a Kaufland order and only for users with read permission on the marketplace orders. There, the merchantCENTRAL action Show Marketplace Order also offers the way back to the order.
Data Protection
The buyer data of a Kaufland order is kept only as long as the work requires it. The nightly data protection run of merchantCENTRAL clears it using the periods that apply to all marketplace orders in the merchantCENTRAL Setup (section Data Protection); the Kaufland connector also clears the fields of the Kaufland section. The Kaufland connector clears returns, tickets, and shipping labels in the same run with the same periods:
| Record | Cleared after | Counted from |
|---|---|---|
| Order with status Shipped, Invoiced, or Cancelled | Order Data Retention (Days) (default 30 days) | Order date |
| Any other order | Unfinished Order Retention (Days) (default 90 days) | Order date; without an order date, the import |
| Return with processing status Completed | Order Data Retention (Days) | Last change at Kaufland |
| Any other return | Unfinished Order Retention (Days) | Last change at Kaufland |
| Ticket that both sides or Kaufland customer service have closed permanently | Order Data Retention (Days) | Last change at Kaufland |
| Any other ticket | Unfinished Order Retention (Days) | Last change at Kaufland |
| Shipping label | The hub's Shipment Label Retention (Days) | Creation |
Cleared are name, addresses, email address, phone, buyer ID, pickup location and DHL post number, the notes of the return units, author and text of the ticket messages including the last message on the ticket, on labels the recipient, PDF, and download address, as well as error texts that can reproduce parts of Kaufland's response. Name, shipping address, and billing address then read “Anonymized marketplace buyer”. Order ID, dates, amounts, statuses, reasons, countries, and tracking numbers remain – these are business data. The run does not touch sales orders and posted documents in Business Central; the statutory retention period applies to them.
In addition:
- The run deletes the attachments of a ticket when it clears the ticket.
- It deletes the API log after 30 days at most, and at the latest when the buyer data of completed orders is due – if Order Data Retention (Days) is shorter, that period applies.
- Per type – returns, tickets, shipping labels – it clears at most 1,000 records per night. The rest follows in the next nights.
- If one of the two periods Order Data Retention (Days) or Unfinished Order Retention (Days) is missing in the hub, it clears no buyer data; it still deletes the API log after 30 days. Without Shipment Label Retention (Days), the labels stay unchanged.
An order whose buyer data has already been cleared no longer gets a sales order – it would be created without an address.