Enviar Evento de NFS-e

Método: POST

Endpoint: https://api.emitix.com.br/nfse/evento

Descrição Geral

Permite registrar eventos relacionados a uma Nota Fiscal de Serviço Eletrônica (NFS-e) na SEFIN Nacional. Eventos representam alterações de estado de uma nota, como Cancelamentos, Substituições, Confirmações, Rejeições, Atos de Ofício, entre outros.

Função da Rota

• Enviar um pedido oficial de cancelamento de uma NFS-e.
• Registrar Confirmações ou Rejeições (do tomador ou intermediário).
• Solicitar Análise Fiscal para cancelamentos extemporâneos (quando o prazo padrão prescreve).

Situações de Uso

• O usuário do ERP percebeu um erro na nota emitida e deseja solicitar seu cancelamento (e101101) ou substituição (e105102).
• Cancelar uma nota devido ao não pagamento ou não prestação do serviço acordado.
• Manifestação explícita do tomador em relação ao serviço faturado.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
pedRegEvento.infPedReg.tpAmb	string	✅	"1" (Produção) ou "2" (Homologação).
pedRegEvento.infPedReg.verAplic	string	✅	Versão do aplicativo (ex: '1.0.0').
pedRegEvento.infPedReg.dhEvento	string	✅	Data e hora do evento. Padrão AAAA-MM-DDThh:mm:ssTZD (Ex: 2024-06-19T13:00:15-03:00).
pedRegEvento.infPedReg.chNFSe	string	✅	Chave de Acesso da NFS-e que sofrerá o evento (44 caracteres).
pedRegEvento.infPedReg.CNPJAutor	string	⚙️ Opcional*	CNPJ do autor do evento (prestador/tomador).
pedRegEvento.infPedReg.CPFAutor	string	⚙️ Opcional*	CPF do autor do evento.
pedRegEvento.infPedReg.e101101	object	⚙️ Depende	Objeto de "Evento de cancelamento" (apenas um tipo de evento por requisição).
pedRegEvento.infPedReg.e105102	object	⚙️ Depende	Objeto de "Cancelamento por substituição".
certificate	string	⚙️ Opcional	Certificado digital A1 em base64. Opcional caso já cadastrado.
pass_certificate	string	⚙️ Opcional	Senha do certificado digital.

Observação 1: Deve ser informado obrigatoriamente o identificador do autor: CNPJAutor ou CPFAutor.
Observação 2: O objeto contendo as informações do evento (e101101, e105102, e202201, etc.) é obrigatório, mas você deve enviar apenas um tipo de evento por requisição.

Documentação Completa (Swagger)

Devido à grande variedade de eventos municipais disponíveis no padrão nacional, recomendamos fortemente consultar a nossa documentação interativa no Swagger (https://api.emitix.com.br/api) para visualizar a estrutura completa de cada tipo de evento suportado (ex: rejeições, cancelamentos por ofício, etc).

Autenticação

A rota exige autenticação dupla através dos cabeçalhos:

• Bearer Token
  • Authorization: Bearer <seu_token_de_acesso>
• API Key
  • api-key: <sua_api_key>

Exemplo de Payload (Cancelamento Padrão - e101101)

{
  "pedRegEvento": {
    "infPedReg": {
      "tpAmb": "1",
      "verAplic": "1.0.0",
      "dhEvento": "2024-06-19T13:00:15-03:00",
      "chNFSe": "12345678901234567890123456789012345678901234",
      "CNPJAutor": "12345678000199",
      "e101101": {
        "cMotivo": "1",
        "xMotivo": "Erro no preenchimento do valor do serviço"
      }
    }
  }
}

Exemplo de Requisição Completa

curl -X POST https://api.emitix.com.br/nfse/evento \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -H "api-key: <api_key>" \
  -d '{
    "pedRegEvento": {
      "infPedReg": {
        "tpAmb": "1",
        "verAplic": "1.0.0",
        "dhEvento": "2024-06-19T13:00:15-03:00",
        "chNFSe": "12345678901234567890123456789012345678901234",
        "CNPJAutor": "12345678000199",
        "e101101": {
          "cMotivo": "1",
          "xMotivo": "Erro no preenchimento do valor do serviço"
        }
      }
    }
  }'

Exemplo de Resposta

{
  "success": true,
  "message": "Registro de evento NFS-e realizado com sucesso",
  "statusCode": 201,
  "data": {
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><retEnvEvento>...</retEnvEvento>",
    "response": {
      "cStat": "100",
      "xMotivo": "Evento Registrado e Vinculado a NFS-e",
      "chNFSe": "12345678901234567890123456789012345678901234",
      "dhRegEvento": "2024-06-19T13:05:15-03:00",
      "nProt": "123456789012345"
    }
  }
}