Skip to content

Ask AI

Ask anything about Destesi — setup, products, APIs.

Powered by Claude. Answers may be wrong — always verify against the docs.

Commerce troubleshooting

This is the most common report, and it almost never produces an error message — the symptom is nothing happening. Work down this list:

  1. WhatsApp isn’t connected. Check Connect for an active WhatsApp connection. Without it, replies are composed and stored against the conversation but never delivered — which looks identical to the agent ignoring the buyer.
  2. The conversation isn’t active. If it was marked needs human or closed, the agent stands down on purpose. It’s waiting for you, in Clientes.
  3. The monthly agent allowance is spent. At the cap, buyers get one message saying a person will follow up, the thread routes to you, and you’re notified once. See the limits in the reference.
Error Meaning Fix
503 payments_disabled No usable payment credential resolved Configure a payment method in Settings → Pagos, or connect Wompi in Connect
409 order_already_paid Shipping change attempted after payment; the shipping amount is frozen once money has moved Cancel and re-create, or ship as quoted
409 illegal_transition The order can’t move that way — see the state table Check the order’s current state first

An order stays unpaid though the buyer says they paid. Expected, briefly: Commerce waits for proof, not for a buyer’s word. A card or PSE payment settles when the provider’s webhook arrives. A bank transfer settles when Commerce matches the deposit in your connected Gmail, or when you confirm it on WhatsApp. Cash on delivery settles when the carrier reports the package delivered. If a transfer never confirms, check that Gmail is connected — otherwise every transfer falls back to asking you by hand.

Error Meaning
409 insufficient_stock The order asks for more units than exist. Nothing was reserved and stock is unchanged.
409 out_of_stock The product or variant has no stock at all.

Stock looks lower than it should. Open, unpaid orders hold their units. A draft, pending_payment, or payment_failed order is still reserving stock, and it releases automatically when the reservation expires — 30 minutes by default. You don’t need to correct stock by hand after an abandoned checkout.

Error Meaning Fix
503 carrier_disabled No carrier account available Connect Skydropx in Connect
404 origin_not_set No warehouse origin Set it in Settings → Bodega
422 weight_incomplete A product in the order has no weight Add weight_grams to the product
422 address_required No delivery address on the order Capture the buyer’s address first
422 no_rate_selected Buying a label with no rate chosen Quote, then select a rate
409 rate_expired The quote is older than the carrier’s 24-hour window Re-quote and select again
409 carrier_insufficient_balance The carrier account can’t cover the label Top up, or use your own carrier account
Error Meaning
422 meta_settings_not_set Meta Ads isn’t connected, or no ad account and Page are selected
422 campaign_image_required The campaign has no creative to publish
openai_not_connected Image generation needs an OpenAI connection
reference_required Image generation was asked for without a reference photo
Error Meaning
503 chat_disabled The operator chat has no model configured
503 uploads_disabled Attachments need Drive; it isn’t wired up
503 store_unavailable / persistence_disabled The database is unreachable — transient; retry
503 funding_unavailable No exchange rate is configured for the wallet’s currency
Error Meaning
401 missing_session No token and no session cookie
401 session_invalid The session expired — sign in again at account.destesi.io
401 unknown_bearer_scheme The Authorization header isn’t a Destesi token. It will not fall back to your cookie
401 missing_workspace_header A token was sent without X-Destesi-Workspace
404 on an id you can see elsewhere The record belongs to another workspace — check the workspace switcher

Orders, Customers, Campaigns, and Logistics replace their contents with the setup checklist until your business profile, warehouse, categories, payments, and at least one connection exist. Navigation is never locked, so you can keep exploring — the screen is telling you what to finish, not that something broke. Work through Set up your business.

  • Check the order timeline — it records what happened and what triggered it, which usually identifies the step that didn’t run.
  • Check Connect for a connection that expired or was revoked upstream; a revoked provider account looks like a silent feature failure.
  • Confirm you’re in the right workspace — everything in Commerce is workspace-scoped.