Troubleshooting
Common messages of the Kaufland connector, their cause and what to do. The messages are quoted as Business Central shows them; … stands for numbers, amounts or texts the message fills in.
Look first, then retry
- Errors of the scheduled tasks are shown in Last Error Message of the Kaufland Scheduled Task and in the merchantCENTRAL activity log.
- What exactly Kaufland answered is shown in the Kaufland API Log. It records only while Log API Requests is turned on in the Kaufland setup: turn it on, repeat the action and turn it off again afterwards.
Connection and setup
| Message | Cause | What to do |
|---|---|---|
| Kaufland API Configuration Missing – Client Key or Secret Key is not configured. | One of the two keys is missing, for example after Delete Secret Key or in a new company – the keys apply per company. | Enter Client Key and Secret Key in the Kaufland setup, then Test Connection. |
| Kaufland request Failed – The API returned HTTP 401 … | Kaufland rejected the keys: a typo, keys regenerated or revoked in the Seller Portal. | Check the keys in the Kaufland Seller Portal (Settings → API), enter them again, then Test Connection. |
| HTTP 401 with Kaufland's text shop-timestamp header is out of sync with current time | Every request carries the current time (UTC); Kaufland rejects it if the server clock deviates too far. In Business Central online this practically never happens. | Repeat the action. If it persists (for example in your own container), check the server's system clock. |
| Kaufland request Failed – HTTP 429 | Kaufland's request limit has been reached. The connector retries such requests itself; the message only appears when the retries fail as well. | Wait a few minutes. If it happens often, increase the intervals of the scheduled tasks. |
| Kaufland request Failed – HTTP 5xx, or Kaufland sent no readable message | A problem at Kaufland or on the way there. | Retry later. The full answer is in the API Log. |
| Kaufland Base URL Not Allowed | The Base URL points to no address of the Kaufland Seller API; nothing was sent. | Turn Use Playground in the setup off and on again (or on and off) – this sets the base URL to the live API or the Playground. |
| You do not have permission to change the Kaufland setup … | Only users with the permission set ALN MCK Admin may enter or delete keys. | Ask an administrator. |
| Please configure the Secret Key before proceeding. (wizard) | The secret key is missing in the Authentication step. | Click the Secret Key field ("Not configured") and enter the key. |
License, activation and tasks
| Message | Cause | What to do |
|---|---|---|
| Kaufland is not licensed. Activate a licence or the demo on the Kaufland row of the marketplace card. | There is neither a license nor an active demo for the Kaufland module in this company. Without a license the connector imports and sends nothing. | Marketplace card → row KAUFLAND → activate the license or the demo. |
| Last Error Message of a task: Kaufland is not licensed. The task waits … or Kaufland is not enabled in merchantCENTRAL. The task waits … | The task did not run (Last Run Status = Waiting). This does not count as an error. | Activate the license, or enable Kaufland on the marketplace card – the task starts on its own. |
| Task … is running right now. Try again when its run has finished. | An action run by hand (Run Now, Send Shipment Notices, Send Again …) would work on the same data at the same time as the scheduled task. | Wait until the run has finished, then try again. |
| A task no longer runs on its own; the Job Queue column is red | Its job queue entry stopped after three failed attempts. | Fix the cause shown in Last Error Message, then restart the entry via Job Queue Entries. |
| Wizard summary: Kaufland is not switched on yet: it needs a license or the free demo … | The license check refused, for example because the demo registration was cancelled. The other settings are saved; the tasks wait. | Activate the license or demo on the marketplace card and turn on Enabled there. |
Storefronts, Playground and live
| Message or observation | Cause | What to do |
|---|---|---|
| Storefront … is not enabled. | The action concerns a storefront that is switched off. | Switch the storefront on in the Kaufland Storefront Configuration. |
| No orders, returns or tickets arrive from a storefront | Only enabled storefronts are imported. | Switch the storefront on; its sales channel on the marketplace card follows. |
| The order comes from the storefront …, which this app does not know yet. | Kaufland opened a new country that this version of the connector does not know. The order is not imported, so that it is not assigned to another country. | Handle the order in the Kaufland Seller Portal; watch for a connector update. |
| The sales channel … is no storefront of Kaufland … | The marketplace card has a sales channel for which there is no Kaufland storefront. | Remove the channel from the marketplace card, or enable the matching storefront. |
| After copying a production environment to a sandbox, no real orders arrive any more | When an environment is copied to a sandbox, the connector switches the setup to the Playground, so that the copy does not work with the live shop. | Intended. Only if the sandbox really is to work live, turn Use Playground off. |
| Test orders can only be created in the Kaufland Playground. or A demo warehouse can only be created in the Kaufland Playground. | The action is meant for the Playground; the setup works live. | Turn on Use Playground for tests. |
Orders
| Message or observation | Cause | What to do |
|---|---|---|
| An order is Open and has no sales order | For the first 15 minutes after the purchase, Kaufland withholds the address; the buyer can still cancel. | Wait – as soon as it is To Be Sent, the sales order is created. |
| Order unit … has been open at Kaufland for more than … hours. | A line has not been released by Kaufland yet; the order waits for it, so that it is not missing from the sales order. | Check the order in the Kaufland Seller Portal. |
| merchantCENTRAL holds the order back: an item of the order is not known. | There is no item for an EAN, and Hold Order on Unknown Item is turned on on the marketplace card. The order waits; it is not discarded. | Assign the SKU as a marketplace offer or as the SKU of a marketplace item (or give the item the EAN as its GTIN or as a barcode reference), then choose Import Again in the marketplace orders – or Import Without Unknown Items. |
| Item Not Found – No item was found for EAN … of Kaufland order …, so no sales order was created. | There is neither an item nor a known SKU for the EAN, and Hold Order on Unknown Item is off. | Enter the EAN as GTIN or item reference of the item; the next run creates the sales order. |
| Kaufland could not return … orders. or Kaufland returned order … without its data. | Kaufland did not deliver the details. | Nothing – the orders are listed with an Import Error in Kaufland Orders and are read again first in the next import. |
| The hub created no sales order for Kaufland order …. | The central merchantCENTRAL order import rejected the order; the reason is in the activity log and the marketplace orders. | Fix the reason (customer, item, posting groups …); the next run tries again. |
| Order unit … cannot be cancelled in status …. | Only lines that have not been sent can be cancelled. | – |
| Order unit … cannot be cancelled: it has been shipped, and its shipment notice is waiting … | The shipment is posted, the notice has not reached Kaufland yet. | Do not cancel; send a refund later if needed. |
Shipment notices
Rejected and waiting notices show their reason in Error Message of Kaufland Shipment Notices.
| Message | Cause | What to do |
|---|---|---|
| No Kaufland carrier for shipping agent … | Kaufland requires a carrier from its list; the shipping agent of the shipment is not mapped to one. | Map the shipping agent in the Kaufland Carrier Mapping or set a Default Carrier in the setup. The notice is sent in the next run. |
| No Kaufland carrier: the tracking number came without a shipping agent. | The tracking number was entered without a shipping agent. | Set a Default Carrier, or add the tracking number again with its shipping agent. |
| Not sent: posted shipment … of order unit … has no tracking number of its own. | The number belongs to another shipment; it would otherwise be reported twice. | Add the tracking number of the package to the posted shipment. |
| Not sent: the sales line of order unit … was deleted … | Without a sales line, no shipment reports the unit. | Report it with Send Shipment on the Kaufland order, or delete the notice. |
| Not sent: Kaufland has cancelled order unit …. | The line is cancelled; there is nothing to report. | Nothing – the notice is dropped. |
| Order unit … cannot be reported as sent: its status at Kaufland is … | Kaufland is not (or no longer) waiting for this line. A further package goes through the tracking of its sales order. | Add the tracking number to the sales order or the posted shipment. |
| Tracking number … does not fit into the shipment notice … any more | The shipment notice of a line holds only a limited length of tracking numbers; this number is not sent with it. The notice itself is sent. | Check the number in Kaufland Shipment Notices or on the tracking entry; a further package of a line that has been sent goes through the tracking of its sales order. |
| Enter the tracking number of the package … | Kaufland requires it for every carrier except Other and Other Hauler. | Enter the number. |
| Kaufland reports the line as already sent | It was reported as sent in the Kaufland Seller Portal. | Nothing – the connector then sends the tracking numbers as additional packages. |
Invoices
| Message | Cause | What to do |
|---|---|---|
| Posted sales invoice … is at Kaufland already … | Each invoice goes to Kaufland only once; a second upload would give the buyer the same invoice twice. | Nothing. |
| Kaufland order … has no posted sales invoice yet. | – | Post the invoice of the sales order. |
| No report is set up for sales invoices … | Without a report selection for usage Invoice, no PDF can be created. | Set up an invoice report in Report Selection - Sales. |
| The file … is not a PDF document. or … larger than … MB | Kaufland accepts invoices only as PDF and only up to a maximum size. | Choose a PDF, or reduce the file size. |
| Posted sales invoice … was not posted for Kaufland order …. | The invoice belongs to another order. | Choose the invoice of the right order. |
Offers, prices and inventory
| Message | Cause | What to do |
|---|---|---|
| Kaufland expects the prices of storefront … in …, but the price of the item is in …. | The sales price list of the sales channel has the wrong currency (CZ sells in CZK, PL in PLN, all others in EUR). The price is not sent. | Assign a price list in the storefront's currency to the sales channel on the marketplace card. merchantCENTRAL does not convert. |
| Item … has no price in the sales price list of the sales channel … | Create Offers found no valid price. | Add the price to the channel's price list, then try again. |
| Item … is not listed on the sales channel … of Kaufland … | The item is not listed for this storefront; its price is not sent. | Add the item to this sales channel with Add to Marketplace. |
| Offer … already sells the stock of item … on this storefront and location … | Two offers of the same item at the same location would sell the same stock twice; the second one gets quantity 0. | Give one offer a location of its own, or delete the surplus offer. |
| The inventory sync to Kaufland is switched off. | Auto Sync Inventory is off in the setup. | Turn it on if Business Central is to manage the stock at Kaufland. |
| Kaufland answered the creation of the offer for EAN … without the offer. | The offer has probably been created but was not reported back. | Refresh Offers before you create it again. |
| Kaufland cannot remove the minimum price of an offer once it is set. | A minimum price, once set, can only be changed. | Enter another minimum price. |
| EAN … is already listed on Kaufland … for item …. | Kaufland has exactly one product page per EAN; only one item can be sold under it. | Use the other item, or remove its listing. |
| Item … has no GTIN. / EAN … is already the GTIN of item …. / Item … is sold under its GTIN …. | Kaufland lists via the item's GTIN. | Maintain the GTIN on the item card. |
| The EAN must have 13 or 14 digits. / … contain only digits. / The EAN check digit is invalid. | Invalid EAN. | Correct the EAN. |
| Kaufland has no product data for EAN … in … (yet). | The product page has not been created yet; the offer stays pending. | Wait; if nothing changes, upload the product data again. |
| Missing attributes: … / Rejected attributes: … | Kaufland requires further attributes for the category. Business Central sends title, description, manufacturer, category and pictures only. | Enter the attributes in the Kaufland Seller Portal. |
| The manufacturer is missing. / The title is missing. | Required data for the product data upload is missing. | Complete it on the Kaufland Product card. |
Returns, refunds and credit memos
| Message | Cause | What to do |
|---|---|---|
| The refund of … exceeds the … that can still be refunded for this order unit. … Kaufland refunds the … of the accepted return itself. | After an accepted return, Kaufland refunds the price of the unit itself; it is deducted from the refundable amount. | Refund only the remainder – or nothing. |
| The refund of … exceeds the … that can still be refunded … | A (partial) refund has already been made. | Reduce the amount. |
| Refunds in … cannot be sent from Business Central. | Only refunds in EUR can be sent from Business Central; not CZ (CZK) and PL (PLN). | Refund in the Kaufland Seller Portal. |
| Kaufland did not confirm the refund of … | Kaufland did not confirm; the refund is kept as unconfirmed and counts against the refundable amount. | Check in the Seller Portal; if Kaufland did not refund, delete the refund in Kaufland Refunds. |
| Kaufland order unit … has the status …, so nothing can be refunded. | No refund is possible in the line's current status. | – |
| Business Central does not know what the buyer paid … | The order or the return is not up to date. | Refresh the order or the return, then try again. |
| Kaufland return … has no accepted unit … | Only accepted return units are credited. | Accept the units first. |
| Every accepted unit of Kaufland return … is on a credit memo already … | All accepted units already have a credit memo. | Accept further units, or delete an unposted credit memo to create it again. |
| Kaufland order … has no posted sales invoice. The credit memo takes customer and prices from it … | No credit memo without a posted invoice. | Post the invoice of the order. |
Tickets
| Message | Cause | What to do |
|---|---|---|
| Ticket … cannot be closed, its status is …. | Only an open ticket or one closed by the buyer can be closed. | Check the status in the Kaufland Seller Portal. |
| Kaufland could not return … tickets. | Kaufland did not deliver tickets. | Nothing – they are read again first in the next import. |
More answers are in the FAQ; the way through the setup is described in Getting Started.