• 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 Fornecedor

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

AdiantamentoFornecedor

Rotina do módulo Financeiro responsável por registrar o “Adiantamento a fornecedor” — um lançamento de contas a pagar que antecipa um pagamento a um participante (fornecedor) antes da vinculação a uma fatura/nota fiscal real, gerando automaticamente o(s) título(s), o(s) cheque(s) (quando aplicável) e 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 a fornecedor” — um lançamento de contas a pagar que antecipa um pagamento a um participante (fornecedor) antes da vinculação a uma fatura/nota fiscal real, gerando automaticamente o(s) título(s), o(s) cheque(s) (quando aplicável) e os lançamentos financeiros e contábeis correspondentes. É uma tela filha do grupo de menu “Transferências”. A regra de negócio é compartilhada com a rotina de Adiantamento de Cliente — ambas chamam o mesmo serviço de inclusão de título, que internamente decide se o adiantamento é de contas a pagar (Fornecedor) ou de contas a receber (Cliente) conforme o módulo informado pelo controller.

02. ENDPOINTS

Endpoints

[POST] /AdiantamentoFornecedor/Salvar

Registra um novo adiantamento a fornecedor 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 Pagar” (ListaAtualizarModulo.tcPagar) e sempre com a categoria de lançamento contábil “120” — este endpoint nunca gera adiantamento de cliente (Contas a Receber); esse é um fluxo tratado por outra rotina. Após a inclusão, o sistema retorna, em uma única resposta, os cheques gerados/vinculados, as movimentações financeiras e os lançamentos contábeis produzidos pela operação.

Permissão: “AdiantamentoFornecedor/Salvar” (ID 3005)

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 próprios e de terceiros informados, a forma de pagamento, a data de lançamento, o documento e a observação
Exemplo de request:

“` POST /AdiantamentoFornecedor/Salvar { “IDDaFilial”: “01”, “IDDaFormaDeCobranca”: 8, “DataDeLancamento”: “2026-09-09”, “Documento”: “98765”, “Observacao”: “Adiantamento pago em espécie”, “TitulosAProcessar”: [ { “IDDaCarteira”: 2, “IDDoParticipante”: 789, “Valor”: 2500.00 } ], “ChequesProprios”: [], “ChequesDeTerceiros”: [] } “`

Exemplo de response (sucesso):

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

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

[POST] /AdiantamentoFornecedor/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 de destino, caso ainda não exista lá.

Observação técnica: o caminho de destino usado internamente por esta ação é o mesmo “…/ComprovanteAdiantamento/Cliente” usado pela rotina de Adiantamento de Cliente (aparenta ser um resíduo de cópia de código entre as duas rotinas) — isso não afeta o resultado visível ao usuário, pois o arquivo-modelo copiado é o mesmo para ambas.

Permissão: “AdiantamentoFornecedor/Imprimir” (ID 3006)

Parâmetros: nenhum

Exemplo de request:

“` POST /AdiantamentoFornecedor/Imprimir “`

Exemplo de response:

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

[GET] /AdiantamentoFornecedor/ValidarInclusaoDeCheque

Verifica, para uma lista de cheques informada, quais deles já estão vinculados a outro adiantamento (e por isso não podem ser reutilizados nesta operação) e quais estão livres para uso. É usada pela tela antes de permitir que o usuário inclua um cheque de terceiro no adiantamento.

Permissão: coberta pela permissão de acesso à rotina “EditViewDeAdiantamentoFornecedor” (ID 1556) — não possui permissão granular própria.

Parâmetros:

NomeTipoObrigatórioDescrição
IDsDosChequesList<string> (query string)SimLista de IDs de cheques a validar
Exemplo de request:

“` GET /AdiantamentoFornecedor/ValidarInclusaoDeCheque?IDsDosCheques=CHQ001&IDsDosCheques=CHQ002 “`

Exemplo de response:

