For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/mobile/commerce.md (or send Accept: text/markdown).
Comércio no mobile
Gere produtos e encomendas da loja para o workspace.
Produtos
GET e POST em /api/mobile/commerce/products listam e criam produtos — só owner e admin. Um produto novo começa como draft; os preços entram como strings e guardam-se em cêntimos com precisão de duas casas decimais, e o seguimento de inventário é opcional. Os produtos nunca são apagados: archived é o estado de remoção, e PATCH atualiza campos e status — draft, active, archived — juntos.
As encomendas só avançam
GET /api/mobile/commerce/orders lista as encomendas; são criadas pelo checkout da loja, nunca pela app. PATCH avança o estado só para a frente — pending para paid para fulfilled — com cancelled permitido antes do pagamento e refunded depois. Cancelar repõe o inventário seguido na mesma transação, e uma transição ilegal é um no-op silencioso em vez de um erro que o utilizador tenha de dispensar.
Verificação e resolução de problemas
Vende através do checkout público, avança a encomenda no mobile e confirma que o stock volta quando uma encomenda pending é cancelada. Membros abaixo de admin não conseguem chegar à superfície de todo — verifica que a veem como indisponível e não como vazia.