O corpo de erro segue este formato geral:
{
"statusCode": 422,
"timestamp": "2026-07-29T15:10:00.000Z",
"path": "/api/v1/labels/shipments/ID/emit",
"error": "Unprocessable Entity",
"message": "Envio não está apto para emissão"
}message pode ser uma string ou uma lista.
| Status | Ação |
|---|---|
400 | Corrija corpo, parâmetro ou tipo de DACE. |
401 | Renove uma vez; faça login se a renovação falhar. |
403 | Confira permissão e X-Tenant-Id; não tente outra loja. |
404 | Confira shipmentId, labelId ou código. |
409 | Reconcilie o estado antes de repetir. |
422 | Corrija a regra de negócio; repetição idêntica não ajuda. |
429 | Respeite Retry-After e aplique backoff com jitter. |
5xx | Tente novamente com limite e reconciliação. |
Operações sensíveis
Não repita automaticamente emissão de etiqueta nem geração de DACE após timeout. Primeiro descubra se a operação anterior foi concluída.
Uma sugestão para consultas:
- primeira nova tentativa após 2 segundos;
- depois 5, 15 e 30 segundos;
- limite de tentativas;
- jitter aleatório;
- fila de análise ao esgotar.
Logs seguros
Registre método, rota, status, duração, loja e identificador de correlação. Não registre senha, tokens, URL temporária, endereço, documento, conteúdo fiscal ou dados térmicos do DACE.