Histórico da Página
...
Produto: | Datasul |
Versões: | 12.1.19 ou Superior |
Ocorrência: | Descrever a Integração do TMS Protheus x Contras a Receber Datasul |
Passo a passo: |
---------------------------------------------------------------
Validações Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, a integração de Fatura não será realizada: A Fatura deve ter no mínimo um Conhecimento;
Se a Nota Fiscal relacionada ao Conhecimento possuir uma Natureza de Operação que atualiza o Financeiro (“Emite Duplicata = Sim”), deverá existir um Título no Contas a Receber relacionado a Nota Fiscal.Inclusão de Títulos Para determinar as informações que serão utilizadas para criação do Títulos, serão utilizados os seguintes cadastros: Recebimento Padrão: Cadastro que possibilita definir informações padrões para geração de um Título nos Contas a Receber, tais como Espécie, Série, Rateios, Condição de Cobrança, etc... Detalhes do funcionamento deste cadastro estão descritos no documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1031_ELLECE-TMSxACR-Cadastro_Recebimento_PadraoSeleção de Recebimento Padrão: Cadastro que permite parametrizar qual Recebimento Padrão será utilizado para geração do Título com base nas informações de Transação, Estabelecimento e Cliente. Detalhes do funcionamento deste cadastro estão descritos no documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1032_ELLECE-TMSxACR-Selecao_Recebimento_Padrao_Cadastro
Serão verificadas as informações abaixo no Cadastro de Seleção de Recebimento Padrão, para determinar qual Recebimento Padrão será utilizado na Inclusão do Título: Informação Valor Transação Fixo: “Fatura de Transporte” Código da Transação Tipo do Conhecimento Estabelecimento Estabelecimento de Débito da Fatura Cliente Cliente da Fatura Detalhes das regras que serão utilizadas para achar o Recebimento Padrão, estão descritos no seguinte documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1033_ELLECE-TMSxACR-Selecao_Recebimento_Padrao_API Para inclusão do Título, será utilizada a última versão da API de Implantação de Títulos ACR900ZI, passando as informações conforme descrito a abaixo. Informações do Títulos Segue abaixo as informações que serão utilizadas para criação do Título no Contas a Receber: Informação Valor Empresa Empresa de Geração da Fatura conforme tradução. Estabelecimento Estabelecimento de Débito da Fatura conforme tradução. Caso o Estabelecimento de Débito não seja informado, será utilizado o Estabelecimento de Geração da Fatura conforme tradução. Origem TMS Referência Automática, baseada na data da atual. Cliente Cliente da Fatura conforme tradução. Espécie Espécie do Recebimento Padrão. Série Série do Recebimento Padrão. Nr. Documento Código da Fatura. Parcela Sequencial conforme número de Parcelas da Condição de Pagamento. Moeda Moeda da Fatura conforme tradução. Data de Transação Data de Geração da Fatura. Se não for enviada, será considerada a Data Atual. Data de Emissão Data de Emissão da Fatura. Data de Vencimento Para a primeira Parcela, será considera a Data de Vencimento da Fatura, as demais, serão calculadas conforme a Condição de Pagamento. Caso não seja informada, será calculada conforme a Condição de Pagamento a partir da Data de Emissão. Valor Será o Valor da Fatura. Caso a Condição de Pagamento possua mais de uma parcela, o valor será rateado entre as parcelas, conforme percentual parametrizado na Condição de Pagamento. Portador / Carteira Conforme Recebimento Padrão. Caso não tenham sido informados no Recebimento Padrão, serão utilizadas as informações do Cliente Financeiro. Condição de Cobrança Conforme Recebimento Padrão. Motivo de Movimento Conforme Recebimento Padrão. Informações de Desconto Conforme Condição de Cobrança. Informações de Juros Conforme Condição de Cobrança. Informações de Multa Conforme Condição de Cobrança. Rateio Financeiro/Contábil Conforme Motivo de Movimento. Histórico Será a lista de Conhecimentos da Fatura, conforme exemplo abaixo: Conhecimentos: Estab: XXXXX / Série: XXXXX / Número: XXXXXXXXX Estab: XXXXX / Série: XXXXX / Número: XXXXXXXXX Observação: Caso o Cliente não tenha Condição de Pagamento parametrizada, será considerado a Condição de Pagamento do Grupo de Cliente. Validações Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, a integração de Fatura não será realizada: Todos os Cadastros devem ser Traduzidos corretamente, conforme regras de tradução descritas anteriormente;
Para cada Título que for criado, será salvou o relacionamento dele com a Fatura em uma nova tabela chamada “fatur_acr_integr”, gravando a Chave da Fatura e a Chave do Título. Alteração na API de Implantação de Títulos (ACR900ZI) Atualmente a API de Implantação de Títulos permite que seja enviada a Condição de Cobrança, desta forma, as informações de Juros e Multa serão buscadas de lá. Mas, mesmo passando a Condição de Cobrança, ele não utiliza as informações de Desconto cadastras nela. Sendo necessário passar estas informações para a API. Em virtude disto, a API será alterada para receber um novo parâmetro indicando se deve ou não buscas as informações de Desconto da Condição de Cobrança. Se o parâmetro for igual a “Não”, considera a regra existente hoje, mas se ele for “Sim”, a Condição tenha sido informada e as informações de Desconto não tenham sido enviadas para a API, serão consideradas as informações cadastradas na Condição de Cobrança. No caso da Integração do TMS com o Contas a Receber, este parâmetro será sempre passado como “Sim”. Substituição de Títulos Títulos Origem Os Títulos Origem da Substituição serão os Títulos gerados a partir da Nota Fiscal que foi gerada a partir dos Conhecimentos relacionados a Fatura. Para cada Conhecimento da Fatura, será encontrada a Nota Fiscal equivalente, considerando a chave do Conhecimento como a mesma da Nota Fiscal (Estabelecimento - conforme regras de Tradução, Série e Número). Após encontrar a Nota Fiscal, será buscado o Título gerado a partir dela, conforme regras de relacionamento já existentes no produto. Títulos Destino Para geração dos Títulos de Destino serão utilizadas as mesmas Regras da Inclusão de Títulos descritas anteriormente, utilizando os Cadastros de Seleção e Recebimento Padrão. As informações do Título também serão atualizadas seguindo as mesmas regras da inclusão, com as seguintes diferenças: Não será considerando o Motivo de Movimento pois, para Substituição é utilizado o mesmo Rateio Financeiro/Contábil dos Títulos de Origem; Validações Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, a integração de Fatura não será realizada: Deverá ser possível encontrar os Títulos gerados a partir das Notas Fiscais geradas a partir dos Conhecimentos;
Ao cancelar uma Fatura no TMS, todos os Títulos gerados a partir dela no Contas a Receber serão estornado. Para o estorno dos Títulos, será utilizada a última versão da API de Estorno de Títulos ACR715ZB. Para encontrar os Títulos relacionados a Fatura, será verificado a tabela de Relacionamento Fatura x Títulos (fatur_acr_integr) utilizando a chave da Fatura. Se o estorno for bem sucedido, esta tabela de relacionamento será eliminada. A referência desta Transação, será gerada automaticamente baseada na data atual. Para data de Estorno, será considerado a Data de Transação do Título, caso esta Data esteja em um período já fechado na Contabilidade, será considerado a data em que está sendo realizado o Cancelamento da Fatura. Validações Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, o estorno não será realizado: Deverá ser possível encontrar os Títulos relacionados a Fatura;
Caso os Títulos tenham sido gerados a partir de uma Substituição, ela será estornada e os Títulos Origem (Títulos de Conhecimento) terão seu saldo restaurado. Para o estorno da Substituição, será utilizada a última versão da API de Estorno de Substituição ACR718ZA. Para encontrar os Títulos relacionados a Fatura e calcular a Referência e a data de Estorno, serão utilizadas as mesmas regras do Estorno de Título, descritas anteriormente. Validações Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, o estorno não será realizado: Mesmas regras realizadas no Estorno de Títulos;
Após a criação dos Títulos no Contas a Receber, além das principais informações, o Datasul também irá devolver ao TMS as informações de Cobrança, que serão encontradas conforme abaixo: Informação Descrição Carteira Bancária Carteira Bancária do Título. Valor de Juros por Dia de Atraso Percentual de Juros por Dia de Atraso do Título, multiplicado pelo Valor Original do Título. Data limite para Desconto Data de Desconto do Título. Valor de Desconto Percentual de Desconto do Título, multiplicado pelo valor Original do Título. Banco, Agência e Conta Corrente Informações Bancárias da Conta Corrente parametrizada no Cadastro de Finalidade Econômica x Portador, conforme Estabelecimento, Portador, Carteira e Finalidade Econômica do Título. OBS: Para Agência e Conta Corrente será acrescentado o dígito verificador. -------------------------------------- GERAÇÃO DO TÍTULO NO CONTAS A RECEBER Os Títulos poderão ser gerados de duas formas no Contas a Receber: por meio de uma Inclusão ou uma Substituição, isto será determinado conforme a integração dos Conhecimentos de Transporte com o Módulo de Faturamento do Datasul. Para cada Conhecimento registrado no TMS será realizada uma integração com o Módulo de Faturamento do Datasul, para geração de uma Nota Fiscal. A Natureza de Operação desta Nota Fiscal poderá estar parametrizada para gerar ou não Financeiro (Parâmetro: “Emite Duplicata”). Caso a Natureza esteja parametrizada para emitir duplicada, será gerado um Título no Contas a Receber, que irá representar o Conhecimento de Transporte. Para esta integração do Faturamento com o Contas a Receber serão utilizadas as mesmas regras já existentes hoje, no que diz respeito às informações para criação do Título (Espécie, Série, Rateio Contábil e etc.). No momento da Integração da Fatura do TMS como o Contas a Receber, será verificado se os Conhecimentos da Fatura possuem Títulos relacionados (títulos gerados a partir da Nota Fiscal). Caso afirmativo, os Títulos de Conhecimentos serão baixado por meio de uma Substituição, para geração de um novo Título que irá representar a Fatura. Caso os Conhecimentos não tenham Títulos relacionados, será gerado o Título de Fatura através de uma inclusão normal. Para determinar as informações que serão utilizadas para criação do Título de Fatura, serão utilizados dois novos cadastros:
STATUS DA FATURA Sempre que um Título de Fatura for baixado no Contas a Receber, total o parcialmente, será realizada uma integração com o TMS Protheus para indicar o seu Status (valor de saldo atual). Desta forma, será possível consultar diretamente no TMS o status da Fatura, sabendo se ela já foi totalmente paga ou não. Da mesma forma, caso a baixa seja Estornada, um novo Status será enviado para o TMS. BLOQUEIO DE TÍTULOS COM ORIGEM TMS Será realizado um controle especial para os Títulos provenitentes do TMS Protheus. Para os Títulos de Conhecimento que foram gerados a partir da Nota Fiscal que representa a CT-e, não será possível realizar alteração de valor, cancelamento, estorno ou baixa, pois o Título deve representar fielmente o que está no TMS, portanto, qualquer alteração deve partir de lá. Com relação à baixa, ela será realizada automaticamente no momento que a CT-e for faturada, conforme explicado anteriormente. Para Títulos de Fatura, segue a mesma regra com relação a alteração, estorno e cancelamento, mas no caso deste Título será possível realizar a Baixa, já que ela deve ser feita no Contas a Receber. Todas as rotinas padrões do Datasul que realizam alteração, cancelamento, estono e baixa foram alteradas para seguir as regras acima, mas existe uma exceção. Caso, por algum motivo, seja necessário realizar algum acerto manual em algum destes Títulos diretamente no Contas a Receber será permitido realizar o acerto, se o usuário logado no Datasul for do tipo "super", desta forma, as validações de bloqueio não serão feitas. Mas, este procedimento deve ser utilizado em último caso, pois poderá causar divergência de valor entre o TMS e o Contas a Receber. |
Observações: |