Errors in the app

When an operation fails, Ritevo shows a short message. Below are all messages grouped by area, with an explanation of what they mean.

Validation error - the data sent is incomplete or in the wrong format, for example an empty required field or a text that is too long. Correct the marked fields and save again.
Invalid request - the request cannot be read, for example its body is malformed.
Invalid value - the chosen value is not on the allowed list.
Unsupported data format - the data came in a format Ritevo does not accept.
Invalid parameter - a request parameter has a wrong value, for example an id in the wrong format.
Missing parameter - a required parameter is missing from the request.
Internal error - an error on Ritevo's side. Try again in a moment; if it keeps happening, contact us.

Limit exceeded - a limit was reached, for example the number of integrations, actions or items in one operation.

Audit log not found - the change history entry does not exist or belongs to another company.

Action step validation error - an action step is incomplete or has invalid settings.
Automatic action not found - the action does not exist or was deleted.
Condition validation error - an action condition is incomplete or has an invalid value.
Cyclic dependency detected - saving the action would create a loop - actions would keep triggering each other. Change the trigger or the steps.

Integration not found - the integration does not exist, was deleted or belongs to another company.
AI integration not found - the chosen AI integration does not exist or was deleted.
Invalid model - the chosen AI model is not available with this provider or on your account.
Invalid token - the AI provider rejected the API key. Check the key in the provider's panel.

Billing document already exists - this order already has such a document.
Document already transferred - the document was already sent to the accounting integration and cannot be changed.
External transfer not found - there is no record of sending this document to the accounting integration.
Document already has a correction - a correction has already been issued for this document.
Document has no correction - the operation needs a correction, but the document has none.
Document line item not found - the given line item does not exist in the document.
Billing document not found - the document does not exist or belongs to another company.
Billing documents not found - none of the chosen documents was found.
Settings for the billing type not found - settings for this document type are missing, for example the numbering for receipts.
Billing settings not found - the given document settings do not exist.
Billing settings reference error - these settings cannot be deleted because documents have already been issued with them.
Default settings cannot be deleted - the default document settings cannot be deleted.
This document is not supported by this integration - the chosen integration does not issue this document type, for example a correction or a receipt.
Tax rate not supported - the integration does not support the VAT rate of this line item.

Orders not found - none of the chosen orders was found.
Order not found - the order does not exist or belongs to another company.
Order line item not found - the given line item does not exist in the order.
The order is not compatible with the chosen integration or shipping method - the shipment cannot be created with this integration, for example an order from a different Allegro account than the one connected to Send with Allegro.

Shipment not found - the shipment does not exist or belongs to another order.
Parcel quantity exceeds the order quantity - more items were added to the parcel than the order contains.
Label does not match any of the order's shipments - the scanned label does not belong to this order's shipments.
Label already used in another parcel - this label is already assigned to another parcel.

Product not found - the product does not exist or belongs to another company.
A product with this SKU already exists - the warehouse already has a product with the same SKU.
Stock not found - there is no stock recorded for the product.
Stock does not match the product - the given stock belongs to another product.
Price not found - there is no price recorded for the product.
Price already exists - the product already has the price you are trying to add.
The line item has no offer id - the order line item cannot be linked to a product, because the sales channel did not pass the offer number.
The offer is already linked to another product - this offer is already assigned to another product in the warehouse.

Status not found - the status does not exist or was deleted.
Status operation error - this operation cannot be done, for example deleting the default status or replacing a status with itself.

Message not found - the thread does not exist or belongs to another company.
Messages not found - none of the chosen threads was found.
Message operation error - this operation cannot be done for this thread type, for example finishing a claim in an ordinary message.
Message template not found - the template does not exist or was deleted.
The integration does not support messages - this channel has no messages.
Messages of this integration are handled by e-mail - buyers write by e-mail - you handle them through the e-mail integration.
This integration does not support replying - you cannot reply from Ritevo in this channel or thread type.
This integration does not support attachments - this channel does not accept attachments in replies.
This integration does not support downloading attachments - you can open the file only in the sales channel's panel.
The message is too long - the reply exceeds 2000 characters.

External provider error - the sales channel, courier or another provider rejected the operation. The provider's error text is shown in the message.
Unexpected error - something went wrong on Ritevo's side. Try again; if it keeps happening, contact us.

Errors in the API

API errors use the Problem Details format (RFC 9457) and return three fields:

code - one of the error codes described above.
title - a short title of the error.
detail - usually a detailed description of what went wrong in the given request.