| /problems/bad-request |
The initiated request is invalid or malformed |
Review your client request against the defined semantics for the API and check the message field in the response for more details |
| /problems/validation-error |
The request contains invalid or malformed details |
Check whether all properties you are passing with your request match the defined semantics. Look at the
message & errors fields in the response for more details
|
| /problems/not-found |
The requested resource was not found |
Make sure you’re using the correct identifier to obtain the resource you’re trying to access |
| /problems/forbidden |
Access to the requested resource is not authorised |
Make sure you have the correct permissions and check the message field in the response for more details about why access to this resource is restricted |
| /problems/unauthorized |
The request lacks valid information needed for authentication |
Make sure your credentials are valid and check the message field in the response for more details |
| /problems/server-error |
The server encountered an unexpected error |
If the issue persists, contact our support |
| /problems/service-unavailable |
The service is temporarily unavailable |
Retry with exponential backoff. If it persists, contact support |
| /problems/inactive-account |
The account you are trying to access is no longer active |
Contact your seller manager for more information |
| /problems/storefront-not-configured |
The requested storefront is not configured for your account |
Configure the storefront in the Seller Portal, or contact support |
| /problems/invalid-credentials |
No matching account found for the provided credentials |
Make sure you are using correct and valid credentials |
| /problems/corrupted-signature |
The request signature is not generated correctly |
Use the Signature Calculator to verify your signature step by step. Enter the same inputs your code used and compare the computed signature against the one that was rejected — the tool will show exactly which component of the canonical string differs. |
| /problems/duplicate-action |
The action has already been performed on the entity and therefore cannot be processed again |
- |
| /problems/action-not-allowed |
The requested action cannot be performed on the provided entity |
- |
| /problems/tickets/internal-action-restriction |
Action on ticket related entity where seller is not involved cannot be performed by seller |
- |
| /problems/tickets/fbk-action-restriction |
Action (Opening, Closing, Messaging) on ticket with related FBK Order, where seller is not involved cannot be performed by seller |
- |
| /problems/tickets/non-closable-by-seller |
The Ticket is currently in internal processing and can therefore not be closed by the seller |
Contact your seller manager to get more information about finding a solution |
| /problems/tickets/finally-closed |
A seller can not publish a message in a finally closed ticket |
- |
| /problems/tickets/attachments-upload-failure |
Something went wrong when storing attachments sent alongside a request to create a message in a ticket |
Please consult your Seller Manager to find out the root cause. |
| /problems/insufficient-funds |
The seller's account does not have enough funds to perform the action |
- |
| /problems/returns/unit-wrong-status |
Returns unit(s) have wrong status |
- |
| /problems/returns/return-address-not-set |
Return address is not set |
- |
| /problems/returns/return-address-unsupported-country |
It is not possible to initialize a return to the seller's return address |
- |
| /problems/order-units/cancel-error |
Error performing order cancellation |
- |
| /problems/order-units/cancel-not-possible |
Cancellation of order unit is not possible |
- |
| /problems/order-units/cancel-not-allowed |
Cancellation of order unit is not allowed |
- |
| /problems/order-units/missing-payment |
Cancellation of order unit that wasn't paid |
- |
| /problems/order-units/shipping-rate-not-defined |
Shipping rate is not defined |
- |
| /problems/subscriptions/unverified-callback-url |
The provided callback URL is not configured correctly |
Follow the steps described on our documentation page
to make sure your push notification subscription is compliant with our callback URL verification process
|
| /problems/reports/already-pending |
A report of the same type with the same parameters (e.g. storefront, date range) has already been
requested and is still waiting to be generated or being generated. Only one such report can be pending at a time
|
Do not request the report again. Use the id_report from the errors field to check the
status of the pending report via the /reports/{id_report}
endpoint and download it once it is in the done state
|
| /problems/already-exists |
The entity already exists |
Check the message field to see which value caused the conflict (e.g. a name), then choose a different, unique value and retry |
| /problems/has-units |
The Shipping Group or Warehouse cannot be deleted because it has units |
Move Units to another Shipping Group or Warehouse before deleting |
| /problems/last-element |
The last Shipping Group or Warehouse cannot be deleted |
Create a new default Shipping Group or Warehouse first |
| /problems/default-required |
You attempted to delete or unset the default Shipping Group or Warehouse without first assigning a new default |
Set a new default Shipping Group or Warehouse first |
| /problems/units/bulk-duplicate-units |
The provided request contains duplicate Units |
Remove duplicates and try again |
| /problems/units/bulk-too-many-units |
The provided request contains too many Units. The maximum number of Units is specified in the error message |
Split the request so that each request contains no more than the maximum number of Units |
| /problems/units/bulk-invalid-operation |
Batch operations cannot be performed when one or more of the selected offers use a fulfillment type that is not supported for batch operations |
Remove those offers from the batch and update them individually |
| /problems/units/bulk-too-many-batches |
Unit Service can't handle more than one asynchronous batch operation at a time |
Wait for your current batch operation to finish before submitting a new one, then retry |
| /problems/units/default-warehouse-forbidden |
Non-EU sellers with more than one warehouse, or EU sellers with more than one warehouse with at least one non-EU warehouse must provide an explicit id_warehouse when creating an offer |
Include the id_warehouse field in your request |
| /problems/units/default-warehouse-not-found |
No default warehouse is configured for this seller account |
Either configure a default warehouse or include the id_warehouse field in your request |
| /problems/shipping-groups/region-storefront-missing |
The first Region must contain Storefront Country |
Add the Storefront Country as a destination Country to the first Region |
| /problems/shipping-groups/region-duplicate-countries |
Shipping Group Regions are not allowed to have duplicate Countries |
Remove duplicates and try again |
| /problems/warehouses/missing-tax-information |
To create or update a Warehouse in a Country, you need to provide local tax information |
Provide Country tax information on the
Seller Portal page
|
| /problems/warehouses/default-warehouse-setup-forbidden |
Non-EU sellers with more than one warehouse, or EU sellers with more than one warehouse with at least one non-EU warehouse cannot set default warehouse |
Sellers with this warehouse configuration are not permitted to have a default warehouse — omit is_default or set it to false for this warehouse |
| /problems/warehouses/warehouse-country-immutable |
Country cannot be updated once a Warehouse is already created |
Please try creating a new Warehouse with the desired country and reassign the existing units to the new Warehouse if needed |
| /problems/import-files/file-too-large |
The provided file is too large |
Split the file into smaller parts |
| /problems/shipping-labels/warehouse-missing |
Missing warehouse information |
We are missing the warehouse information in order to generate the shipping label. Please try again later.
If it isn't resolved, please get in contact via your kss contact Email.
|
| /problems/vouchers/terms-not-accepted |
The Voucher Terms and Conditions have not been accepted for the storefront |
Accept the Voucher Terms and Conditions for the storefront in the
Seller Portal before creating vouchers
|
| /problems/vouchers/status-change-not-allowed |
The voucher cannot be activated, deactivated, or deleted in its current status |
Verify the voucher's current status before retrying. See the
Voucher documentation for the allowed status transitions
|
| /problems/vouchers/not-editable |
The voucher cannot be edited in its current status |
Verify the voucher's current status before retrying. See the
Voucher documentation for the allowed status transitions
|
| /problems/vouchers/unresolvable-eans |
One or more of the provided EANs could not be resolved to a product in your assortment |
Check the message field for the specific EANs that failed to resolve, and verify they are
valid and belong to your account.
|
| /problems/contacts/product-not-found |
The provided EAN could not be resolved to a product |
Verify the EAN is correct and belongs to your assortment |
| /problems/contacts/manufacturer-not-found |
The provided manufacturer name could not be resolved to any known manufacturer in the Kaufland catalog |
Verify the name against the catalog, or check for encoding issues with special characters |
| /problems/contacts/contact-not-found |
The requested contact could not be found |
Check the message field for details |
| /problems/contacts/invalid-contact-info |
contact_info is invalid |
Check the message field for details, and see the GPSR contacts guide for the contact_info rules |