Idempotência

A API Emitfy suporta idempotência para evitar emissão duplicada de notas fiscais em caso de retentativa de rede ou timeout.

Como usar

Passe o header Idempotency-Key com um identificador único por emissão:

Shell

curl -X POST https://api.emitfy.com/v1/companies/ID_DA_EMPRESA/nfse \
  -H "X-Api-Key: <api-key>" \
  -H "X-Api-Secret: <api-secret>" \
  -H "Idempotency-Key: pedido-42" \
  -H "Content-Type: application/json" \
  -d '{ "serviceDescription": "...", "amount": 500, "borrower": { "name": "..." } }'

Alternativamente, inclua externalId no corpo da requisição. O header tem prioridade sobre o campo do body.

Comportamento

Se a chave já existir para a empresa, a API retorna a nota existente sem reprocessar
A resposta é idêntica à da criação original (status, id, amount)
O campo externalId é único por empresa — não por conta

Exemplo de retorno idempotente

JSON

{
  "ok": true,
  "data": {
    "id": "018f6e3b-...",
    "saleId": "018f6e3b-...",
    "status": "authorized",
    "type": "nfse",
    "externalId": "pedido-42",
    "amount": 500.00
  }
}