Kaufland API Log
Log of the API calls to the Kaufland Seller API. Each entry shows the method, endpoint, status code, and duration, plus request and response. Meant for troubleshooting.
Logging must be switched on in the Kaufland Setup via Log API Requests.
The entries are read-only and sorted by entry number in descending order (newest first). Entries older than 30 days are deleted by the scheduled tasks on their next run and by the nightly merchantCENTRAL data protection run.
Administrators only: Requests and responses contain buyer data. Only users with the permission set ALN MCK Admin (merchantCENTRAL Kaufland Admin) may read the log; with ALN MCK User, the Kaufland processes still write it, but the action API Log is hidden.
What is not in the log:
- Files in a request or response – an uploaded invoice, a shipping label. In their place is
(file content left out of the log). - The query part of links – everything from the
?of a link in a request or response. The link of an import file and the download link of a shipping label carry their access token there; the log shows?(query left out of the log)instead.
Opening the Page
- Via search: Kaufland API Log
- Via the Kaufland Setup → action API Log
- Via the Kaufland Dashboard → Advanced → API Log
Fields
| Field | Description |
|---|---|
| Entry No. | Sequential number of the log entry. |
| Log Timestamp | Timestamp of the API call. |
| HTTP Method | HTTP method: GET reads, POST creates, PATCH and PUT change, DELETE removes. |
| Endpoint | Called API endpoint (e.g. orders/…, units/…). |
| Status Code | HTTP status code of the response (200 = OK, 4xx/5xx = error). Green on success, red otherwise. |
| Success | Whether the call was successful. For a query whose answer can also be “does not exist” – EAN search in the catalog, product data status – status 404 counts as successful: Kaufland does not know the EAN or the product data (yet). Such calls do not set the marketplace to “Error”. |
| Duration (ms) | Duration of the call in milliseconds. |
| Error Message | Why the call failed: Kaufland's readable message including field errors; otherwise that no response came, the response was not JSON, or the HTTP status without a readable message. Empty for a successful call. The complete response is shown by View Response. |
Actions
| Action | Description |
|---|---|
| View Request | Displays the sent request body (JSON) of the selected entry, without any files it contains. |
| View Response | Displays the received response body of the selected entry. |
| Clear Log | Deletes all log entries. Asks first with their number, default No, and names the number deleted at the end; if the log is empty, a message says so. Entries older than 30 days disappear even without this action. |
All three actions are also at the top of the action bar.
Error Messages from Kaufland
If Kaufland refuses a request, the title of the message names the request in words (“Kaufland request”), the text gives Kaufland's answer. Method and endpoint are listed as Request in the details – the same values as HTTP Method and Endpoint in the log. If Kaufland sent no readable message, the message points to the API Log; only users who may read the log get this hint. More help: Troubleshooting.
API Log and Activity Log
The API Log is the technical log of every single request and is only written with Log API Requests. Independently of this, the merchantCENTRAL Activity Log gets one entry per run:
| Run | Entry |
|---|---|
| Order import | per storefront: imported orders and orders whose details are read again on the next run |
| Inventory sync | per sales channel: sent offers, refused offers, and offers Kaufland no longer carries |
| Price sync | per sales channel: sent offers, refused offers, and offers without a price |
| Shipment confirmations | sent, refused, and otherwise failed confirmations |
| Invoice upload (UPLOAD-INVOICES) | uploaded and failed invoices, with the last error message |
| Return, ticket, and offer import | only on errors, per storefront: a list Kaufland did not deliver, or single records that are read again on the next run |
A run without news leaves no entry: when it had nothing to do, only read an order a second time, or Kaufland refuses an offer again for the same reason. If Kaufland refuses individual offers or shipment confirmations, the entry is marked as failed, but the marketplace stays OK. Only a run that does not reach Kaufland, cannot read the order list of a storefront, or leaves shipment confirmations without a response sets the marketplace to “Error”; the sales channel then keeps its last successful sync. A run for a sales channel whose code is not a Kaufland storefront does not count as successful either, see Storefront and Sales Channel.