Devoluções e Anulações no Novo Sistema

Estorno de IBS/CBS, refNFe, finNFe e créditos na devolução.

No modelo de IVA Dual (IBS e CBS) com não-cumulatividade plena baseada em crédito financeiro, as devoluções de mercadorias, cancelamentos extemporâneos e notas de ajuste exigem rastreabilidade estrita da operação original para garantir a simetria entre o crédito apropriado pelo adquirente e o estorno do débito pelo vendedor.

Princípios Fundamentais de Estorno

Rastreabilidade

Referência Obrigatória

Toda nota de devolução deve informar a chave de acesso (44 dígitos) e o item correspondente no campo nfeReferenciada por item (chaveAcesso e nItem).

Simetria

Mesmo cClassTrib

Os itens devolvidos devem manter o mesmo código de classificação tributária (cClassTrib) da nota de venda original.

Não-Cumulatividade

Estorno de Crédito

O IBS e a CBS destacados na devolução anulam o débito do fornecedor e exigem o estorno do crédito pelo adquirente no split/apuração.

Modalidades de Ajuste e Prazos

OperaçãoFinalidade / ParâmetrosPrazo TípicoQuando Utilizar
Cancelamento por EventoPOST /v1/nfe/:id/cancel (Evento 110111)24h após autorização (varia por UF)Mercadoria ainda não circulou e a operação foi desfeita integralmente.
Devolução Emitida pelo Destinatáriofinalidade = 4, tipoOperacao = "1"Conforme prazo comercial / devoluçãoCliente contribuinte devolve mercadoria com sua própria NF-e referenciando a venda.
NF-e de Entrada (Devolução por Não Contribuinte)finalidade = 4, tipoOperacao = "0"No momento do retorno físico da cargaCliente pessoa física ou não contribuinte sem inscrição estadual devolve a mercadoria.
Nota de Ajuste de IBS/CBSfinalidade = 3Período de apuração mensalAjustes fiscais escriturais autorizados pela legislação tributária.

1. Geração Automática a Partir de NF-e Existente

A rota mais rápida e segura para criar uma devolução é o endpoint POST /v1/nfe/:id/devolucao. O motor NFER inverte automaticamente as partes, define finalidade: 4, tipoOperacao: "0", forma de pagamento "90" (Sem Pagamento) e vincula a chave de acesso e o nItem em cada linha:

curl -X POST "https://api.nfer.me/v1/nfe/e5b8d0c2-3e28-4f1b-8517-8e6d19a4e8d3/devolucao" \
-H "Authorization: Bearer sec_live_sua_chave_secreta" \
-H "Content-Type: application/json" \
-d '{
"itens": [
{ "numeroItem": 1, "quantidade": 2 }
]
}'

Após a criação do rascunho de devolução, basta chamar POST /v1/nfe/:id/send para assinar e transmitir à SEFAZ.

2. Criação Manual / Avulsa via API

Se a venda original foi emitida em outro sistema e você deseja criar o rascunho de devolução via POST /v1/nfe, passe finalidade: 4, tipoOperacao: "0" e o grupo nfeReferenciada no item:

{
"tipoOperacao": "0",
"finalidade": 4,
"naturezaOperacao": "DEVOLUCAO DE MERCADORIA ADQUIRIDA DE TERCEIROS",
"customer": {
"cpfCnpj": "12345678000195",
"nome": "FORNECEDOR DISTRIBUIDOR LTDA",
"indicadorIe": "1",
"ie": "123456789110",
"endereco": {
"logradouro": "Rua das Industrias",
"numero": "500",

Atenção à Conciliação do Split Fiscal

Se a venda original utilizou o Split Fiscal NFER para liquidação direta das guias de IBS/CBS, o estorno ou devolução gera um crédito que será compensado nas apurações seguintes da conta gráfica ou deduzido dos repasses futuros via split bancário. Consulte a documentação de Split Fiscal.