Reconhecer nota de fornecedor (MD-e)

A Manifestação do Destinatário (MD-e) é o evento em que uma empresa declara formalmente o que aconteceu com uma NFe emitida contra ela. É exigido pela SEFAZ em diversas situações (operações com produtos perigosos, exportação, varejo acima de determinado valor, etc.).

Códigos disponíveis

Código	Significado	Quando usar
210200	Confirmação da operação	A operação foi recebida e os produtos estão na minha empresa. Estado terminal, irreversível.
210210	Ciência da operação	Tomei conhecimento da NFe, mas ainda vou verificar. Estado provisório (15 dias).
210220	Desconhecimento da operação	Não conheço esta operação (NFe foi emitida contra mim por engano ou fraude).
210240	Operação não realizada	A operação estava marcada mas não aconteceu (mercadoria não chegou, foi recusada).

Cuidado

Confirmação (210200) é irreversível. Use apenas quando tiver certeza de que a mercadoria/serviço foi efetivamente recebido.

Fluxo

1. Listar notas de fornecedor recebidas

   curl $BASE/nffornecedor \
     -H "Authorization: Token $TOKEN"

   Identifique a NFe que deseja manifestar e pegue a chave.

2. Enviar o reconhecimento

   curl -X POST $BASE/nffornecedor/reconhecimento \
     -H "Authorization: Token $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "chave": "35260512345678000199550010000000011000000010",
       "codigo-reconhecimento": "210200"
     }'

   Resposta:

   {
     "status": "001",
     "descricao": "Reconhecimento de nota do fornecedor registrado com sucesso.",
     "data": { "recibo": "rec_abc123" }
   }

3. Consultar o resultado

   curl $BASE/nffornecedor/{recibo} \
     -H "Authorization: Token $TOKEN"

Fluxo recomendado

flowchart LR
    A[NFe recebida do fornecedor] --> B{Verificação}
    B -->|Mercadoria conferida e recebida| C[210200 Confirmação]
    B -->|Ainda vou verificar| D[210210 Ciência]
    D --> E{Confirma?}
    E -->|Sim| C
    E -->|Não recebeu| F[210240 Operação não realizada]
    B -->|Não reconheço| G[210220 Desconhecimento]

Prazos

A SEFAZ define prazos máximos para manifestação. Não cumprir pode gerar:

• Bloqueio do recebimento de outras NFes.
• Restrições fiscais à empresa.

Verifique com seu contador os prazos aplicáveis ao seu segmento e UF.

Automatização

Para empresas com alto volume, considere:

1. Polling diário de GET /nffornecedor?page=1&page_size=100 para detectar NFes novas.
2. Conferência automática contra pedidos de compra/notas internas.
3. 210200 automático quando bate; 210210 quando precisa de revisão humana.

Erros comuns

Mensagem	Causa
Campo nffornecedor@chave deve ter 44 caracteres.	Chave incorreta
Campo codigo-reconhecimento inválido.	Valor fora dos 4 permitidos
status: "900" (rejeição SEFAZ)	NFe não está no portal MD-e (talvez já manifestada, ou ainda não enviada pelo emitente)