Tempo de leitura: 3 minutos
O erro AJUDA: A100VZ é uma das mensagens mais comuns e genéricas que aparecem no Protheus, principalmente ao incluir ou retornar documentos de entrada. A mensagem de Help é clara, mas nem sempre fácil de resolver: “Existe algum campo obrigatório em branco ou zerado”.
Se você está na rotina Documento de Entrada (MATA103) no módulo SIGACOM ou SIGAFAT, este guia rápido vai te ajudar a identificar e corrigir o problema!
🛑 O Que Significa o AJUDA: A100VZ?
A mensagem A100VZ é uma validação do Protheus que impede a gravação do registro (em uma tabela como SF1 ou SD1) porque um ou mais campos configurados como obrigatórios no dicionário de dados (SX3) estão sem informação ou com valor zero (dependendo do campo).
🎯 Cenário Mais Comum: Retornar Nota de Devolução
O erro ocorre com maior frequência ao utilizar a função “Retornar” na rotina MATA103 para uma Devolução de Vendas. O sistema falha em transferir corretamente dados críticos da nota de origem para os campos da devolução.
🛠️ Solução Rápida: 3 Passos para Resolver o Erro
Para solucionar o erro Protheus A100VZ, siga estas etapas de verificação e correção, focando na linha do item da Nota Fiscal (SD1):
Passo 1: Verificação dos Campos Críticos (Linha do Item)
Ao receber a mensagem, verifique se os seguintes campos estão preenchidos corretamente na linha do item (na tela de inclusão do Documento de Entrada):
-
Quantidade: Deve ser informada (não pode estar zerada se houver valor).
-
Valor Unitário e Valor Total: Devem estar de acordo com o documento de origem.
-
TES (Tipo de Entrada e Saída): O código deve estar correto para a operação (ex: Devolução).
-
CFOP (Código Fiscal de Operações e Prestações): O código fiscal deve estar preenchido e ser válido para a TES.
⚠️ Atenção: Muitas vezes, a Quantidade ou o Valor Unitário na tela fica em branco ou zerado após o “Retornar”, mesmo sendo obrigatório. Preencha manualmente se necessário.
Passo 2: Utilize o Vínculo Manual (Tecla F7)
Se a opção “Retornar” falhou, tente a inclusão manual, garantindo o vínculo correto:
- Inclua o Cabeçalho da Nota (Fornecedor, Série, Número, etc.).
- Na linha de Itens, preencha o Produto e a TES da devolução.
- Com o cursor sobre a linha do item, pressione a tecla F7.
- O Protheus abrirá a tela de Vínculo, onde você deve selecionar a Nota Fiscal de Venda (origem da devolução).
- Ao vincular, o sistema preencherá as quantidades e valores corretamente. Grave o documento.
Passo 3: Verificação de Parâmetros e Cadastros (Se o erro persistir)
Se o erro for em um campo específico no Cabeçalho (SF1) e você souber qual é, verifique o Cadastro relacionado:
| Campo Faltando (Exemplo) | Onde Verificar o Cadastro | Ação de Correção |
| F1_COND (Cond. Pagto) | Cadastro de Fornecedor (MATA020) | Preencha o campo Condição de Pagamento na aba Administrativo/Financeiro ou Vendas (conforme o tipo de nota). |
| F1_DESC (Desconto) | Cadastro e Rotina | Verifique se existe um Ponto de Entrada (ex: A103FIL) limpando o campo indevidamente. |
🔑 Resumo da Solução
O erro A100VZ no Protheus é um sinal de que você está tentando gravar uma transação sem dados obrigatórios. Na maioria dos casos de devolução de vendas, a solução está em preencher ou garantir o vínculo dos campos de Quantidade, Valor, TES e CFOP na tela de itens (MATA103).