“`json { “success”: true, “listaChequesOK”: [“CHQ001”], “listaChequesJaVinculados”: [“CHQ002”] } “`

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 pagamento selecionada (obrigatória para o fluxo de contas a pagar)
TitulosAProcessarList[DTODeTituloAProcessar]Lista de títulos a processar — apenas o primeiro item é efetivamente utilizado pelo fluxo de adiantamento a fornecedor
ChequesPropriosList[DTODeChequesProprios]Cheques próprios (emitidos pela empresa) usados para pagar o adiantamento — determina se o sub-fluxo executado é à vista ou a prazo, conforme a data de vencimento de cada cheque
ChequesDeTerceirosList[DTODeChequesDeTerceiros]Cheques de terceiros (recebidos de outro participante e repassados como pagamento) usados para pagar o adiantamento — determina qual sub-fluxo interno é executado, ver Regras de Negócio

DTODeTituloAProcessar (campos relevantes ao fluxo de adiantamento a fornecedor)

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 (fornecedor) do adiantamento
ValordecimalValor do adiantamento
SerieDoDocumentostringSérie do documento
NumeroDoDocumentointNúmero do documento
NumeroDaParcelaintSempre forçado para 1 neste fluxo
QuantidadeDeParcelasintSempre forçado para 1 neste fluxo
DataDeVencimento / DataDeVencimentoUtilDateTimeSempre forçadas para a data atual, exceto no sub-fluxo de cheque de terceiros, onde a data é ajustada para não ficar anterior à data de movimentação configurada para o usuário (adiantamento comum não tem vencimento futuro)
IDDoTipoDeDocumentostringSe não informado, assume um tipo de documento padrão de configuração (o mesmo tipo usado para verificar se um cheque já está vinculado a outro adiantamento)
NaturezaDoTitulo, NumeroDoTituloAuxiliar, CodigoDeBarras, NossoNumerostringSempre zerados/forçados para vazio neste fluxo
ValorDaCotacaodecimalSempre forçado para 0
IDDoVendedorint?Sempre forçado para nulo
ChaveDeFatostringChave de fato do título gerado (distinta da chave de integração que amarra o conjunto da operação)

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

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 (ou a carteira informada não existir), 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 pagamento é obrigatória. Como este fluxo sempre opera em Contas a Pagar, é obrigatório informar uma forma de pagamento; 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 pagamento.” — “Código informado: [ID da forma de pagamento informada] Favor informe uma forma de pagamento”

Regra 5 — O usuário logado precisa ter um cadastro configurado. Se o usuário logado não tiver um cadastro geral associado, a operação é bloqueada.

Mensagem exibida: “O usuário logado não possui cadastro configurado e é necessário para realizar a operação.”

Regra 6 — Toda a operação ocorre dentro de uma transação única. O sistema abre uma transação antes de processar o adiantamento e só confirma ao final — se qualquer etapa falhar, nada é persistido. Uma mesma operação pode gerar múltiplos títulos, cheques e movimentações (quando há mistura de cheque próprio à vista, cheque próprio a prazo e cheque de terceiros na mesma solicitação), e tudo isso é gravado (ou revertido) como uma única unidade.

Regra 7 — Existem quatro sub-fluxos de persistência, conforme a forma de pagamento do adiantamento. Os sub-fluxos não são mutuamente exclusivos entre si (uma mesma operação pode combinar cheques próprios à vista, a prazo e de terceiros), exceto o sub-fluxo “em dinheiro”, que só ocorre quando nenhum cheque é informado.

  • Cheque próprio à vista (vencimento do cheque igual à data de movimentação): para cada cheque informado, o sistema cria dois títulos a pagar (um para o adiantamento, outro vinculado à inclusão do cheque), registra o cheque com status “Gerado” e gera duas movimentações financeiras (débito referente ao adiantamento e crédito referente à inclusão do cheque). Apenas a movimentação de débito do adiantamento é enviada para a integração contábil.
  • Cheque próprio a prazo (vencimento diferente da data de movimentação): mesmo padrão do cheque à vista (dois títulos, um cheque, duas movimentações), com uma diferença: o título de adiantamento recebe adicionalmente uma marcação de liberação/aprovação, ausente no sub-fluxo à vista. Também apenas a movimentação de débito do adiantamento é enviada para a integração contábil.
  • Cheque de terceiros (cheque recebido de outro participante e repassado como pagamento ao fornecedor): o sistema cria um único título de adiantamento vinculado ao cheque já existente, ajusta a data de vencimento do título para não ficar anterior à data de movimentação configurada para o usuário, marca o título com liberação/aprovação e gera a movimentação de débito do adiantamento. Em seguida, executa a liquidação do cheque de terceiros (a transferência de posse do cheque, que a empresa detinha, para pagamento do fornecedor) usando o fato contábil de liquidação. Este é o único sub-fluxo em que duas movimentações da mesma iteração (a do adiantamento e a da liquidação do cheque) são enviadas juntas para a integração contábil.
  • Sem nenhum cheque informado (pagamento em dinheiro/transferência bancária): o sistema cria um único título de adiantamento com marcação de liberação/aprovação, e gera duas movimentações — uma de débito ligada ao adiantamento e uma de crédito ligada ao banco (marcada como conciliada na data de lançamento). Apenas a movimentação de débito do adiantamento é enviada para a integração contábil; a movimentação bancária é persistida mas não gera lançamento contábil direto neste sub-fluxo.

