Notas Fiscais

Reemitir Nota Fiscal

Gera uma nova nota para uma emissão que falhou na prefeitura. O identificador é o invoiceId da listagem.

Só vale para notas que não foram autorizadas: uma nota já autorizada é recusada com NOTA_ALREADY_ISSUED — nesse caso o caminho é cancelar e emitir de novo.

A nota anterior fica com status REPLACED e a nova assume o lugar dela. A configuração fiscal usada é a mesma da nota anterior.

Corrija a causa da recusa antes de reemitir: a mensagem da prefeitura está em nf.errors, na consulta da nota.

Case de uso:

Como prestador, quero reprocessar uma nota recusada por erro de cadastro, depois de corrigir a configuração fiscal.

POST/v1/invoices/notas/:notaid/reemitir
Base URL Produção:https://api.validapay.com.br
Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

nota.fiscal/write

Path Parameters

NameTypeRequiredDescription
notaidstringRequiredNotaid
const url = 'https://sandbox.validapay.com.br/v1/invoices/notas/{{notaId}}/reemitir';

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200
{
  "success": true,
  "invoiceId": "nf_1788101026585_uqaspo7bn",
  "subscriptionId": null,
  "cycleNumber": null,
  "type": "NFSE",
  "status": "PROCESSING",
  "numero": null,
  "tipo": "nacional"
}
400400 - já autorizada
{
    "error": {
        "message": "Nota já autorizada — não pode ser reemitida",
        "code": "NOTA_ALREADY_ISSUED",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}