Erros
HTTP Status
Códigos HTTP usados pela API SmartPOS.
HTTP Status
| Campo | Tipo | Descrição |
|---|---|---|
| 400 | HTTP | Revise JSON, campos obrigatórios, formatos e regras como comanda obrigatória em fila manual. |
| 401 | HTTP | Envie x-api-key ativa. GET /v1/health ajuda a diagnosticar a credencial. |
| 403 | HTTP | A API key não tem permissão para o documentoCliente informado. |
| 404 | HTTP | SmartPOS não encontrado para o cliente informado ou nenhum SmartPOS disponível no modo manual. |
| 409 | HTTP | O campo referencia já foi usado. Reutilize o retorno salvo ou gere uma nova referência para uma nova tentativa. |
| 500 | HTTP | Erro interno inesperado. Preserve a referência e o payload para tentar novamente com segurança depois. |