Configuração inicial

Esta configuração deve ser feita uma única vez ao implantar o módulo no cliente. Após concluída, o sistema está pronto para operar com adiantamentos.

Pré-requisitos: SQL Fase 1 executado, EDMX atualizado, sistema compilado e funcional.

1. Cadastrar a Receita/Despesa de "Adiantamento de Clientes"

Esta RD representa o passivo de adiantamentos de clientes (vendas).

1. Menu Cadastros → Receitas e Despesas
2. Botão Novo
3. Preencher:
   • Descrição: Adiantamento de Clientes
   • Grupo: criar (ou usar) um grupo chamado Adiantamentos
   • Tipo: + (entrada/receita)
   • DRE: marcar "Não considerar no DRE" (campo idnDreNenhum)
4. Salvar

Atenção: a flag "Não considerar no DRE" é crítica. Sem ela, o adiantamento contaria como receita imediatamente quando o cliente pagasse, contrariando o modelo de passivo.

2. Cadastrar a Receita/Despesa de "Adiantamento a Fornecedores"

Mesmo procedimento do item 1, mas:

• Descrição: Adiantamento a Fornecedores
• Tipo: - (saída/despesa)
• DRE: marcar "Não considerar no DRE"

3. Criar Operação que gera adiantamento (venda)

A operação é o "switch" que diz ao sistema "este tipo de pedido gera adiantamento". Você pode ter várias operações com essa configuração (uma por canal de venda, por exemplo).

1. Menu Cadastros → Operações
2. Botão Novo (ou editar uma operação existente de venda)
3. Preencher os campos normais (descrição, CFOP, série, tipo de operação = Saída, etc.)
4. Na seção Tipos de Operação, marcar:
   • Gerar Fatura ✓
   • Gera Adiantamento ✓ (checkbox novo)
5. No campo Receita/Despesa Padrão, selecionar a RD criada no item 1 (Adiantamento de Clientes)
6. Salvar

Ao salvar, se a RD apontada não tiver "Não considerar no DRE" marcado, o sistema mostra um aviso pedindo confirmação. Recomenda-se sempre marcar — mas é apenas alerta, não bloqueio.

4. Criar Operação que gera adiantamento (compra)

Similar ao item 3, mas:

• Tipo de Operação: Entrada
• Receita/Despesa Padrão: Adiantamento a Fornecedores (do item 2)

5. (Opcional) Operador dedicado para API

Se a empresa for usar a API externa (e-commerce, integração), pode-se configurar um operador dedicado:

1. Menu Cadastros → Operadores → criar um operador API_WEB (ou nome equivalente)
2. No cadastro do Emitente, configurar o campo Operador API apontando para esse operador

Este passo é opcional e só relevante quando a API estiver em uso.

Checklist de aceitação

Após concluir a configuração, confirme:

• [ ] RD "Adiantamento de Clientes" criada com tipo "+" e "Não considerar no DRE" marcado
• [ ] RD "Adiantamento a Fornecedores" criada com tipo "-" e "Não considerar no DRE" marcado
• [ ] Pelo menos uma Operação de venda com "Gera Adiantamento" e RD Padrão apontando para a RD de clientes
• [ ] Pelo menos uma Operação de compra com "Gera Adiantamento" e RD Padrão apontando para a RD de fornecedores
• [ ] (Opcional) Operador API configurado se for integrar com plataforma externa