Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NFe Recebidas

Evento

Com os eventos é possível vincular a uma NF-e qualquer ato, realizado por agente envolvido ou relacionado com a operação acobertada pela NF-e.

Este endpoint possui retorno síncrono.

Veja abaixo os campos que podem ser enviados na requisição.

post/nfes_recebidas/{chave}/evento

Path parameters

chavestring required
Example:35122225222278000855550010000002821510931504

Chave de acesso da NFe

Request body

tipo_evento'solicitacao_credito_presumido' | 'destinacao_consumo_pessoal_recebida' | 'ocorrencia_transporte_adquirente' | 'aceite_debito_nota_credito' | 'imobilizacao_item' | 'solicitacao_credito_combustivel' | 'solicitacao_credito_atividade_adquirente' required

Tipo do evento. Informar um dos códigos abaixo:

  • solicitacao_credito_presumido: Solicitação de Apropriação de crédito presumido
  • destinacao_consumo_pessoal_recebida: Destinação de item para consumo pessoal
  • ocorrencia_transporte_adquirente: Perecimento, perda, roubo ou furto durante o transporte contratado pelo adquirente
  • aceite_debito_nota_credito: Aceite de débito na apuração por emissão de nota de crédito
  • imobilizacao_item: Imobilização de Item
  • solicitacao_credito_combustivel: Solicitação de Apropriação de Crédito de Combustível
  • solicitacao_credito_atividade_adquirente: Solicitação de Apropriação de Crédito para bens e serviços que dependem de atividade do adquirente
indicador_aceite_nota_credito'0' | '1'

Indicador de concordância com o valor da nota de crédito que lançaram IBS e CBS na apuração assistida (Campo utilizado apenas no evento aceite_debito_nota_credito).

  • 0: Não aceite
  • 1: Aceite

Example request

{
  "tipo_evento": "solicitacao_credito_presumido",
  "itens_solicitacao_credito_presumido": [
    {
      "numero_item": 1,
      "base_calculo": 1.5,
      "codigo_credito_presumido_ibs": "ABC",
      "percentual_credito_presumido_ibs": 2.0224,
      "valor_credito_presumido_ibs": 20.22,
      "codigo_credito_presumido_cbs": "CBA",
      "percentual_credito_presumido_cbs": 3.0338,
      "valor_credito_presumido_cbs": 30.34
    }
  ],
  "itens_destinacao_consumo_pessoal": [
    {
      "numero_item": 1,
      "valor_ibs": 1.5,
      "valor_cbs": 3.75,
      "quantidade": 2,
      "unidade": "UN",
      "chave_acesso": "21240205283031000706550010001115211747484750",
      "numero_item_dfe_referenciado": 2
    }
  ],
  "itens_ocorrencia_transporte_adquirente": [
    {
      "numero_item": 1,
      "valor_ibs": 1.5,
      "valor_cbs": 3.75,
      "quantidade": 2,
      "unidade": "UN"
    }
  ],
  "indicador_aceite_nota_credito": "1",
  "itens_imobilizacao": [
    {
      "numero_item": 1,
      "valor_ibs": 1.5,
      "valor_cbs": 3.75,
      "quantidade": 2,
      "unidade": "UN"
    }
  ],
  "itens_solicitacao_credito_combustivel": [
    {
      "numero_item": 1,
      "valor_ibs": 1.5,
      "valor_cbs": 3.75,
      "quantidade": 2,
      "unidade": "UN"
    }
  ],
  "itens_solicitacao_credito_atividade_adquirente": [
    {
      "numero_item": 1,
      "valor_ibs": 1.5,
      "valor_cbs": 3.75
    }
  ]
}

Response

Requisição processada com sucesso

eventostring

Nome do evento enviado

status_sefazstring

Status do evento na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ detalhando o status

status'autorizado' | 'erro_autorizacao'

Autorizado, se o evento for registrado com sucesso, ou erro_autorizacao, se houve algum erro no registro do evento

caminho_xml_evento_[NOME_DO_EVENTO]string

Caso a evento tenha sido registrado, será informado aqui o caminho para download do XML

numero_evento_[NOME_EVENTO]string

Número sequencial do evento

numero_protocolostring

Número do protocolo do evento