• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • ERP
    • Cadastro Geral (ERP)
      • Aprovação
        • Comercial
        • Contabilidade
        • Financeira
      • Cadastro geral
      • Consultas
        • Cadastro via SEFAZ
      • Manutenção de Cadastro Geral
      • Órgão Público
        • Item
        • Órgão Público
      • Propriedade rural
      • Relatórios
        • WRCAD009 - Relatório de cadastro geral
        • WRCAD080 - Relatório de endereços
        • WRCAD081 - Relatório de referências
        • WRCAD082 - Relatório de contatos
        • WRCAD083 - Relatório de parâmetros logísticos
        • WRCAD084 - Relatório de crédito de pessoa física
        • WRCAD085 - Relatório de propriedades rurais
        • WRCAD088 - Relatório de parâmetros financeiros
        • WRCAD089 - Relatório de clientes
    • Contabilidade
      • Cadastros
        • Centro de Custo
        • Divisão Contábil
        • Histórico Padrão
        • Lançamento Contábil Padrão
        • Livros Contábeis/Fiscais
        • Notas Explicativas
        • Perfil Contábil Item
        • Plano de Conta x Centro de Custo/Controle
        • Plano de Contas
      • Conciliação
        • Razão Auxiliar - Financeiro x Contábil
      • Consultas
        • Consulta Balancete
        • Consultas DRE
        • Validação do TMV
      • Custeio
        • Apuração Custeio
        • Centro de Custo
      • Demonstrativos
        • Lista de Modelos
      • Geração Arquivos
        • Lançamentos Contábeis
        • Razão Auxiliar – Implantação de Saldo
      • Lalur-Presumido
        • Apuração do IRPJ e da CSLL
      • Movimentações
        • Contábil Extemporâneo
        • Exercício Social
        • Integridade de Saldos Contábeis
        • Lote Contábil
        • Movimentação Contábil - Contabilidade
          • Exclusão de Lançamento - Movimentação Contábil
        • Razão Auxiliar
        • Validar Plano de Contas
      • Orçamento
        • Entidades
        • Entidades/Gestores
        • Geração de Orçamento
        • Indicadores
        • Manutenção de Orçamentos
        • Pacotes
        • Pacotes/Gestores
      • Rateio
        • Critério Rateio
        • Geração Rateio off-line
        • Lista de Modelos Rateio off-line
      • Relatórios
        • Exportação para Excel
        • WRCTD001 - Razão Contábil
        • WRCTD002 - Diário Contábil
        • WRCTD003 – Balanço Patrimonial
        • WRCTD004 - Balancete de Verificação
        • WRCTD005 – Demonstração de Resultado do Exercício
        • WRCTD007 - Conferência Lote Contábil
        • WRCTD008 - Conferência Lote Contábil (Sintético)
        • WRCTD010
        • WRCTD011 - Demonstração de Resultado do Exercício (Trimestral)
        • WRCTD023 – Orçamento Contábil por Pacote de Gastos (Modelo A)
      • Sped Contábil (ECD)
        • Bloco I
          • I053 - Subcontas Correlatas
          • I157 - Transferência de Saldos de Plano de Contas Anterior
        • Bloco K
          • K100 - Empresas Consolidadas
          • K200 - Plano de Contas Consolidadas
          • K300 - Saldos das Contas Consolidadas
        • Geração de Arquivo SPED Contábil
      • Sped Fiscal (ECF)
        • Bloco M
          • M312 - Números dos Lançamentos Relacionados à Conta Contábil IRPJ
          • M315 - Processo do Lalur
          • M362 - Números dos Lançamentos Relacionados à Conta Contábil CSLL
          • M365 - Processo do Lacs
          • M415 - Processo da Parte B
        • Bloco V
          • V010 - DEREX - Instituição
          • V020 - DEREX - Responsável Movimentação
          • V100 - DEREX - Demonstrativo dos recursos em moeda estrangeira
        • Bloco X
          • X280 - Atividade Incentivada
          • X291 - Pessoa Vinculada
          • X292 - Pessoa Não Vinculada
          • X300/X305/X310 - Exportações
          • X320/X325/X330 - Importações
          • X340/X350-X357 - Part. Exterior
          • X400/X410 - Comércio Eletrônico e Tecnologia da Informação
          • X420 - Royalties Rec./Pag. a Beneficiários do Brasil e do Exterior
          • X430 - Rendimentos relativos a Serviços, Juros e Dividendos
          • X450 - Pagamentos/Remessas Relativos a Serviços, Juros e Dividendos Recebidos do Brasil e do Exterior
          • X460 - Inovação Tecnológica e Desenvolvimento Tecnológico
          • X470 - Capacitação de Informática e Inclusão Digital
          • X480/X485 - Benefícios Fiscais - Parte I/Parte II
          • X490 - Pólo Industrial de Manaus e Amazônia Ocidental
          • X500 - Zonas de Processamento de Exportação (ZPE)
          • X510 - Áreas de Livre Comércio
        • Bloco Y
          • Y570 - IR/CSLL Retidos na Fonte
          • Y580 - Doações a Camp. Eleitorais
          • Y590 - Ativos no Exterior
          • Y600 - Ident. Sócios ou Titular
          • Y611 - Rendimentos
          • Y620 - Coligadas/Controladas
          • Y630 - Fundos/Clubes de Investimentos
          • Y640/Y650 - Part. Consórcio de Empresa
          • Y660 - Dados de Sucessora
          • Y665 - Diferenças na Adoção Inicial
          • Y671 - Outra Informação (LR)
          • Y672 - Outra Informação (LP/LA)
          • Y680/Y681 - Refis de Lucros
          • Y690 - Paes
        • Contas e Saldos Iniciais da Parte B
        • Controle de Saldos das Contas do E-lalur e do E-lacs (ParteB)
        • ECF Apuração
    • Controle Patrimonial
      • Cadastros
        • Bem — Cadastro de Bens do Controle Patrimonial
        • Local do Bem — Controle Patrimonial
        • Motivo de Ocorrência
        • Ocorrência do Bem — Controle Patrimonial
        • Ocorrências em Lote — Controle Patrimonial
        • Perfil Contábil do Patrimônio — Controle Patrimonial
      • Fechamentos
        • Depreciação (Simulador) - Controle Patrimonial
        • Fechamento de CIAP
        • Fechamento de CPCAP (Pis/Cofins) — Controle Patrimonial
        • Fechamento do Controle Patrimonial
      • Manuais, Procedimentos, Orientações e Boas Práticas
        • Implantação do Controle Patrimonial
        • Roteiro de Boas Práticas - Orientação de uso rotineiro do módulo Controle Patrimonial do ERP Atak
      • Relatórios
        • WRCPM050 — Relatório de Inventário de Bens (Analítico)
        • WRCPM051
        • WRCPM052 — Extrato de Ocorrência do Bem
        • WRCPM053 — Demonstrativo de Saldo de Bens por Grupo Contábil (Analítico)
        • WRCPM054 — Relação de Ocorrências com Bens por Período
        • WRCPM055
        • WRCPM056 — Ocorrências com Bens por Período (Sintético)
        • WRCPM057 — Extrato do Bem: Recuperação de Tributos
        • WRCPM058 — Resumo Mensal: Recuperação de Tributos
        • WRCPM059 — Lista de Bens a Serem Alocados
        • WRCPM060 — Conferência das Contabilizações das Ocorrências
        • WRCPM061 — Demonstrativo de Tributos a Recuperar
        • WRCPM062 — Relatório de Bens por Centro de Custo/Controle e Conta Contábil
    • Curtume
      • Cadastro de Classificações de Couro
      • Ordem de Produção Classificação de Couros
    • DF-e
      • NFS-e
        • Importação de NFS-e
        • Monitoramento de NFS-e
        • Transmissão de NFS-e
    • Escrita Fiscal
      • Apuração por UF
        • Conferência da Sistemática
        • ICMS Sistemática (PE)
        • Livro SEFAZ
        • Ocorrências do ICMS Antecipado (PE)
      • Apurações
        • Fechamento Apuração de IPI
        • Fechamento Apuração ICMS Difal
        • Fechamento Apuração ICMS-ST - Escrita Fiscal
        • Fechamento Apuração ISS
        • Fechamento Apuração PIS/COFINS - Escrita Fiscal
        • Fechamento Apuração Tributo (Genérico)
        • Período Apuração Tributos - Escrita Fiscal
      • Cadastros
        • 5.3 - Tabela de Ajustes e Informações de Valores Provenientes de Documento Fiscal
        • Classificação Tributária de Crédito Presumido IBS/CBS
        • Classificação Tributária IBS/CBS
        • Classificação Tributária IS
        • Código de Serviço NBS
        • Código Serviço Tributação Nacional do ISSQN
        • INSS - Escrita Fiscal
        • Modelo Guia de Tributos
        • Pauta de Tributo
        • Pauta Produto — Escrita Fiscal
        • Situação Tributária
          • Situação Tributária COFINS — Escrita Fiscal
          • Situação Tributária IBS/CBS — Escrita Fiscal
          • Situação Tributária ICMS — Escrita Fiscal
          • Situação Tributária IPI — Escrita Fiscal
          • Situação Tributária IS — Escrita Fiscal
          • Situação Tributária PIS - Escrita Fiscal
        • Tabela de Códigos de Ajuste da Apuração do IPI
        • Tabela de Códigos de Ajustes da Apuração do ICMS / Tabela de Informações Adicionais da Apuração - Valores Declaratórios
        • Tabela de Informações Adicionais dos Itens do Documento Fiscal
        • Tabela de Tipos de Utilização dos Créditos Fiscais de ICMS
        • Tabelas Códigos Receitas (Federal)
      • Escrita X Contabilidade
        • Consulta de Documentos Eletrônicos - CT-e
        • Consulta de Documentos Eletrônicos - NF-e
        • Consulta de Lançamentos Fiscais
        • Contabilização de Lançamentos Fiscais
        • Contabilização de Tributos Fiscais
        • Importar Notas do XML - Escrita Fiscal
      • Eventos
        • ECONF - Conciliação Financeira - Escrita Fiscal
        • Registro de Eventos — Escrita Fiscal
      • Módulo De Inclusão De Tributos
        • Declaração do MIT
      • Movimentações
        • Inventário de Estoque Fiscal
        • Livro de Registro de Exportação
        • Livro Registro de Importação — Escrita Fiscal
        • Manutenção de Geração de Tributos nos Documentos — Escrita Fiscal
        • Movimentação de Apuração de Tributo — Escrita Fiscal
      • Tabelas/Modelos
        • Exportação para Excel - Escrita Fiscal
        • Modelo de Ajuste de Apuração
      • Tributos
        • Alíquota Referência - Município
        • Alíquota Referência - País
        • Alíquota Referência - UF
        • Assistente de Parametrização IBS/CBS/IS
        • Configurador IBS/CBS/IS
        • Tributação por Item
        • Tributação por TMV — Escrita Fiscal
    • Faturamento
      • Dashboard de Documentos Eletrônicos
      • Geração de Documento Destino
      • Impressão de Documento Auxiliar, Quantidade de Impressões por TMV e Ordem
      • Rotina de Transferência de Participante
    • Financeiro
      • Cadastro
        • Moeda
      • Caixa
        • Depósito Não Identificado
        • Despesas
        • Devolução de Cheque a Receber Segunda Vez
        • Devolução de Cheque Próprio pela Primeira Vez
        • Reapresentação de Cheque de Terceiro
        • Reapresentação de Cheque Próprio
        • Receitas
      • Cobranca
        • Alteração da Forma de Cobrança
        • Alteração de Carteira
        • Alteração de Comissão
        • Alteração de Vencimento
        • Baixa de Título da Cobrança
        • Baixa de Título da Cobrança Descontada
        • CobrancaAlteracaoDeFormaDeCobranca
        • Consulta de Remessa
        • Consulta de Títulos
        • Consulta e Liquidação via API (PIX e Boleto)
        • Consulta e Liquidação via API (PIX)
        • Desconto de Duplicatas
        • Inclusão de Decréscimo
        • Inclusão de Desconto na Cobrança
        • Inclusão de Juros
        • Inclusão de Multa
        • Liquidação Manual
        • Remessa (arquivo)
        • Retorno (arquivo)
      • Comex
        • Contrato de Câmbio
          • Contrato de Câmbio
        • Desvinculação de Contrato x Fatura
        • Desvinculação De Fatura
          • Desvinculação de fatura
        • Juros Do Contrato
          • Juros do contrato
        • Juros para Contrato de Câmbio
        • Liquidação de Contrato
          • Liquidação de contrato
        • Liquidação de Fatura
          • Liquidação de fatura
        • Liquidação De Fatura Sem Contrato
          • Liquidação de Fatura Sem Contrato
        • Relatórios
          • Wrexp021 - Faturas Vinculadas X Contrato De Câmbio
            • WREXP021 - Faturas Vinculadas X Contrato De Câmbio
        • Vinculação de Contrato x Fatura
        • Vinculação De Fatura
          • Vinculação de fatura
      • Comex - Relatórios
        • Wrexp011 - Posição Financeira Exportação
          • WREXP011 - Posição Financeira Exportação
        • Wrexp012 - Posição Contrato Câmbio X Faturas Não Vinculadas Por Carteira
          • WREXP012 - Posição Contrato Câmbio x Faturas Não Vinculadas por Carteira
        • Wrexp013 - Contratos De Cambio X Faturas Vinculadas
          • WREXP013 - Contratos de Cambio X Faturas Vinculadas
      • Compensações
        • Pagar X Adto. A Fornecedor
          • Pagar x adto. a fornecedor
        • Pagar X Devolução A Fornecedor
          • Pagar x devolução a fornecedor
        • Receber X Adto. De Cliente
          • Receber x adto. de cliente
        • Receber X Devolução Cliente
          • Receber x devolução cliente
        • Receber X Pagar
          • Receber x pagar
      • Fechamentos
        • Banco
          • Banco
        • Financeiro
          • Financeiro
      • Pagamento
        • Inclusão de Desconto no Pagamento
      • Relatorios
        • Movimentação Financeira por Carteira - Conciliado
        • Relatório de Negativação SERASA
        • WRBNC001 - Fluxo de Caixa Analítico
        • WRBNC002 - Fluxo de Caixa Sintético
        • WRBNC003 - Fluxo de Caixa Analítico por Conta de Resultado
        • WRBNC004 - Fluxo de Caixa Sintético por Conta de Resultado
        • WRBNC005 - Fechamento Diário
        • WRBNC006 - Movimentação Financeira por Carteira
        • WRBNC007 - Movimentação Financeira por Carteira (sintética)
        • WRBNC008 - Fechamento Diário Detalhado
        • WRBNC010 - Fluxo de Caixa
        • WRBNC011 - Movimentação Financeira por Carteira e Conta Contábil
        • WRBNC090 - Conferência Diária Vendas Cupom Loja
      • Renegociações
        • Com Clientes
          • Com clientes
        • Com Fornecedores
          • Com fornecedores
      • Serviços
        • 2ª Via Boleto Cliente
          • 2ª via boleto cliente
        • 2ª Via Comprovante Lançamento
          • 2ª via comprovante lançamento
        • Envio De Negativação
          • Envio de Negativação
        • Geração Pix
          • Geração PIX
        • Manutenção De Remessa
          • Manutenção de Remessa
        • Retorno De Negativação
          • Retorno de Negativação
      • Serviços / Orgão Público
        • Empenho
          • Empenho
      • Transferencias
        • Adiantamento de Cliente
        • Adiantamento de Fornecedor
        • Transferência Entre Contas
        • Transferência Entre Múltiplas Contas
    • Obrigações Acessórias Federais
    • Suprimentos
      • Cadastros
        • Compradores Família Produtos
        • Fornecedores Família Produtos
      • Compra
        • Aprovação de Orçamentos (Cotações)
        • Aprovação de Pedidos de Compra
        • Aprovação de solicitação
        • Cotações de compra
        • Gerar cotações
        • Orçamentos de Fornecedores
        • Pedido de Compra sem Cotação
        • Pré-aprovação de orçamentos
        • Solicitação de Compras
      • Consumo
        • Devolução de consumo
        • Requisição de consumo
        • Solicitação de Materiais
      • Recebimento
        • Registro de entregas
      • Relatórios
        • WRSUP001 - Lista de compradores
        • WRSUP002 - Lista de fornecedores
        • WRSUP003 - Sugestão de compra
        • WRSUP004 - Solicitação de compra
        • WRSUP005 - Cotação
        • WRSUP006 - Orçamento
        • WRSUP007 - Análise de orçamentos
        • WRSUP008 - Entregas em atraso
        • WRSUP009 - Previsão de entrega
        • WRSUP010 - Conferência de carga x lançamentos de notas de entrada
        • WRSUP011 - Acompanhamento de compra
        • WRSUP012 - Solicitação de material
        • WRSUP013 - Gastos por centro de custo/controle
        • WRSUP014 - Gastos por conta contábil
        • WRSUP015 - Gastos por centro de custo/controle conta contábil
        • WRSUP016 - Ficha de histórico de produto
        • WRSUP017 - Histórico de fornecedor
        • WRSUP018 - Sugestão de Compras
    • Tabelas Auxiliares
      • Cadastros Gerais
        • Mensagem
Nenhum resultado encontrado
Inteligência Atak / Documentação / ERP / Financeiro / Transferencias

Adiantamento de Cliente

Criado por Igor Ribeiro em 08 de setembro de 2026
•
Atualizado por Igor Ribeiro em 02 de outubro de 2026
Documentação Técnica

AdiantamentoCliente

Rotina do módulo Financeiro responsável por registrar o “Adiantamento de cliente” — um lançamento de contas a receber que antecipa valores recebidos de um participante (cliente) antes da geração/vinculação de um título formal, gerando automaticamente os lançamentos financeiros e contábeis correspondentes.

01. VISÃO GERAL

Visão Geral

Rotina do módulo Financeiro responsável por registrar o “Adiantamento de cliente” — um lançamento de contas a receber que antecipa valores recebidos de um participante (cliente) antes da geração/vinculação de um título formal, gerando automaticamente os lançamentos financeiros e contábeis correspondentes. É uma tela filha do grupo de menu “Transferências” (recurso pai 1554).

02. ENDPOINTS

Endpoints

[POST] /AdiantamentoCliente/Salvar

Registra um novo adiantamento de cliente a partir dos dados informados na tela. Internamente, delega para o serviço de inclusão de título (IServicoDeInclusaoDeTitulo), sempre com o módulo fixado em “Contas a Receber” (ListaAtualizarModulo.tcReceber) e sempre com o indicador “é adiantamento de cliente” fixado em verdadeiro — ou seja, este endpoint nunca gera adiantamento de fornecedor (Contas a Pagar); esse é um fluxo tratado por outra rotina.

