Linha de Produto: | Datasul |
Segmento: | Manufatura |
Módulo: | Contas a Receber |
Função: | API para determinar portador e carteira bancária de documentos da distribuição de acordo com os critérios do financeiro |
Requisito: | Criar uma API que receba informações da distribuição e determine o portador e a carteira bancária dos documentos (pedidos de venda ou notas fiscais), de acordo com regras cadastradas nos Parâmetros de Destinação de Cobrança. |
Implementação: | No programa "Parâmetros Empresa Contas a Receber" (acr008ta), foi adicionado o campo "Portad Distrib", que determinará se a empresa estará habilitada a determinar o portador de documentos da distribuição. Se este campo estiver marcado, será possível definir os demais parâmetros no programa "Manutenção Destinações de Cobrança" (acr025aa) e usar a API (acr545za). Não será possível desmarcar o campo "Portad Distrib" se houver alguma destinação de cobrança (acr025aa) com o campo "Integra Distribuição", marcado e vinculado a um estabelecimento da respectiva empresa. No programa "Manutenção Destinações de Cobrança" (acr025aa), foram adicionados os campos "Integra Distribuição", "Estabelecimento" e "Abrangência Nível Cobrança". Os novos campos somente serão apresentados se o campo "Portad Distrib" estiver marcado no programa acr008ta para a empresa do usuário. O campo "Integra Distribuição" determina que a destinação será usada exclusivamente para determinar o portador e a carteira bancária por meio da API (acr545za). Se o campo "Integra Distribuição" for marcado habilitará o campo "Estabelecimento" e o campo "Abrang Nível Cobrança", que deverão ser obrigatoriamente informados. Um estabelecimento somente poderá estar vinculado a uma destinação de cobrança na mesma faixa de datas de validade, para a mesma finalidade econômica. O campo"Abrang Nível Cobrança" poderá ter o conteúdo Empresa ou Estabelecimento que modificará o comportamento da API quando o parâmetro "Consid Sdo Carteira" estiver marcado na respectiva destinação. Não poderão ser vinculadas carteiras bancárias do tipo Vendor, Desconto ou Contas a Pagar para Destinações de Cobrança com o campo "Integra Distribuição" marcado. No programa "Gera Destinação Cobrança" (acr739ab) foi incluída uma validação para não permitir usar destinações de cobrança com o parâmetro "Integra Distribuição" marcado para destinar títulos do módulo de Contas a Receber. Estas destinações serão usadas exclusivamente pela API acr545za.Foi desenvolvida a nova API acr545za, que fará a determinação do portador e da carteira bancária dos documentos da distribuição (pedidos de venda ou notas fiscais). A API não fará nenhuma alteração no financeiro, esta simplesmente aplicará as regras de destinação de cobrança conforme conceito do produto e informará qual portador e carteira bancária deverá ser gravado ou sugerido para cada documento da distribuição. A gravação do portador e da modalidade no pedido de venda ou na nota fiscal será realizada pela implementação, que ainda será desenvolvida pela distribuição. A API terá dois métodos:1) Status do parâmetro Determina Portador Distribuição. Este método retornará se a empresa do estabelecimento informado ou a empresa padrão do usuário determinam o portador da distribuição retorno o conteúdo do campo "Portad Distrib" do programa Parâmetros Empresa Contas a Receber (acr008ta).2). Determinar Portador e Carteira dos Documentos. Neste método, a API tentará determinar o portador e a carteira bancária de cada documento (pedido de venda ou nota fiscal) enviado pela distribuição. A determinação do portador ocorrerá:
A determinação do portador e da carteira bancária seguirá os conceitos que já são utilizados no programa acr739ab (Gera Destinação Cobrança). Assim, serão respeitados os critérios de prazo de auto missão; portador preferencial do cliente; valores mínimo e máximo e prazo mínimo e máximo das parcelas, conforme parametrização no cadastro de portador banco; verificação do CEP do cliente quando o banco estiver parametrizado para tal; ordem de destinação dos portadores; critério para definição da meta de destinação (por valor ou por percentual); situação do campo destina tudo e da destinação para o portador de auto emissão quando os demais critérios não forem atendidos. Exceções:A API não tratará o envio para EDI e não permitira destinação para carteiras do tipo Desconto, Contas a Pagar e Vendor (carteiras já tratadas no programa ACR025AA quando o campo "Integra Distribuição" estiver marcado). Caso o parâmetro "Considera Saldo Carteira" esteja assinalado na destinação usada pela API, somente o saldo dos portadores e carteiras bancárias parametrizados na respectiva destinação será considerado. Este saldo será considerado conforme informações de entrada da API com o saldo por portador dos documentos ainda não integrados no Contas a Receber e conforme saldo do programa Finalidade Econômica x Portador (ufn103aa), que poderá ser do estabelecimento informado ou da empresa do estabelecimento informado, conforme parâmetro "Abrang Nível Cobrança" da respectiva destinação.Importante:Somente haverá Saldo de Cobrança no programa Finalidade Econômica x Portador (ufn103aa) se o parâmetro "Atualiza Sdo Cobr" estiver marcado no programa Parâmetros Empresa Contas a Receber (acr008ta).Se for possível determinar o portador e a carteira bancária, os mesmos serão traduzidos por o Portador e Modalidade externos de acordo com a Matriz de Tradução de Portadores parametrizada no parâmetro de integração "Faturamento 2.00". Mais detalhes da utilização da API podem ser consultados em http://tdn.totvs.com/pages/viewpage.action?pageId=223173048 |
| Requisito (ISSUE): | D_MAN_FIN002 - PCREQ-6691, PCREQ-8669 e PCREQ-8670 |
