| /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/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.
|