v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NFe

Registrar Ator Interessado

Registra um ator interessado para uma NFe autorizada.

O objetivo do evento Ator Interessado é permitir que o emitente informe a identificação do transportador (ou outra pessoa interessada) a qualquer momento, como uma das pessoas autorizadas a acessar o XML da NF-e.

Este método é síncrono.

Este evento somente pode ser gerado no prazo de 6 meses após a data de autorização da NF-e.

post/nfe/{referencia}/ator_interessado

Path parameters

referenciastring required
Example:12345

Referência da NFe

Request body

cpfstring

CPF do ator interessado

cnpjstring

CNPJ do ator interessado

permite_autorizacao_terceirosboolean

Permite que o transportador ou destinatário adicionem outros fornecedores

Example request

{
  "cpf": "12345678901",
  "permite_autorizacao_terceiros": true
}

Response

Ator interessado registrado

status'autorizado' | 'erro_autorizacao'

Status do evento

status_sefazstring

Status na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ

caminho_xml_evento_ator_interessadostring

Caminho para download do XML

numero_evento_ator_interessadointeger

Número sequencial do evento

Example response

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado a NF-e",
  "numero_evento_ator_interessado": 1
}