Registrar Ator Interessado

POST/v1/nfe/{id}/ator-interessado

Registra o Ator Interessado (evento 110150) em um documento autorizado, indicando uma pessoa física ou jurídica com interesse no documento fiscal (por exemplo, uma transportadora ou intermediador de negociação) além do emitente e do destinatário. O evento é roteado via Ambiente Nacional.

Só se aplica a documentos com mod 55 (NF-e) ou 65 (NFC-e) que já estejam AUTORIZADA. O registro pode ser feito em até 6 meses após a autorização do documento.

Registrando em NFC-e

Se o documento for uma NFC-e, use POST /v1/nfc-e/{id}/ator-interessado em vez de /v1/nfe/{id}/ator-interessado — o restante do contrato é idêntico.

Esse é um evento síncrono — a resposta HTTP já traz o resultado da SEFAZ, sem necessidade de polling.

Parâmetros do corpo

cpfstring

CPF do ator interessado. Informe cpf ou cnpj, nunca os dois.

cnpjstring

CNPJ do ator interessado. Informe cpf ou cnpj, nunca os dois.

permite_autorizacao_terceirosboolean

Indica se o ator interessado tem permissão para autorizar terceiros a acessar o documento fiscal.

Resposta

200 OK / 201 Created

statusstring

Valores aceitos: autorizado | erro_autorizacao

Resultado do registro junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xml_evento_ator_interessadostring

URL pública do XML do evento, quando autorizado.

numero_evento_ator_interessadonumber

Número sequencial do evento de Ator Interessado registrado para este documento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../ator-interessado \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "cnpj": "12345678000199",
    "permite_autorizacao_terceiros": true
  }'

Node.js

const resposta = await client.registerInterestedParty('55', invoiceId, {
  cnpj: '12345678000199',
  permite_autorizacao_terceiros: true,
});
console.log(resposta.status); // 'autorizado'

Python

resposta = client.register_interested_party("55", invoice_id, {
    "cnpj": "12345678000199",
    "permite_autorizacao_terceiros": True,
})
print(resposta["status"])  # 'autorizado'

Java

RegisterInterestedPartyData data = new RegisterInterestedPartyData();
data.cnpj = "12345678000199";
data.permite_autorizacao_terceiros = true;

SyncEventResponse resposta = client.registerInterestedParty("55", invoiceId, data);
System.out.println(resposta.status); // "autorizado"

Exemplo de resposta

{
  "status": "autorizado",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao documento fiscal eletrônico",
  "caminho_xml_evento_ator_interessado": "https://storage.../evento-ator-interessado.xml",
  "numero_evento_ator_interessado": 1
}