Em todos os sub-fluxos, o(s) título(s) de adiantamento são criados com status “Aberto” — a baixa/compensação não ocorre dentro desta rotina (ver seção “Lógica Contábil e Financeira”).

Regra 8 — 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 9 — 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: “Operação Cancelada” — “Alguns dados podem estar incorretos” — “Verifique se os dados informados estão corretos e tente novamente”

Regra 10 — Um cheque já vinculado a outro adiantamento não pode ser reutilizado. A tela consulta, cheque a cheque, se ele já está vinculado a algum adiantamento anterior (existe alguma movimentação financeira gravada para aquele cheque com o tipo de documento padrão de adiantamento). Cheques já vinculados são sinalizados separadamente dos cheques livres para uso, e a tela deve impedir sua reutilização nesta nova operação.

Observação de escopo: este fluxo é exclusivo de Contas a Pagar (o controller sempre invoca o serviço com o módulo “tcPagar” e nunca marca a operação como “adiantamento de cliente”). O fluxo equivalente de adiantamento de cliente (Contas a Receber) existe no mesmo serviço de negócio, mas pertence a outra rotina e não faz parte desta documentação — ver comparação abaixo.

Diferenças em relação ao Adiantamento de Cliente: o fluxo de Fornecedor possui divisão entre cheque próprio à vista e a prazo (inexistente no Cliente); em compensação, o fluxo de Cliente valida se existe uma sequência de numeração ativa para a filial/documento (validação inexistente no Fornecedor). A categoria de lançamento contábil também é diferente (“120” no Fornecedor, “209” no Cliente), assim como a mensagem exibida quando a lista de títulos vem vazia.

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 a fornecedor é 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 de saída (caixa/banco ou cheque) e, ao mesmo tempo, um título a pagar em aberto que representa o valor antecipado ao fornecedor — título esse que fica “pendurado” até ser compensado, no futuro, com um título a pagar de verdade (por exemplo, oriundo de uma nota fiscal de compra).

Tabelas envolvidas

TabelaEntidade/CamadaO que é gravado
TBTITULOPAGTitulo / TituloAPagarO(s) título(s) a pagar gerado(s) pelo adiantamento (o título do adiantamento propriamente dito e, quando há cheque próprio, o título vinculado à inclusão do cheque). É gravado com status “Aberto” — permanece pendente até a compensação.
TBMOVTOFINMovimentacaoFinanceiraAs movimentações financeiras (lançamentos de débito e crédito) geradas pela operação — ligada ao(s) título(s) pela chave de fato (idIntegracao) e numerada por lançamento (numLancto).
TBMOVTOCTBMovimentacaoContabilO lançamento contábil correspondente, gerado a partir das movimentações financeiras marcadas para integração — é o reflexo, na contabilidade, de cada movimentação enviada.

