Sellivo Error Code Catalog
Complete reference for every error code emitted by the Sellivo API and dashboards, with causes and remediation.
106 codes documented, kept in sync with the source tree.
Authentication & authorization 14
-
FULFILLMENT_WEBHOOK_INVALIDFulfillment webhook invalid 401 critical -
GEMINI_AUTH_FAILEDGemini API key rejected 401 critical -
INSUFFICIENT_PERMISSIONSInsufficient permissions 403 warning -
JWT_EXPIREDJWT expired 401 info -
JWT_INVALIDJWT signature invalid 401 warning -
LOGIN_FAILEDLogin failed 401 info -
PAYPLUS_AUTH_FAILEDPayPlus credentials rejected 401 critical -
SHOPIFY_AUTH_FAILEDShopify access token rejected 401 critical -
SHOPIFY_WEBHOOK_INVALIDShopify webhook HMAC verification failed 401 critical -
STRIPE_AUTH_FAILEDStripe API key rejected 401 critical -
STRIPE_WEBHOOK_INVALIDStripe webhook signature invalid 401 critical -
TENANT_SCOPE_MISMATCHCross-tenant access attempt 404 critical -
WA_AUTH_FAILEDWhatsApp credential rejected 401 critical -
WIDGET_TOKEN_INVALIDWidget token rejected 401 warning
Validation 7
-
AI_CONTEXT_OVERFLOWAI context window exceeded 413 warning -
BOT_PILL_INVALID_CONDITIONSBot pill conditions invalid 422 warning -
INVALID_PAYLOADInvalid payload 400 info -
INVALID_PHONE_FORMATInvalid phone number format 400 info -
MISSING_REQUIRED_FIELDMissing required field 400 info -
VALIDATION_FAILEDValidation failed 400 info -
WA_TEMPLATE_VARIABLE_MISMATCHTemplate variables don’t match definition 422 warning
Rate limiting 10
-
CUSTOMER_FLOOD_LIMITCustomer flood limit hit 429 warning -
GEMINI_RATE_LIMITEDGemini rate limit 429 warning ⟳ -
MERCHANT_BURST_LIMITMerchant burst limit hit 429 warning ⟳ -
RATE_LIMIT_EXCEEDEDRate limit exceeded 429 warning ⟳ -
SES_RATE_LIMITEDSES rate limit 429 warning ⟳ -
SHOPIFY_RATE_LIMITEDShopify rate limit 429 warning ⟳ -
STRIPE_RATE_LIMITEDStripe rate limit 429 warning ⟳ -
WA_HTTP_429WhatsApp rate limit hit 429 warning ⟳ -
WA_RATE_LIMITEDWhatsApp rate limit (tier quota) 429 warning ⟳ -
WA_TEMPLATE_RATE_LIMITEDWhatsApp template management rate-limited 429 warning ⟳
Domain & business logic 31
-
BOT_PILL_IMPRESSION_DEDUPPill impression deduplicated 200 info -
BOT_PILL_NOT_FOUNDBot pill not found 404 info -
CONFLICTConflict 409 warning -
CONVERSATION_ALREADY_CLOSEDConversation already closed 409 info -
NO_PRODUCTS_MATCHEDNo products matched the query 200 info -
NOT_FOUNDResource not found 404 info -
OOS_EXCLUSIONProduct excluded — out of stock 200 info -
ORDER_NOT_FOUNDOrder not found 404 info -
PACING_CONFIG_NOT_FOUNDPacing config not found 404 warning -
PLAN_FEATURE_NOT_AVAILABLEFeature not available on current plan 402 info -
PLAN_LIMIT_BROADCASTSPlan broadcast limit reached 402 warning -
PLAN_LIMIT_CONVERSATIONS_EXCEEDEDPlan conversation limit reached 402 warning -
PLAN_LIMIT_CUSTOMERS_EXCEEDEDPlan customer limit reached 402 warning -
PLAN_LIMIT_MESSAGES_EXCEEDEDPlan message limit reached 402 warning -
PLAN_LIMIT_PRODUCTS_EXCEEDEDPlan product limit reached 402 warning -
PRODUCT_OUT_OF_STOCKProduct out of stock 409 info -
PUSH_SUBSCRIPTION_NOT_FOUNDPush subscription not found 404 info -
RE_ENGAGEMENT_ALREADY_SENTRe-engagement already sent 409 info -
RECOVERY_OPTED_OUTCustomer opted out of recovery 403 info -
RECOVERY_RULE_NOT_FOUNDRecovery rule not found 404 info -
RECOVERY_TEMPLATE_NOT_APPROVEDRecovery template not approved 409 warning -
RECOVERY_WINDOW_EXPIREDRecovery window expired 410 info -
RESOURCE_GONEResource permanently deleted 410 info -
RETURN_NOT_ALLOWEDReturn not allowed for this order 409 info -
RETURN_WINDOW_EXPIREDReturn window expired 409 info -
SHOPIFY_ORDER_NOT_FOUNDShopify order not found 404 info -
SHOPIFY_PRODUCT_NOT_FOUNDShopify product not found 404 info -
TENANT_NOT_FOUNDTenant not found 404 warning -
WA_TEMPLATE_NOT_APPROVEDWhatsApp template not in APPROVED state 409 warning -
WA_TEMPLATE_NOT_FOUNDWhatsApp template not found 404 warning -
WEBCHAT_SESSION_NOT_FOUNDWebchat session not found 404 info
External integrations 21
-
AI_BAD_OUTPUTAI returned malformed output 502 warning ⟳ -
GEMINI_HTTP_ERRORGemini HTTP error 502 warning ⟳ -
GEMINI_TIMEOUTGemini call timed out 504 warning ⟳ -
META_GRAPH_API_FAILEDGeneric Meta Graph API failure 502 warning ⟳ -
PAYPLUS_HTTP_ERRORPayPlus HTTP error 502 warning ⟳ -
PAYPLUS_PAYMENT_FAILEDPayPlus payment failed 402 warning -
PUSH_DELIVERY_FAILEDPush delivery failed 502 warning ⟳ -
QDRANT_COLLECTION_NOT_FOUNDQdrant collection missing 412 warning -
SES_SEND_FAILEDSES email send failed 502 warning ⟳ -
SHOPIFY_DISCONNECTEDShopify integration disconnected 412 critical -
SHOPIFY_HTTP_500Shopify Admin API returned 500 502 warning ⟳ -
SHOPIFY_INVENTORY_FETCH_FAILEDShopify inventory fetch failed 502 warning ⟳ -
SHOPIFY_RETURN_CANCEL_FAILEDShopify returnCancel mutation failed after retries 502 critical -
STRIPE_PAYMENT_FAILEDStripe payment declined 402 warning -
WA_HTTP_503WhatsApp Cloud API unavailable (503) 502 warning ⟳ -
WA_HTTP_5XXWhatsApp Cloud API returned 5xx 502 warning ⟳ -
WA_MESSAGE_UNDELIVERABLEWhatsApp message could not be delivered 422 info -
WA_PHONE_NOT_REGISTEREDWhatsApp phone number not registered 422 info -
WA_TEMPLATE_REJECTEDWhatsApp template rejected by Meta review 422 warning -
WA_TEMPLATE_SUBMIT_FAILEDWhatsApp template submission failed 422 warning -
WA_WINDOW_CLOSEDWhatsApp 24-hour service window closed 409 warning
Infrastructure 12
-
DB_CONNECTION_LOSTDatabase connection lost 503 critical ⟳ -
DB_DEADLOCKDatabase deadlock 409 warning ⟳ -
DB_QUERY_TIMEOUTDatabase query timed out 504 warning ⟳ -
INVENTORY_CACHE_MISSInventory cache miss 503 info ⟳ -
KAFKA_PUBLISH_FAILEDKafka publish failed 503 critical ⟳ -
KAFKA_REBALANCEKafka consumer rebalance 503 info ⟳ -
PUSH_VAPID_NOT_CONFIGUREDWeb Push VAPID keys not configured 503 critical -
QDRANT_DOWNQdrant unavailable 503 warning ⟳ -
QDRANT_TIMEOUTQdrant query timed out 504 warning ⟳ -
REDIS_CONNECTION_LOSTRedis connection lost 503 warning ⟳ -
REDIS_TIMEOUTRedis command timed out 504 warning ⟳ -
SSE_DISCONNECTEDSSE stream disconnected 503 info ⟳
Programmer / unexpected 11
-
ASSERTION_FAILEDInternal assertion failed 500 critical -
DB_CONSTRAINT_VIOLATIONDatabase constraint violated 409 error -
FRONTEND_ERRORFrontend render exception 500 error -
KAFKA_CONSUMER_CRASHKafka consumer crashed 500 critical -
KAFKA_PAYLOAD_INVALIDKafka payload schema invalid 422 error -
SSE_DUPLICATE_DELIVERYSSE duplicate delivery 500 warning -
SSE_OUT_OF_ORDERSSE message out of order 500 warning -
UNEXPECTEDUnexpected error 500 critical -
UNIMPLEMENTEDEndpoint not implemented 501 info -
WA_NATIVE_MESSAGE_BUILD_FAILEDNative WhatsApp message build failed 500 error -
WIDGET_RENDER_CRASHWidget rendering crashed 500 critical