Permissão: “AdiantamentoCliente/Salvar” (ID 3007)

Parâmetros:

NomeTipoObrigatórioDescrição
dtoDTOCabecalhoDeOperacoes (corpo da requisição)SimCabeçalho da operação, contendo a filial, a lista de títulos a processar (apenas o primeiro item da lista é considerado), os cheques de terceiros informados, a forma de cobrança, a data de lançamento, o documento e a observação
Exemplo de request:

“` POST /AdiantamentoCliente/Salvar { “IDDaFilial”: “01”, “IDDaFormaDeCobranca”: 12, “DataDeLancamento”: “2026-09-08”, “Documento”: “12345”, “Observacao”: “Adiantamento recebido em espécie”, “TitulosAProcessar”: [ { “IDDaCarteira”: 3, “IDDoParticipante”: 456, “Valor”: 1500.00, “ValorMoeda”: 1500.00, “IDDaMoeda”: 1 } ], “ChequesDeTerceiros”: [] } “`

Exemplo de response (sucesso):

“`json { “success”: true, “listaDeCheques”: [], “listaDeOperacoesFinanceiras”: [], “listaDeOperacoesContabeis”: [] } “`

Se dto.TitulosAProcessar vier vazio ou nulo, a ação não chama o serviço de negócio e apresenta a mensagem “Não foi possível Salvar. Alguns dados podem estar incorretos. Verifique se os dados informados estão corretos.” (ver Regras de Negócio).

