NFSe

Registra evento de manifestação do tomador em uma NFS-e

Este endpoint registra, em nome do tomador, um evento de manifestação sobre uma NFS-e do padrão nacional junto à Sefin Nacional.

Os tipos de evento suportados (tp_evento) são:

  • ConfirmacaoTomador: confirmação da prestação do serviço pelo tomador (evento 203202 no ADN).
  • RejeicaoTomador: rejeição da NFS-e pelo tomador (evento 203206 no ADN). Exige o campo x_justificativa, com 15 a 255 caracteres.

O CNPJ informado em owner precisa pertencer à conta autenticada; caso contrário, a requisição é recusada com HTTP 403.

A chave de acesso (access_key) deve ter exatamente 50 posições, formadas por dígitos ou letras maiúsculas (para suportar o CNPJ alfanumérico). Chaves de NF-e (44 dígitos) são recusadas com HTTP 400.

O processamento é síncrono. Uma resposta HTTP 200 indica que a Sefin Nacional respondeu à requisição, mas não garante que o evento foi registrado:

  • Evento registrado: data.n_dfse vem preenchido e data.erros vem null.
  • Evento rejeitado por regra de negócio da Sefin Nacional: data.erros traz o código e a descrição de cada rejeição, e os demais campos do evento não são preenchidos.
post/v1/nfse/event

Request

  • Base URL: https://api.arquivei.com.br
  • URL: https://api.arquivei.com.br/v1/nfse/event
  • Auth: none declared. Required headers: X-API-ID, X-API-KEY, X-Use-ApiGateway

Headers

X-API-IDstring required

API ID usado para autenticação.

X-API-KEYstring required

API KEY usado para autenticação.

X-Use-ApiGatewaystring required

Este header indica que a request será roteada pelo API Gateway da Qive e o valor deve ser passado como always.

Request body

ownerstring required

CNPJ do tomador da NFS-e, em nome de quem o evento será registrado. Deve pertencer à conta autenticada.

access_keystring required

Chave de acesso da NFS-e do padrão nacional, com exatamente 50 posições (dígitos ou letras maiúsculas).

tp_evento'ConfirmacaoTomador' | 'RejeicaoTomador' required

Tipo do evento de manifestação:

  • ConfirmacaoTomador: confirma a prestação do serviço.
  • RejeicaoTomador: rejeita a NFS-e. Exige x_justificativa.
x_justificativastring

Justificativa do evento. Obrigatória quando tp_evento for RejeicaoTomador, com 15 a 255 caracteres. Ignorada nos demais tipos.

n_seq_eventointeger

Número sequencial do evento para a NFS-e. Quando não informado, é usado o valor 1.

Example request

{
  "owner": "19427033000140",
  "access_key": "35503080219427033000140000000000123426090012345678",
  "tp_evento": "RejeicaoTomador",
  "x_justificativa": "Serviço não foi prestado conforme contratado",
  "n_seq_evento": 1
}

Response

Requisição processada pela Sefin Nacional. Verifique data.erros para saber se o evento foi registrado.

Example response

{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "data": {
    "tipo_ambiente": "1",
    "versao_aplicativo": "1.00",
    "data_hora_processamento": "2026-09-11T10:00:00-03:00",
    "id": "EVT35503080219427033000140000000000123426090012345678203206001",
    "ver_aplic": "SefinNacional_1.0.0",
    "amb_ger": "2",
    "n_seq_evento": "001",
    "dh_proc": "2026-09-11T10:00:00-03:00",
    "n_dfse": "123456789012345",
    "erros": null
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.