Campos da Chamada

Campo 

 

 

 Tipo 

 

 

 Obrigatório 

 

 

 Formato/Valores 

 

 

 Descrição 

 

 

 

 

 chave 

 

 

 string 

 

 

 Sim 

 

 

 44 dígitos 

 

 

 Chave de acesso da NF-e vinculada ao evento. 

 

 

 

 

 eventos 

 

 

 array 

 

 

 Sim 

 

 

 Lista de códigos 

 

 

 Lista de eventos a serem enviados. 

 

 

 

 

 itens 

 

 

 array 

 

 

 Sim 

 

 

 Lista de itens 

 

 

 Lista de itens 

 

 

 

 

 numeroItem 

 

 

 integer 

 

 

 Sim 

 

 

 Número do item no XML 

 

 

 Item da NF-e ao qual o evento se refere. 

 

 

 

 

 numerosItem 

 

 

 array 

 

 

 Sim 

 

 

 Lista dos números de item da NF-e 

 

 

 Lista dos números dos itens da NF-e vinculados ao evento, indicando quais itens do documento fiscal geram direito à apropriação de crédito de IBS e CBS. 

 

 

 

 

 indicadorAceitacao 

 

 

 boolean 

 

 

 Sim 

 

 

 true/false 

 

 

 Indica aceite ou não aceite. 

 

 

 

 

   

 Obs.: Múltiplos eventos por chamada - Todos os endpoints aceitam múltiplos eventos no array eventos[]. Cada item é processado individualmente e retorna seu próprio resultado no array de resposta. Um item pode falhar sem cancelar o processamento dos demais. 

 Obs2.: Atualmente, o Governo permite o envio de eventos em lote limitado a até 20 eventos por chamada. No entanto, a recomendação é que o envio seja realizado individualmente, pois essa forma tende a ser exigida futuramente , conforme previsto na Nota Técnica 2025.002-RTC , versão 1.50 , de junho de 2026 . 

   

 Respostas: 

 

 

 

 

 Tipo de retorno 

 

 

 Exemplo 

 

 

 Significado 

 

 

 

 

 HTTP 200 com sucesso true 

 

 

 Evento autorizado 

 

 

 A API processou e a SEFAZ registrou o evento. 

 

 

 

 

 HTTP 200 com sucesso false 

 

 

 Rejeição da SEFAZ 

 

 

 A API processou a chamada, mas o evento foi rejeitado pelo ambiente fiscal. 

 

 

 

 

 HTTP 400 

 

 

 Erro de requisição 

 

 

 A estrutura enviada está inválida ou faltam campos obrigatórios. 

 

 

 

 

 HTTP 401 

 

 

 Erro de autenticação 

 

 

 Token ausente, expirado ou inválido. 

 

 

 

 

 HTTP 403 

 

 

 Erro de permissão 

 

 

 Cliente não habilitado para o recurso. 

 

 

 

 

 HTTP 500 

 

 

 Erro interno 

 

 

 Falha inesperada no processamento.