[POST] /AdiantamentoCliente/Imprimir

Prepara o arquivo-modelo do comprovante de adiantamento (Crystal Reports) para impressão. Não executa nenhuma regra de negócio nem grava dados de adiantamento — apenas garante que a pasta de destino exista e copia o arquivo-modelo “ComprovanteCaixaAdiantamento.rpt” da pasta padrão para a pasta específica do cliente, caso ainda não exista lá.

Permissão: “AdiantamentoCliente/Imprimir” (ID 3008)

Parâmetros: nenhum

Exemplo de request:

“` POST /AdiantamentoCliente/Imprimir “`

Exemplo de response:

“`json { “success”: true } “`

03. MODELOS DE DADOS

Modelos de Dados

DTOCabecalhoDeOperacoes (cabeçalho enviado pela tela)

CampoTipoDescrição
IDDaFilialstringFilial informada na tela (é sobrescrita internamente pela filial logada do usuário — ver Regras de Negócio)
DataDeLancamentoDateTimeData de lançamento da operação
DocumentostringNúmero/identificação do documento informado
ObservacaostringObservação livre digitada pelo usuário
IDDaFormaDeCobrancaintForma de cobrança selecionada (obrigatória para o fluxo de contas a receber)
TitulosAProcessarList[DTODeTituloAProcessar]Lista de títulos a processar — apenas o primeiro item é efetivamente utilizado pelo fluxo de adiantamento de cliente
ChequesDeTerceirosList[DTODeChequesDeTerceiros]Cheques de terceiros usados para pagar o adiantamento (opcional — determina qual dos dois sub-fluxos internos é executado, ver Regras de Negócio)

DTODeTituloAProcessar (campos relevantes ao fluxo de adiantamento de cliente)

CampoTipoDescrição
IDDaFilialstringFilial do título (sobrescrita pela filial logada)
IDDaCarteiraintCarteira (conta bancária/caixa) usada na operação — obrigatória junto com a filial
IDDoParticipanteintParticipante (cliente) do adiantamento
ValordecimalValor do adiantamento (moeda corrente) — usado quando não há cheques de terceiros
ValorMoedadecimalValor do adiantamento na moeda informada — usado quando não há cheques de terceiros
IDDaMoedaintMoeda da operação (0 assume a moeda padrão do sistema)
SerieDoDocumentostringSérie do documento — gerada automaticamente pela sequência de numeração da filial/tipo de documento
NumeroDoDocumentointNúmero do documento — gerado automaticamente
NumeroDaParcelaintSempre forçado para 1 neste fluxo
QuantidadeDeParcelasintSempre forçado para 1 neste fluxo
DataDeVencimento / DataDeVencimentoUtilDateTimeSempre forçadas para a data atual (adiantamento não tem vencimento futuro)
IDDoTipoDeDocumentostringSe não informado, assume um tipo de documento padrão de configuração
NaturezaDoTitulo, NumeroDoTituloAuxiliar, CodigoDeBarras, NossoNumerostringSempre zerados/forçados para vazio neste fluxo
ValorDaCotacaodecimalSempre forçado para 0
IDDoVendedorint?Sempre forçado para nulo

