Enums
P2Lab Mirakl uses string status values across its entities — connections, offers, exports, sync logs and so on. This page lists every value that can appear, with a short explanation of what it means in plain language.
The values are case-sensitive: some are lowercase, some UPPERCASE (where the value matches the marketplace’s API verbatim). The capitalised UI labels for these values come from snippets — for example status error is shown as Error in the admin.
Offer sync state
Section titled “Offer sync state”Used on the offer mapping row (visible on the Offer Mappings page).
| Value | Meaning |
|---|---|
pending | The mapping exists but hasn’t been queued for sync yet. |
queued | Waiting in the queue for the next sync run. |
processing | A sync run is currently working on this row. |
retry | The previous attempt failed transiently and the run will try again. |
synced | Successfully sent to the marketplace; no changes detected since. |
error | The last attempt failed for a reason that needs your attention. The row carries the error message. |
Product export state
Section titled “Product export state”Used on the product export row (visible on the Product Catalog list, Export Status column).
| Value | Meaning |
|---|---|
pending | Picked for export but not yet queued. |
queued | Waiting in the queue for the next export run. |
uploaded | The CSV has been uploaded to the marketplace; waiting for the marketplace to process it. |
processing | The marketplace is currently processing the row. |
retry | The previous attempt failed transiently and the run will try again. |
exported | The marketplace accepted the row and it is now in the marketplace catalog. |
error | The marketplace rejected the row. The row carries the error message. |
Connection state
Section titled “Connection state”Used on the Connections list (Status column). The same three values are shown on the Connection Status widget on the Dashboard.
| Value | Meaning |
|---|---|
connected | The most recent test succeeded; scheduled syncs run for this connection. Shown as Connected. |
disconnected | The connection hasn’t been verified yet or was paused; scheduled syncs skip it. Shown as Disconnected. New connections start in this state. |
error | The most recent test or sync failed; scheduled syncs skip it. Shown as Error. Hover over the status, or open Edit Connection, to see the marketplace’s message. |
There is no pending state in the connection lifecycle.
Task progress
Section titled “Task progress”Used on the Tasks list (Dashboard → Quick Start → Tasks) and on the progress modal for admin-triggered actions.
| Value | Friendly name | Meaning |
|---|---|---|
pending | Waiting… | Just created, not yet picked up by a worker. |
in_queue | In queue… | Sitting in the queue waiting for a worker. |
processing | Processing… | A worker is actively running the task. |
running | — | Alternative name for processing, used by some flows. |
completed | Completed! | Finished successfully. |
error | Error | Failed; the task carries the latest message. |
cancelled | — | Cancelled before completion. |
Sync log status
Section titled “Sync log status”Used on the Sync Logs list (Status column).
| Value | UI label | Meaning |
|---|---|---|
started | Started | A long-running run is in progress. |
completed | Completed | The run finished successfully. |
error | Error | The run failed; the row carries the marketplace’s error message. |
A run in started for hours typically means the worker died part-way through — see Troubleshooting.
Sync log level
Section titled “Sync log level”Used on the Sync Logs list (Level column). Controls which rows survive the Sync log levels setting on Mirakl → Settings → Options.
| Value | UI label | Meaning |
|---|---|---|
debug | Debug | Very fine-grained tracing. Off by default. |
info | Info | Informational rows (a run started, a noteworthy event). |
success | Success | A run finished successfully. |
warning | Warning | Something noteworthy happened that didn’t stop the run. |
error | Error | An attempt failed. |
Sync type
Section titled “Sync type”Used on the Sync Logs list (Type column). Each value labels a class of run. The UI translates the common types into friendly names through snippets (for example offer_sync shows as Offer sync); rarer types display the underlying value.
| Value | What it covers |
|---|---|
offer_sync | A batch upload of offers to the marketplace. Shown as Offer sync. |
offer_delete | Withdrawing an offer from the marketplace. Shown as Offer delete. |
offer_delete_status_check | Polling the marketplace for the result of an offer-delete request. |
stock_sync | A batch upload of stock updates. Shown as Stock sync. |
order_import | Pulling new and updated orders. Shown as Order import. |
order_state_sync | Sending order state changes back to the marketplace (accept, ship, refuse, refund). Shown as Order state sync. |
product_export | A product-catalogue export run, rolled up per connection. Shown as Product export. |
product_export_batch | One batch of a product-catalogue export. Shown as Product export batch. |
product_import_status_check | Polling the marketplace for the result of a product import. Shown as Product import status check. |
product_import_item_error | Fetching the per-line error report for a failed product import. Shown as Product import item error. |
add_products / add_to_catalog | Adding products to the offer list or the catalogue from the admin. |
auto_map_attributes | The background Auto Map action on the Attribute Mappings page. |
catalog_export | A manual CSV export from the Catalog Export page. |
refresh_categories | Refreshing categories from the marketplace. |
refresh_product_attributes | Refreshing product attributes from the marketplace. |
refresh_offer_states | Refreshing offer states from the marketplace. |
refresh_offer_fields | Refreshing offer fields from the marketplace. |
refresh_reason_codes | Refreshing reason codes from the marketplace. |
initial_message_import | First-time backfill of inbound messages after enabling message sync. |
order_document_sync | Pulling new inbound order documents. |
document_request_sync | Pulling new document requests from the marketplace. |
initial_order_document_import | First-time backfill of inbound order documents. |
upload_order_document | Sending a document up to the marketplace. |
fulfill_document_request | Answering a document request from the marketplace. |
invoice_sync | Pulling new invoices from the marketplace. |
transaction_log_sync | Pulling new transaction log entries from the marketplace. |
initial_invoice_import | First-time backfill of invoices. |
initial_transaction_log_import | First-time backfill of the transaction log. |
transaction_log_export | A bulk transaction-log export job triggered from the admin. |
Order import status
Section titled “Order import status”Used on the row that tracks a Mirakl order’s Shopware-side state.
| Value | Meaning |
|---|---|
pending | Picked up from the marketplace but not yet created in Shopware. |
imported | A Shopware order has been created for this Mirakl order. |
error | Creating the Shopware order failed. The row carries the error message. |
deleted | The Shopware order was deleted; the link is kept for audit. |
Product import status
Section titled “Product import status”Used on the local product-import row (visible on Imports detail pages).
| Value | Meaning |
|---|---|
pending | The import has been queued but not yet started by the marketplace. |
running | The marketplace is currently processing the import. |
complete | The marketplace finished the import. Per-line errors may still exist. |
error | The marketplace failed the import as a whole. |
Order document — direction
Section titled “Order document — direction”Used on order document rows. UPPERCASE.
| Value | Meaning |
|---|---|
INBOUND | The document came from the marketplace into Shopware. |
OUTBOUND | The document was sent from Shopware to the marketplace. |
Order document — source
Section titled “Order document — source”Used on order document rows. UPPERCASE.
| Value | Meaning |
|---|---|
AUTO_SHOPWARE | Generated automatically by Shopware (e.g. by document auto-upload). |
MANUAL_SHOPWARE | Created or uploaded manually from the Shopware admin. |
MANUAL | Uploaded manually outside Shopware. |
MIRAKL_SYNC | Pulled from the marketplace by the document sync. |
Order document — status
Section titled “Order document — status”Used on order document rows.
| Value | Meaning |
|---|---|
pending | Created but not yet processed. |
uploading | Currently being sent to the marketplace. |
uploaded | Successfully sent to the marketplace. |
synced | Confirmed by the marketplace. |
error | The transfer or sync failed. The row carries the error message. |
downloaded | (For inbound documents) Successfully downloaded from the marketplace. |
Document request — state
Section titled “Document request — state”Used on document request rows pulled from the marketplace. UPPERCASE.
| Value | Meaning |
|---|---|
STAGING | The marketplace is preparing the request. |
TO_PROCESS | Waiting for you to provide the document. |
ISSUED | The document has been provided. |
CANCELED | The marketplace cancelled the request. |
Document request — type
Section titled “Document request — type”Used on document request rows. UPPERCASE.
| Value | Meaning |
|---|---|
INVOICE | The marketplace is asking for an invoice. |
CREDIT_NOTE | The marketplace is asking for a credit note. |
Invoice — type
Section titled “Invoice — type”Used on invoice rows. UPPERCASE.
| Value | Meaning |
|---|---|
AUTO_INVOICE | Invoice generated automatically by the marketplace. |
MANUAL_INVOICE | Invoice entered manually on the marketplace side. |
MANUAL_CREDIT | Manual credit note. |
Invoice — payment status
Section titled “Invoice — payment status”Used on invoice rows. UPPERCASE.
| Value | Meaning |
|---|---|
PENDING | Not paid yet. |
PAID | Marked as paid. |
FAILED | The payment attempt failed. |
Offer delete
Section titled “Offer delete”Used during the offer withdraw flow on the offer mapping row.
| Value | Meaning |
|---|---|
deleting | Withdraw request sent to the marketplace; waiting for confirmation. |
delete_failed | The withdraw request failed. The row stays so you can retry. |
Once the marketplace confirms the delete, the mapping row is removed entirely — there is no deleted value.
Attribute source type
Section titled “Attribute source type”Used on attribute mapping and offer field mapping rows. Each value drives a different source-picker UI in the mapping dialog.
| Value | Meaning |
|---|---|
product_field | A standard Shopware product field (name, description, EAN, etc.). |
custom_field | A Shopware custom field. |
property_group | A Shopware property group (used for variant axes etc.). |
category | Smart category — uses the Mirakl category mapping if available, otherwise falls back to the Shopware category name. |
mirakl_category | Strict Mirakl category — only the Mirakl category mapping (with parent inheritance). |
shopware_category | Raw Shopware category name or path, never the mapping. |
product_image | A product image. |
tax | The product’s tax value. |
static | A static value you type in. |
ean_or_sku | Either EAN or SKU, whichever is available. |
ean_or_sku_type | A flag indicating which of the two was used. |
shop_sku | The Shopware product number. |
shop_sku_type | A flag identifying the SKU type. |
ean | The product’s EAN. |
ean_type | A flag identifying the EAN type. |
effective_stock | The product’s effective stock value. |
mirakl_offer_state | The product’s per-connection Offer State override (or the connection default). |
delivery_time | The product’s delivery time. |
Marketplace-side import statuses
Section titled “Marketplace-side import statuses”Returned by the marketplace on import status checks. These are marketplace-side states, distinct from the local sync states above. All values are UPPERCASE as the marketplace returns them.
Offer imports
WAITING,RUNNING,COMPLETE,FAILED
Product imports
WAITING,RUNNING,COMPLETE,FAILED,TRANSFORMATION_FAILED
Stock imports
WAITING,RUNNING,COMPLETE,FAILED
Transaction log export — local state
Section titled “Transaction log export — local state”Used on the row that tracks a manual transaction-log export job.
| Value | Meaning |
|---|---|
pending | Created but the marketplace job hasn’t started yet. |
running | The marketplace is generating the file. |
completed | The file has been downloaded. |
error | The job failed. |
Transaction log export — marketplace state
Section titled “Transaction log export — marketplace state”The marketplace returns one of these on the status-poll endpoint. They are grouped into “ready” and “failed”.
- Ready (download the file):
AVAILABLE,COMPLETED,SUCCESS. - Failed (terminal):
FAILED,ERROR,CANCELLED.
Sync error codes
Section titled “Sync error codes”Stable codes attached to Sync Logs rows when an error has a well-known cause. The admin shows them as a friendly message via snippets; the underlying technical message stays available as a fallback. Format: <flow>.<reason>.
Product export (productExport.*):
productNotVisible— Product is not visible in the connection’s sales channel (inactive, missing visibility or deleted).requiredAttributeEmpty— Product skipped because a required attribute is empty.missingRequiredAttributes— Product is missing required attributes (list provided).noAttributeMappings— No attribute mappings configured for this connection.noImportId— Marketplace returned no import ID.miraklApiError— Generic marketplace API error.rateLimitExhausted— Rate limit exceeded; all retries used up.rateLimited— Rate-limited; batch will retry after the marketplace’s cooldown.unexpected— Unexpected failure (uncategorised).
Offer sync (offerSync.*):
productNotVisible— Product is not visible in the connection’s sales channel.missingRequiredAttributes— Product is missing required attributes (list provided).missingOfferFields— Product is missing required offer fields (list provided).noCategoryMapping— No Mirakl category mapping found for this product’s categories.catalogPrerequisiteMissing— Product not yet exported to the marketplace catalog. Export it first from the Products page.requiredFieldEmpty— Offer skipped because a required field is empty.miraklApiError— Generic marketplace API error.rateLimitExhausted— Rate limit exceeded; all retries used up.rateLimited— Rate-limited; batch will retry after the marketplace’s cooldown.
Related
Section titled “Related”- Settings — configurable intervals and switches
- Sync logs — where most of these values show up
- Background tasks — the lifecycle of the Tasks entries