Ou seja: a tabela “tbMovtoFin” corresponde à tabela TBMOVTOFIN (movimentação financeira), e “tbMovtoCtb” corresponde à tabela TBMOVTOCTB (movimentação contábil) — o mesmo padrão de gravação usado pela rotina de Adiantamento de Cliente.

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 “TPAGAD”) — usado na movimentação de débito ligada ao título de adiantamento, em todos os sub-fluxos, com uma variação diferente conforme o meio de pagamento: “Cheque à Vista”, “Cheque a Prazo”, “Cheque de Terceiros” ou “Sem Variação” (sub-fluxo em dinheiro).
  • INCLUSÃO (código “TPAGINC”) — usado na movimentação de crédito ligada à inclusão do cheque, nos sub-fluxos de cheque próprio à vista e a prazo (variação “Cheque à Vista”/”Cheque a Prazo”).
  • TRANSFERENCIA (código “BCOTRNF”, variação “Adiantamento”) — usado na movimentação de crédito ligada ao banco/caixa, no sub-fluxo sem nenhum cheque (pagamento em dinheiro) — é o lançamento que representa a saída do dinheiro do caixa/banco, marcado com a categoria de lançamento contábil “120”. Este é o único fato contábil desta rotina em que a categoria de lançamento é aplicada.
  • LIQUIDAÇÃO (código “TRECLIQ”, variação “Cheque de Terceiros”) — usado no sub-fluxo de cheque de terceiros, para registrar a transferência de posse (liquidação) do cheque de terceiro que a empresa detinha, dado como pagamento ao fornecedor.

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(s) título(s), todas as movimentações financeiras e os lançamentos contábeis entre si, e é o valor retornado à tela para reconsultar cheques, movimentações e lançamentos contábeis gerados.
  2. O(s) título(s) de adiantamento (e, quando houver cheque próprio, o título vinculado ao cheque) são criados e gravados em TBTITULOPAG com status “Aberto”.
  3. São criadas as movimentações financeiras de cada sub-fluxo executado e gravadas em TBMOVTOFIN, cada uma com a chave de fato, o número do lançamento (numLancto) e seu respectivo fato contábil.
  4. Em todos os sub-fluxos, apenas a movimentação de débito ligada ao adiantamento é enviada para a integração contábil, com exceção do sub-fluxo de cheque de terceiros, no qual a movimentação de débito do adiantamento e a movimentação de liquidação do cheque são enviadas juntas. A movimentação de crédito da inclusão do cheque (sub-fluxos à vista/a prazo) e a movimentação bancária (sub-fluxo em dinheiro) são persistidas, mas não geram lançamento contábil direto por esta via.
  5. A integração contábil (responsável por gravar em TBMOVTOCTB) recebe, ao final do processamento — em uma única chamada agregando todos os sub-fluxos executados —, 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(s), cheque(s) 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 6).

Compensação do adiantamento (baixa futura)

O título de adiantamento é gravado propositalmente com status “Aberto”: ele representa um valor pago antecipadamente ao fornecedor, mas ainda não vinculado a nenhuma nota fiscal/compra 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 Pagamento x Adiantamento a Fornecedor” (tela de Extra-Caixa > Compensações), tipicamente usada quando o fornecedor emite a nota fiscal correspondente ao adiantamento já pago.

Nessa rotina de compensação, o sistema:

  • Verifica se os títulos selecionados para compensação estão bloqueados; se estiverem, a operação é interrompida com uma mensagem informando o título e o valor bloqueado.
  • Localiza o título de adiantamento em aberto e um título a pagar real (de nota fiscal/compra) do mesmo fornecedor.
  • Usa o fato contábil LIQUIDACAO (código “TPAGLIQ”, 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 a pagar é quitado (total ou parcialmente) pelo valor do adiantamento.

A mesma tela de compensação também expõe funcionalidades auxiliares de listagem (participantes e títulos elegíveis para compensação) e um indício de suporte a compensação de devolução a fornecedor pela mesma rotina — pontos que estão fora do escopo desta documentação, focada na inclusão do adiantamento.

Em resumo: esta rotina (Adiantamento a Fornecedor) cria a “ponta de saída” da antecipação — o dinheiro que sai do caixa/banco (ou o cheque emitido/repassado) e o título em aberto —, e a rotina de Compensação cria a “ponta de entrada” — a liquidação desse título em aberto contra um título a pagar real, fechando o ciclo da antecipação.

06. PERMISSÕES

Permissões

Acesso à rotina: “EditViewDeAdiantamentoFornecedor” (ID 1556)

Atenção — nomenclatura fora do padrão: assim como no Adiantamento de Cliente, o recurso de acesso a esta tela segue o padrão “EditViewDe[NomeFeature]” em vez do padrão mais comum “ListViewDe[NomeFeature]”.
AçãoPermissãoID
Salvar“AdiantamentoFornecedor/Salvar”3005
Imprimir“AdiantamentoFornecedor/Imprimir”3006
ValidarInclusaoDeChequecoberta por “EditViewDeAdiantamentoFornecedor”—

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