Os demais campos de DTODeTituloAProcessar pertencem a outros fluxos (boleto, remessa bancária, negativação Serasa, tributos, PIX etc.) e não são utilizados pela rotina de Adiantamento de cliente.

04. REGRAS DE NEGÓCIO

Regras de Negócio

Regra 1 — Filial e carteira são obrigatórias. Se a filial ou a carteira não forem informadas, a operação é bloqueada.

Mensagem exibida: “Não foi possível incluir Adiantamento, Para gerar um título de adiantamento é obrigatório informar filial e carteira”

Regra 2 — Carteira deve pertencer à mesma filial do título. A carteira informada precisa pertencer à mesma filial informada para o título, a menos que a carteira seja do tipo Caixa (nesse caso a validação é dispensada).

Mensagem exibida: “Não foi possível incluir Adiantamento, A carteira informada pertence a uma filial diferente da que foi informada para o título”

Regra 3 — A filial informada na tela é substituída pela filial logada do usuário. Independentemente do que for digitado no campo de filial, o sistema sempre grava a filial do usuário logado no momento da operação.

Regra 4 — Forma de cobrança é obrigatória. Como este fluxo sempre opera em Contas a Receber, é obrigatório informar uma forma de cobrança; caso contrário a operação é bloqueada.

Mensagem exibida: “Não foi possível incluir Adiantamento” — “Para gerar um título de adiantamento é obrigatório informar uma forma de cobrança.” — “Código informado: [ID da forma de cobrança informada]. Favor informe uma forma de cobrança para operação”

Regra 5 — Toda a operação ocorre dentro de uma transação única. O sistema abre uma transação (BeginTran) antes de processar o adiantamento e só confirma (Commit/FinalizeTran) ao final — se qualquer etapa falhar, nada é persistido.

