API de pagamento por encontro de contas - Cotação única por moeda
Produto: | Datasul | |||||||||||||||||||||||||||||||||||
Versões: | A partir da 12.1.12 | |||||||||||||||||||||||||||||||||||
Ocorrência: | Quando são informados itens do lote de pagamento de encontro de contas (contas a pagar e/ou contas a receber) na temp-table tt_item_integr_apb_enc_cta, cujos títulos sejam de moeda diferente do lote de pagamento e seja informada cotação diferente da cadastrada no sistema no campo tt_item_integr_apb_enc_cta.tta_val_cotac_indic_econ, poderia ocorrer o erro: 21131 - Encontro de contas não será atualizado ao atualizado. Ajuda: Valor das apropriações dos títulos do contas a receber <Valor> é diferente das apropriações dos títulos do contas a pagar <Valor>, para a transitória de encontro de contas. Ao atualizar o lote de pagamento, o sistema verifica se há diferença na transitória de encontro de contas em todas as finalidades econômicas (FE) parametrizadas para armazenarem valores nos módulos e impede sua efetivação. Exemplo: Finalidades que armazenam valores nos módulos: Real e Dólar. Lote de Encontro de Contas em Real Cotação Real/Dólar na data do lote: R$ 3,00 Itens de pagamento (contas a pagar) em Reais totalizando R$ 10.000,00 Itens de liquidação (contas a receber) em Dólares totalizando US$ 2.500,00 com cotação informada de R$ 4,00, totalizando os mesmos R$ 10.000,00. Ao atualizar o lote de pagamento é feita a consistência dos valores apropriados na conta transitória de encontro de contas nas finalidades econômicas parametrizadas para armazenarem valores nos módulos. No caso, Real e Dólar. Os valores apropriados pela transação "Pagto Encontro Contas" do contas a pagar serão: R$ 10.000,00 US$ 3.333,33 = (R$ 10.000,00 / 3,00). Lembrando que R$ 3,00 é a cotação Real/Dólar informada para a data do lote de pagamento. Os valores apropriados pela transação "Liquidação Enctro Ctas" do contas a receber serão: R$ 10.000,00 US$ 2.500,00 = (R$ 10.000,00 / 4,00). Lembrando que R$ 4,00 é a cotação Real/Dólar informada no item de liquidação do lote de pagamento. Os valores em Reais são os mesmos: R$ 10.000,00 para contas a pagar e contas a receber, não gerando diferença na conta transitória de encontro de contas. Os valores em Dólar são diferentes: US$ 3.333,33 para contas a pagar e US$ 2.500,00 para contas a receber. Se o lote de pagamento fosse atualizado seria gerada uma diferença de US$ 833,33 (US$ 3.333,33 - US$ 2.500,00) na conta transitória de encontro de contas em Dólar. Para que a diferença não ocorra, o sistema faz a consistência, emite o erro 21131 e impede a atualização do lote de pagamento. Na prática o cenário pode ser mais complexo, com mais finalidades armazenando valores nos módulos e diferentes cotações informadas no mesmo lote de pagamento. Porém, no final a validação é a mesma e evita diferenças de valores na conta transitória de encontro de contas em todas finalidades econômicas "Armazena Módulos" = Sim. | |||||||||||||||||||||||||||||||||||
Passo a passo: | Para evitar diferença na conta transitória de encontro de contas e permitir informar cotações de moeda no lote de pagamento de encontro de contas, a API APB944ZA foi evoluída conforme abaixo: A partir do release 12.1.12, se for necessário usar cotações de moeda com valor diferente do cadastrado no sistema, elas deverão ser informadas a nível de lote de encontro de contas na temp-table tt_cotac_lote_pagto e não mais diretamente nos itens do lote na temp-table tt_item_integr_apb_enc_cta . O relacionamento entre as temp-tables tt_dados_integr_apb_enc e tt_cotac_lote_pagto deve ser feito através do recid da tt_dados_integr_apb_enc, conforme abaixo: tt_dados_integr_apb_enc_ctas.ttv_rec_integr_apb_enctro_cta = RECID(tt_dados_integr_apb_enc_ctas). Será permitida uma cotação por moeda em relação à moeda do lote (Moeda do lote: Base, Moeda Informada: Índice). Exemplo: Lote na moeda Real. Campo: tt_dados_integr_apb_enc_cta.tta_cod_indic_econ Cotações informadas. Campo tt_cotac_lote_pagto.tta_val_cotac_indic_econ Dólar: R$ 3,00 (3 reais por dólar). Campo tt_cotac_lote_pagto.tta_cod_indic_econ Euro: R$ 4,00 (4 reais por euro). Campo tt_cotac_lote_pagto.tta_cod_indic_econ Assim, todos os itens de pagamento (contas a pagar) e todos os itens de liquidação (contas a receber) usarão as cotações informadas para valorizar suas apropriações contábeis. Se for necessário informar cotação diferente para uma mesma moeda, será necessário criar novo lote de pagamento por encontro de contas. Para manter a compatibilidade com versões anteriores da API, é opcional informar as cotações na nova temp-table tt_cotac_lote_pagto. Ou seja, continuará sendo possível informar a cotação diretamente no item do lote (tt_item_integr_apb_enc_ctas.tta_val_cotac_indic_econ), desde que as cotações sejam as mesmas para todos os itens do lote cujos títulos sejam de uma mesma moeda. Se forem informadas cotações diferentes para uma mesma moeda, o lote não será atualizado e será retornada mensagem orientando que as cotações sejam informadas a nível de lote de encontro de contas (temp-table tt_cotac_lote_pagto). Maiores informações sobre a API APB944ZA podem ser obtidos em APB944ZA - Pagamento via Encontro de Contas. Ao atualizar o lote de pagamento por encontro de contas as seguintes transações serão afetadas:
As transações "Pagto Encontro Contas" (APB) e "Liquidação Enctro Ctas" (ACR) utilizam a conta transitória de encontro de contas para fechamento contábil da operação. No caso apresentado como exemplo acima, os valores contabilizados na conta transitória de encontro de contas serão os seguintes:
FE = Finalidade Econômica Desta forma, não ocorrerá diferença nos valores das apropriações contábeis que envolvam a conta transitória de encontro e contas e não será apresentada a mensagem de erro 21131 descrita na seção "Ocorrência" deste documento. | |||||||||||||||||||||||||||||||||||
Observações: | Não se aplica |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas