PLATAFORMA DE INTEGRAÇÕES
Erros e idempotência
Trate respostas sem repetir operações.
Requisições previsíveis, sem duplicidade
Idempotência
POST e PATCH exigem Idempotency-Key: AQUI_VAI_O_UUID. Gere um UUID novo para cada operação distinta. Repetir a mesma operação e conteúdo com a mesma chave retorna o resultado registrado; usar essa chave para outro conteúdo retorna 409.
A resposta idempotente reflete a operação original. Faça GET para consultar o estado atual. Um timeout na transmissão não autoriza repetir a emissão com outra chave.
Respostas HTTP
- 401: credencial ausente, inválida, revogada, expirada ou conta indisponível.
- 403: escopo, ambiente ou liberação de produção não permitem o acesso.
- 404: registro inexistente ou indisponível para a empresa e ambiente da chave.
- 409: conflito de revisão, idempotência ou estado da operação.
- 422: campos inválidos ou bloqueios de validação fiscal. Confira os detalhes retornados.
- 429: limite de requisições atingido; observe
Retry-After.
Limites
Os limites padrão são 120 requisições por minuto por IP, 120 por token e 600 por empresa. A paginação aceita até 100 registros por página. Trate limitações respeitando o intervalo indicado; não reenvie automaticamente uma transmissão de resultado incerto.