Regra 6 — Existem dois sub-fluxos de persistência, conforme o adiantamento é pago com cheque de terceiro ou não.

  • Com cheque(s) de terceiro(s) informado(s): para cada cheque, o sistema gera a numeração do documento e, por este ser um adiantamento de cliente, usa a série e o número informados pelo próprio usuário na tela para o cheque (diferente do fluxo de fornecedor, em que série/número seriam gerados automaticamente). São criados dois títulos a receber (um para o adiantamento, outro para o cheque), o registro do cheque em si, e duas movimentações financeiras (um crédito referente ao adiantamento e um débito referente à inclusão do cheque) — ambas ficam disponíveis para a integração contábil.
  • Sem cheque de terceiro (em carteira): o sistema gera a numeração do documento; se não for encontrada uma sequência de numeração ativa para a filial e o tipo de documento, a mensagem de erro abaixo é apresentada, mas o processamento continua normalmente mesmo assim (o erro não interrompe a operação).
    Mensagem exibida: “Não foi encontrada uma sequencia de numeração ativa para a filial [ID da filial] e documento [ID do tipo de documento])”

Em seguida é criado um único título a receber (usando o valor do próprio título, e não o valor de algum cheque) e duas movimentações — uma de crédito ligada ao adiantamento e uma de débito ligada ao banco — mas apenas a movimentação de crédito do adiantamento é enviada para a integração contábil (a movimentação bancária não entra na lista de integração contábil neste sub-fluxo).

Regra 7 — Falha inesperada durante a inclusão. Se ocorrer qualquer erro não tratado durante o processamento, a operação é interrompida e a mensagem abaixo é exibida, contendo o detalhe técnico do erro ocorrido:

Mensagem exibida: “[detalhe técnico do erro].” — “Falha na operação.” — “Verifique os dados e tente novamente.”

Regra 8 — Ausência de títulos a processar impede o salvamento. Se a tela enviar a requisição sem nenhum título na lista de títulos a processar, o sistema não chama a regra de negócio e apresenta a mensagem abaixo:

Mensagem exibida: “Não foi possível Salvar” — “Alguns dados podem estar incorretos” — “Verifique se os dados informados estão corretos.”

Observação de escopo: este fluxo é exclusivo de Contas a Receber (o controller sempre invoca o serviço com o módulo “tcReceber” e com o indicador de adiantamento de cliente sempre verdadeiro). O fluxo equivalente de adiantamento de fornecedor (Contas a Pagar) existe no mesmo serviço de negócio, mas pertence a outra rotina e não faz parte desta documentação.

05. LÓGICA CONTÁBIL E FINANCEIRA

Lógica Contábil e Financeira

Esta seção detalha, em nível técnico, onde e como o adiantamento de cliente é efetivamente gravado no banco de dados, e como ele é posteriormente compensado (baixado) contra um título real. O objetivo de negócio da rotina é sempre o mesmo: gerar um lançamento no caixa/banco e, ao mesmo tempo, um título a receber em aberto que representa o valor antecipado — título esse que fica “pendurado” até ser compensado, no futuro, com um título a receber de verdade (por exemplo, oriundo de uma venda ou fatura).

Tabelas envolvidas

TabelaEntidade/CamadaO que é gravado
TBTITULORECTitulo / TituloAReceberO título a receber gerado pelo adiantamento (e também o título do cheque, no sub-fluxo com cheque de terceiros). É gravado com status “Aberto” — ou seja, permanece pendente até a compensação.
TBMOVTOFINMovimentacaoFinanceiraAs movimentações financeiras (lançamentos de crédito e débito) geradas pela operação — é a tabela de “lançamento financeiro” propriamente dita, ligada ao título pela chave de fato (idIntegracao) e numerada por lançamento (numLancto).
TBMOVTOCTBMovimentacaoContabilO lançamento contábil correspondente, gerado a partir das movimentações financeiras acima pela integração contábil — é o reflexo, na contabilidade, de cada movimentação gravada em TBMOVTOFIN.

Ou seja: a tabela “tbMovtoFin” mencionada na solicitação corresponde exatamente à tabela TBMOVTOFIN (movimentação financeira), e “tbMovtoCtb” corresponde à tabela TBMOVTOCTB (movimentação contábil) — ambas confirmadas no mapeamento de dados do sistema (arquivos “MapeamentoDeMovimentacaoFinanceira.cs” e “MapeamentoDeMovimentacaoContabil.cs”).

Fato contábil utilizado

Cada movimentação financeira gravada carrega um “fato contábil” (o código que a contabilidade usa para saber qual regra de lançamento contábil aplicar). Os fatos contábeis utilizados por esta rotina são:

  • ADIANTAMENTO (código “TRECAD”, variação “Sem Variação”) — usado na movimentação de crédito ligada ao título de adiantamento, no sub-fluxo sem cheque de terceiros (o caso mais comum: “gerar lançamento no caixa e um título”).
  • TRANSFERENCIA (código “BCOTRNF”, variação “Adiantamento”) — usado na movimentação de débito ligada ao banco/caixa, no mesmo sub-fluxo sem cheque de terceiros — é o lançamento que representa a entrada do dinheiro no caixa/banco.
  • ADIANTAMENTO (código “TRECAD”, variação “Cheque de Terceiros”) e INCLUSÃO (código “TRECINC”, variação “Cheque de Terceiros”) — usados, respectivamente, na movimentação de crédito do adiantamento e na movimentação de débito da inclusão do cheque, no sub-fluxo com cheque de terceiros.

Lógica de gravação em TBMOVTOFIN e TBMOVTOCTB

  1. É gerada uma chave de fato (idIntegracao) única para a operação — essa chave amarra o título, todas as movimentações financeiras e o lançamento contábil entre si.
  2. O título de adiantamento é criado e gravado em TBTITULOREC com status “Aberto”.
  3. São criadas as movimentações financeiras (uma de crédito e uma de débito, conforme o fato contábil de cada uma — ver seção anterior) e gravadas em TBMOVTOFIN, cada uma gravada com a chave de fato, o número do lançamento (numLancto) e seu respectivo fato contábil.
  4. No sub-fluxo sem cheque de terceiros, apenas a movimentação de crédito (ligada ao adiantamento) é enviada para a integração contábil — a movimentação de débito do banco/caixa não gera lançamento em TBMOVTOCTB neste sub-fluxo. Já no sub-fluxo com cheque de terceiros, as duas movimentações (crédito do adiantamento e débito da inclusão do cheque) são enviadas para a integração contábil.
  5. A integração contábil (responsável por gravar em TBMOVTOCTB) recebe a lista de movimentações financeiras marcadas para integração e gera, para cada uma, o lançamento contábil correspondente em TBMOVTOCTB, refletindo o fato contábil de cada movimentação.
  6. Toda a sequência (título, cheque quando houver, movimentações financeiras e integração contábil) ocorre dentro de uma única transação — se qualquer etapa falhar, nada é persistido (ver Regra 5).

Compensação do adiantamento (baixa futura)

O título de adiantamento é gravado propositalmente com status “Aberto”: ele representa um valor recebido antecipadamente, mas ainda não vinculado a nenhuma venda/fatura real. A baixa (compensação) desse título não é feita por esta rotina, e sim por uma rotina irmã, específica para isso: “Compensação de Recebimento x Adiantamento de Cliente” (tela de Extra-Caixa > Compensações).

Nessa rotina de compensação, o sistema:

  • Localiza o título de adiantamento em aberto e um título a receber real (de venda/fatura) do mesmo cliente.
  • Usa o fato contábil LIQUIDAÇÃO (código “TRECLIQ”, variação “Compensação de Adiantamento”) para gerar o lançamento financeiro e contábil da baixa — ou seja, um novo registro em TBMOVTOFIN (e o respectivo reflexo em TBMOVTOCTB) que baixa o valor do adiantamento contra o título real.
  • Ao final, o título de adiantamento deixa de estar em aberto (é compensado/baixado) e o título real recebido é quitado (total ou parcialmente) pelo valor do adiantamento.

Em resumo: esta rotina (Adiantamento de Cliente) cria a “ponta de entrada” da antecipação — o dinheiro no caixa/banco e o título em aberto —, e a rotina de Compensação cria a “ponta de saída” — a liquidação desse título em aberto contra um título a receber real, fechando o ciclo da antecipação.

06. PERMISSÕES

Permissões

Acesso à rotina: “EditViewDeAdiantamentoCliente” (ID 1555, recurso pai: 1554 – Transferências)

Atenção — nomenclatura fora do padrão: diferente da maioria das telas do sistema, cujo recurso de acesso segue o padrão “ListViewDe[NomeFeature]”, esta rotina usa o nome “EditViewDeAdiantamentoCliente” para o recurso de acesso à tela.
AçãoPermissãoID
Salvar“AdiantamentoCliente/Salvar”3007
Imprimir“AdiantamentoCliente/Imprimir”3008

NA PÁGINA

  • Visão Geral
  • Endpoints
  • Modelos de Dados
  • Regras de Negócio
  • Lógica Contábil e Financeira
  • Permissões
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06