# Errors in the app Error messages in Ritevo: what each error means for orders, documents, shipments, the warehouse, messages and integrations, and what to do. When an operation fails, Ritevo shows a short message. Below are all messages grouped by area, with an explanation of what they mean. ### Data and requests - **Validation error** (API: "Validation error" = `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** (API: "Invalid request" = `INVALID_REQUEST`) - the request cannot be read, for example its body is malformed. - **Invalid value** (API: "Invalid value" = `INVALID_ENUM`) - the chosen value is not on the allowed list. - **Unsupported data format** (API: "Unsupported data format" = `UNSUPPORTED_MEDIA_TYPE`) - the data came in a format Ritevo does not accept. - **Invalid parameter** (API: "Invalid parameter" = `INVALID_PARAMETER`) - a request parameter has a wrong value, for example an id in the wrong format. - **Missing parameter** (API: "Missing parameter" = `MISSING_PARAMETER`) - a required parameter is missing from the request. - **Internal error** (API: "Internal error" = `INTERNAL_ERROR`) - an error on Ritevo's side. Try again in a moment; if it keeps happening, contact us. ### Limits - **Limit exceeded** (API: "Limit exceeded" = `LIMIT_EXCEPTION`) - a limit was reached, for example the number of integrations, actions or items in one operation. ### Audit - **Audit log not found** (API: "Audit log not found" = `AUDIT_LOG_NOT_FOUND`) - the change history entry does not exist or belongs to another company. ### Automatic actions - **Action step validation error** (API: "Action step validation error" = `ACTION_STEP_VALIDATION`) - an action step is incomplete or has invalid settings. - **Automatic action not found** (API: "Automatic action not found" = `AUTOMATIC_ACTION_NOT_FOUND`) - the action does not exist or was deleted. - **Condition validation error** (API: "Condition validation error" = `CONDITION_VALIDATION`) - an action condition is incomplete or has an invalid value. - **Cyclic dependency detected** (API: "Cyclic dependency detected" = `CYCLIC_DEPENDENCY`) - saving the action would create a loop - actions would keep triggering each other. Change the trigger or the steps. ### Integrations - **Integration not found** (API: "Integration not found" = `INTEGRATION_NOT_FOUND`) - the integration does not exist, was deleted or belongs to another company. - **AI integration not found** (API: "AI integration not found" = `AI_INTEGRATION_NOT_FOUND`) - the chosen AI integration does not exist or was deleted. - **Invalid model** (API: "Invalid model" = `INVALID_MODEL`) - the chosen AI model is not available with this provider or on your account. - **Invalid token** (API: "Invalid token" = `INVALID_TOKEN`) - the AI provider rejected the API key. Check the key in the provider's panel. ### Documents - **Billing document already exists** (API: "Billing document already exists" = `BILLING_ALREADY_EXISTS`) - this order already has such a document. - **Document already transferred** (API: "Document already transferred" = `BILLING_ALREADY_TRANSFERRED`) - the document was already sent to the accounting integration and cannot be changed. - **External transfer not found** (API: "External transfer not found" = `BILLING_EXTERNAL_TRANSFER_NOT_FOUND`) - there is no record of sending this document to the accounting integration. - **Document already has a correction** (API: "Document already has a correction" = `BILLING_HAS_CORRECTION`) - a correction has already been issued for this document. - **Document has no correction** (API: "Document has no correction" = `BILLING_HAS_NO_CORRECTION`) - the operation needs a correction, but the document has none. - **Document line item not found** (API: "Document line item not found" = `BILLING_LINE_ITEM_NOT_FOUND`) - the given line item does not exist in the document. - **Billing document not found** (API: "Billing document not found" = `BILLING_NOT_FOUND`) - the document does not exist or belongs to another company. - **Billing documents not found** (API: "Billing documents not found" = `BILLINGS_NOT_FOUND`) - none of the chosen documents was found. - **Settings for the billing type not found** (API: "Settings for the billing type not found" = `BILLING_SETTINGS_BY_BILLING_TYPE_NOT_FOUND`) - settings for this document type are missing, for example the numbering for receipts. - **Billing settings not found** (API: "Billing settings not found" = `BILLING_SETTINGS_NOT_FOUND`) - the given document settings do not exist. - **Billing settings reference error** (API: "Billing settings reference error" = `BILLING_SETTINGS_REFERENCE`) - these settings cannot be deleted because documents have already been issued with them. - **Default settings cannot be deleted** (API: "Default settings cannot be deleted" = `DEFAULT_BILLING_SETTINGS_DELETION`) - the default document settings cannot be deleted. - **This document is not supported by this integration** (API: "This document is not supported by this integration" = `BILLING_TYPE_NOT_SUPPORTED`) - the chosen integration does not issue this document type, for example a correction or a receipt. - **Tax rate not supported** (API: "Tax rate not supported" = `TAX_RATE_NOT_SUPPORTED`) - the integration does not support the VAT rate of this line item. ### Orders - **Orders not found** (API: "Orders not found" = `ORDERS_NOT_FOUND`) - none of the chosen orders was found. - **Order not found** (API: "Order not found" = `ORDER_NOT_FOUND`) - the order does not exist or belongs to another company. - **Order line item not found** (API: "Order line item not found" = `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** (API: "The order is not compatible with the chosen integration or shipping method" = `ORDER_AND_SHIPPING_COMPATIBILITY`) - 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. ### Shipments and parcels - **Shipment not found** (API: "Shipment not found" = `SHIPMENT_NOT_FOUND`) - the shipment does not exist or belongs to another order. - **Parcel quantity exceeds the order quantity** (API: "Parcel quantity exceeds the order quantity" = `PACKAGE_QUANTITY_EXCEEDED`) - more items were added to the parcel than the order contains. - **Label does not match any of the order's shipments** (API: "Label does not match any of the order's shipments" = `PACKAGE_LABEL_NOT_FOUND`) - the scanned label does not belong to this order's shipments. - **Label already used in another parcel** (API: "Label already used in another parcel" = `PACKAGE_LABEL_ALREADY_USED`) - this label is already assigned to another parcel. ### Products and warehouse - **Product not found** (API: "Product not found" = `PRODUCT_NOT_FOUND`) - the product does not exist or belongs to another company. - **A product with this SKU already exists** (API: "A product with this SKU already exists" = `PRODUCT_SKU_ALREADY_EXISTS`) - the warehouse already has a product with the same SKU. - **Stock not found** (API: "Stock not found" = `STOCK_NOT_FOUND`) - there is no stock recorded for the product. - **Stock does not match the product** (API: "Stock does not match the product" = `STOCK_PRODUCT_MISMATCH`) - the given stock belongs to another product. - **Price not found** (API: "Price not found" = `PRICE_NOT_FOUND`) - there is no price recorded for the product. - **Price already exists** (API: "Price already exists" = `PRICE_ALREADY_EXISTS`) - the product already has the price you are trying to add. - **The line item has no offer id** (API: "The line item has no offer id" = `EXTERNAL_OFFER_ID_REQUIRED`) - 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** (API: "The offer is already linked to another product" = `EXTERNAL_OFFER_ALREADY_ASSIGNED`) - this offer is already assigned to another product in the warehouse. ### Statuses - **Status not found** (API: "Status not found" = `STATUS_NOT_FOUND`) - the status does not exist or was deleted. - **Status operation error** (API: "Status operation error" = `STATUS_OPERATION`) - this operation cannot be done, for example deleting the default status or replacing a status with itself. ### Messages - **Message not found** (API: "Message not found" = `MESSAGE_NOT_FOUND`) - the thread does not exist or belongs to another company. - **Messages not found** (API: "Messages not found" = `MESSAGES_NOT_FOUND`) - none of the chosen threads was found. - **Message operation error** (API: "Message operation error" = `MESSAGE_OPERATION`) - this operation cannot be done for this thread type, for example finishing a claim in an ordinary message. - **Message template not found** (API: "Message template not found" = `MESSAGE_TEMPLATE_NOT_FOUND`) - the template does not exist or was deleted. - **The integration does not support messages** (API: "The integration does not support messages" = `MESSAGES_NOT_SUPPORTED`) - this channel has no messages. - **Messages of this integration are handled by e-mail** (API: "Messages of this integration are handled by e-mail" = `MESSAGES_SUPPORTED_BY_EMAIL`) - buyers write by e-mail - you handle them through the e-mail integration. - **This integration does not support replying** (API: "This integration does not support replying" = `MESSAGE_REPLY_NOT_SUPPORTED`) - you cannot reply from Ritevo in this channel or thread type. - **This integration does not support attachments** (API: "This integration does not support attachments" = `MESSAGE_ATTACHMENT_UPLOAD_NOT_SUPPORTED`) - this channel does not accept attachments in replies. - **This integration does not support downloading attachments** (API: "This integration does not support downloading attachments" = `MESSAGE_ATTACHMENT_DOWNLOAD_NOT_SUPPORTED`) - you can open the file only in the sales channel's panel. - **The message is too long** (API: "The message is too long" = `MESSAGE_LENGTH_EXCEEDED`) - the reply exceeds 2000 characters. ### Other - **External provider error** (API: "External provider error" = `EXTERNAL_EXCEPTION`) - the sales channel, courier or another provider rejected the operation. The provider's error text is shown in the message. - **Unexpected error** (API: "Unexpected error" = `UNEXPECTED`) - 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. --- All help in one file: https://ritevo.com/llms-full.txt. Help map with links to every page: https://ritevo.com/llms.txt.