Passo a passo: | INTEGRAÇÃO
- Qual o Objetivo desta Integração?
No TMS Protheus são registrados os Conhecimentos de Transportes, ou CT-e’s, que são a representação legal do transporte realizado. É
- por meio deste documento, que a Empresa realiza a cobrança contra o Cliente. Esta cobrança é realizada
- por meio de uma Fatura, que pode conter um ou mais Conhecimentos dependendo da configuração de cada Cliente.
No processo de Geração de Faturas no TMS Protheus é realizada uma integração com o Contas a Receber do Datasul, para geração de Títulos que irão representar a Fatura a ser cobrada do Cliente.
- Existe
- algum pré-requisito para utilização desta Integração?
Sim, o Datasul deve estar configurado como um "Operador Logístico". Detalhes sobre esta configuração podem ser
- mensagens XML, utilizando o Conceito de Mensagem Única TOTVS.
--------------------------------------------------------------- - Pode gerar mais de um título ?
Para cada Fatura, poderão ser gerados um ou mais Títulos no Contas a Receber, dependendo da Condição de Pagamento do Cliente. - É possível saber quais são os Conhecimentos de origem ?
Juntamente com as informações da Fatura, o TMS também irá enviar ao Datasul a Lista de Conhecimentos pertencentes a ela. Esta lista, será incluída no Histórico do Título, para que seja possível consultar diretamente no financeiro. - É possível gerar o Título diferente conforme o Tipo de Conhecimento ?
Além da Chave do Conhecimento, também será enviado o Tipo dele, para que seja possível diferenciar sua origem, desta forma, podendo gerar Títulos no Contas a Receber com características diferentes, por exemplo, outra espécie. - É possível saber as informações do Título no TMS ?
Após a Geração do Título, o Datasul irá devolver as informações dele, para posterior consulta no TMS. - DOCCOB ?
Após a Geração do Título, o Datasul irá devolver as informações dele, para posterior consulta no TMS. Além disto, também serão devolvidas as informações de Cobrança (Juros, Desconto, Banco e etc...), para que seja possível gerar o DOCCOB através do TMS. - Pode Incluir, Modificar e eliminar ?
Manutenção: Indica que foi incluída ou alterada uma Fatura no TMS, portanto deve ser gerado os Títulos no Contas a Receber. Ver detalhes em: Geração de Títulos no Contas a Receber
Cancelamento: Indica que a Fatura foi cancelada no TMS, portanto os Títulos relacionada aquela Fatura devem ser Estornados no Contas a Receber. Ver detalhes em: Estorno de Títulos e Estorno de Substituição - Que estabelecimento Gera ?
O Título será criado no Estabelecimento de Débito da Fatura, caso ele não tenha sido informado, será considerado o Estabelecimento de Geração da Fatura.
Devolução das Informações Após a criação dos Títulos no Contas a Receber, o Datasul irá retornar as seguintes informações ao TMS: Informação Descrição Informações do Título Empresa, Estabelecimento, Espécie, Série, Número, Parcela, Cliente, Moeda, Valor Bruto, Valor Líquido, Saldo, Data de Emissão e Data de Vencimento Informações de Cobrança Carteira Bancária, Valor de Juros por Dia de Atraso, Data limite para Desconto, Valor de Desconto, Banco, Agência e Conta Corrente. Ver detalhes de como será a busca das informações em Devolução das Informações de Cobrança Tradução das Informações Algumas das informações enviadas na Fatura, estarão relacionadas a Cadastros que não serão replicados entre os produtos, por possuírem algum conceito, ou formato diferente. Neste caso será feito um processo de Tradução das Informações, conforme abaixo: Informação Descrição Empresa e Estabelecimento Ao receber a Mensagem de Fatura, será realizado a tradução destas informações através do conceito “de-para” do EAI. Que irá traduzir a informação do Aplicativo Externo (TMS Protheus), para o equivalente no Foundation do Datasul. Este tratamento será realizado no Adapter da Mensagem, detalhado no documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1030_ELLECE-TMSxACR-Mensagem_Recebimento_Fatura_Adapter Depois, estas informações serão novamente traduzidas do Foundation para o Financeiro do Datasul. Isto será realizado através da Matriz de Tradução Organização Externa. A matriz de Tradução utilizada, será a que estiver parametrizada no cadastro “Parâmetros de Integração Operador Logístico/Transportes” descrito no documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1045_ELLECE-CAD-Parametros_Gerais Caso a Matriz não tenha sido informada nos Parâmetros, será utilizada a matriz chamada “EMS2”. Moeda Esta informação será traduzida através da Matriz de Tradução de Finalidade Externa. A matriz de Tradução utilizada, será a que estiver parametrizada na Matriz de Tradução Organização Externa para a Empresa enviada na Fatura, conforme regras de tradução descritas acima para “Empresa”. Cliente A regra para a relação entre o Cadastro do TMS e do Datasul desta informação, está descrita no documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1045_ELLECE-CAD-Mensagem_Receb_Cliente_Fornecedor_XML_API Observação: A nova API criada para integração, estará preparada para receber também os códigos internos do Datasul para as informações descritas acima. Caso o código interno seja enviado, será considerado diretamente ele, caso contrário, será realizada a tradução das informações conforme as regras descritas acima. 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: As traduções de Empresa e Estabelecimento devem ser realizadas corretamente pelo Adapter da mensagem (ver regras em: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1030_ELLECE-TMSxACR-Mensagem_Recebimento_Fatura_Adapter);
Para todas as informações de Empresa e Estabelecimento enviadas na Fatura, deverá existir uma Tradução na Matriz de Tradução Organização Externa;
Deverá existir uma Tradução para a Moeda da Fatura, parametrizada na Matriz de Tradução de Finalidade Externa;
Deverá existir um Cliente cadastrado no Datasul relacionado o Cliente do TMS enviado na Fatura. E este Cliente deverá ter o cadastro de Cliente Financeiro criado. Geração de Títulos no Contas a ReceberSempre que for enviada uma Fatura ao Contas a Receber, será verificado se aquela Fatura já foi alguma vez integrada. Caso afirmativo, os Títulos relacionados a Fatura, serão estornados utilizando as mesmas regras do Cancelamento de Fatura (Ver detalhes em: Estorno de Títulos e Estorno de Substituição) e serão gerados novos Títulos, utilizando as novas informações da Fatura, conforme regras descritas abaixo. Caso, pelas regras de definição a chave do Título fique a mesma, será incrementada a Parcela. Os Títulos poderão ser gerados de duas formas no Contas a Receber, através 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 as informações para criação do Título (Espécie, Série, Rateio Contábil, etc...). No momento da Integração da Fatura como o Contas a Receber, será verificado se os Conhecimentos da Fatura possuem um Títulos relacionados (títulos gerados a partir da Nota Fiscal). Caso afirmativo, os Títulos de Conhecimentos serão baixado através 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. 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;
Em uma mesma Fatura, não podem existir Conhecimentos que estejam relacionados a Notas Fiscais com parametrização diferente (que atualizam ou não o Financeiro);
Para todos os Conhecimentos enviados na Fatura, deve existir uma Nota Fiscal relacionada no Módulo de Faturamento do Datasul;
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ítulosPara 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_Padrao
Seleçã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;
O Cliente ou o Grupo de Cliente, deve ter uma Condição de Pagamento parametrizada;
Se a Condição de Pagamento do Cliente possuir mais de uma parcela, o Datasul deve estar parametrizado para permitir parcelamento. Observação: Este parâmetro está disponível nos “Parâmetros de Integração Operador Logístico/Transportes”, mas inicialmente ele não estará na tela e não poderá ser alterado, sendo sempre igual a “Não”. Ele somente será disponibilizado para alteração, quando o TMS for preparado para receber mais de um Título para a mesma Fatura;
Deverá existir uma Parametrização de “Seleção de Recebimento Padrão” que retorno um Recebimento Padrão, conforme a Transação, Código de Transação, Estabelecimento e Cliente da Fatura;
Para o Motivo de Movimento parametrizado no Recebimento Padrão selecionado, deve existir um Rateio Contábil/Financeiro cadastrado;
Em uma mesma Fatura, não poderão existir Conhecimentos de Tipos diferentes que apontem para Recebimentos Padrões diferentes;
Demais validações realizadas atualmente pela API de Implantação de Títulos. Relacionamento Fatura x TítulosPara 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;
As informações de Desconto não serão consideras, pois a substituição na trata estas informações.
Para realizar a Substituição dos Títulos, será utilizada a última versão da API de Substituição de Títulos ACR902ZC. 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;
Mesmas regras da Inclusão Títulos descritas anteriormente, com exceção da validação de Rateio do Motivo de Movimento, que não é necessário;
Demais validações realizadas atualmente pela API de Substituição de Títulos. Estorno de TítulosAo 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;
Deverá ser possível estornar todos os Títulos relacionados a Fatura de uma só vez. Por exemplo, se existirem dois títulos relacionados e um deles apresentar problemas, nenhum será estornado;
Demais validações realizadas pela API de Estorno de Títulos. Estorno de SubstituiçãoCaso 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;
Demais validações realizadas pela API de Estorno de Substituição. Devolução das Informações de CobrançaApó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: - Recebimento Padrão: Cadastro que possibilita definir informações padrões para geração de um Título no Contas a Receber, tais como Espécie, Série, Portador, Carteira, Motivo de Movimento e Condição de Cobrança.
- Seleçã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 (Tipo do Conhecimento), Estabelecimento e Cliente. O cadastro poderá ser feito de forma mais genérica, por exemplo, deixando a Transação em Branco e o Código do Cliente em branco, desta forma, independente do Tipo de Conhecimento e do Cliente, será utilizado sempre o mesmo Recebimento Padrão. Ou, ser feito de forma mais especifica, por exemplo, informando um Código de Cliente, desta forma, sempre que for gerada uma Fatura para aquele cliente, será utilizado um Recebimento Padrão diferente, podendo gerar títulos com características diferente, por exemplo, com outra Espécie.
Os Títulos gerados a partir da integração, ficaram com o campo origem igual a "TMS". 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
- Se as informações de Cadastro de Empresa, Estabelecimento, Moeda e Cliente forem diferentes entre o Protheus e o Datasul, com as informações são traduzidas?
Quando o EAI do Datasul recebe uma mensagem do Protheus, realiza a tradução dos Códigos de Empresa e Estabelecimento por meio do conceito de "de-para" configurado no próprio EAI do Datasul. Neste processo, os códigos são traduzidos para a Empresa/Estabelecimento do Foundation e do Industrial. Depois disto, os códigos são traduzidos novamente, utilizando o conceito de Matriz de Tradução Organização Externa, já existente no Financeiro. A Matriz de Tradução utilizada neste processo, será a que estiver parametrizada na Rotina “Parâmetros do Operador Logístico” (CD00596). Caso a Matriz não tenha sido informada nos Parâmetros, será utilizada a matriz padrão chamada “EMS2”.
No caso da Moeda, será utilizada a Matriz de Tradução de Finalidade Externa parametrizada na Matriz de Tradução Organização Externa descrita no processo acima.
No caso do Cliente, o relacionamento do Código poderá ser feito de duas formas, utilizando Códigos Diferentes ou Códigos Únicos entre as Linhas. Detalhes sobre esta configuração, podem ser encontradas aqui: DUFN0025 - Parâmetros Gerais da Integração do Operador Logístico (ver Pergunta: "Para os Cadastros de Cliente e Fornecedor, como é realizado o Controle do Código ?").
- Nesta integração, é possível gerar mais de um Título no Contas a Receber para a mesma Fatura?
Sim, isto será determinado pela Condição de Pagamento do Cliente. Se for "a vista", será gerada apenas um Título, se for "parcelada", será gerado um Título para cada Parcela, respeitando os vencimentos.
- Depois que o Título foi gerado no Contas a Receber, é possível saber, diretamente no Financeiro, quais Conhecimentos fazer parte da Fatura?
Sim. Juntamente com as informações da Fatura, o TMS Protheus envia ao Datasul a Lista de Conhecimentos pertencentes a ela. Esta lista, é incluída no Histórico do Título.
- E no TMS Protheus, eu consigo consultar as informações dos Títulos gerados no Contas a Receber?
Sim. Após a Geração dos Títulos, o Datasul devolve as informações dele para o Protheus. Estas informações são armazenadas no Histórico da Fatura.
- No Contas a Receber, consigo diferenciar os Títulos que foram implantados diretamente daqueles que são provenientes do TMS Protheus?
Sim. Os Títulos gerados a partir desta integração, ficam com o campo origem igual a "TMS".
- Se a Fatura for alterada no TMS, para, por exemplo, inclusão de um novo Conhecimento, o que acontece com o Título no Contas a Receber?
Se a Fatura for alterada no TMS Protheus, será realizada uma nova integração com o Contas a Receber, passando as novas informações. Os Títulos vinculadas a Fatura serão estornados, e serão gerados novos Títulos com as novas informações enviadas. A chave do Título será a mesma, apenas será incrementada a parcela.
- E se a Fatura for Cancelada no TMS?
Se a Fatura for cancelada no TMS Protheus, os Títulos relacionados a ela serão Estornados. Lembrando que, serão realizadas todas a validações padrões já existes o produto relacionadas ao estorno, por exemplo, se o Título já foi Baixado, ele não poderá ser Estornado, neste caso, o Cancelamento da Fatura não será permitido.
- Que data será utilizada para Estornar os Títulos?
A Data de Estorno será 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.
- Como nesta integração os Títulos estarão no Contas a Receber Datasul, ainda será possível emitir o DOCCOB no TMS Protheus?
Sim. Após a Geração dos Títulos no Contas a Receber, o Datasul irá devolver as informações de Cobrança (Juros, Desconto, Banco e etc.) para o TMS Protheus, desta forma, será possível gerar o DOCCOB lá.
GERAÇÃO DE TÍTULOS
- Como é feita a Geração dos Títulos 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 Protheus, 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 Conhecimento serão baixados totalmente 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 por intermédio de uma inclusão normal.
Para um melhor entendimento, segue abaixo um diagrama demonstrando o processo:
 Image Added
- O que acontece se, em uma mesma Fatura existirem Conhecimentos que foram integrados com o Financeiro (por meio da Nota Fiscal) e que não foram integrados?
Não será permitido incluir a Fatura. Não podem existir, em uma mesma Fatura, Conhecimentos que estejam relacionados a Notas Fiscais com parametrização diferente (que atualizam ou não o Financeiro).
É possível gerar um Fatura com um valor diferente da soma dos Conhecimentos (para maior ou menor). Se sim, como fica os Títulos de Conhecimento após a Substituição?
Sim, é possível alterar o valor da Fatura, fazendo um acréscimo ou decréscimo em relação ao valor da soma dos Conhecimentos. Se o Título de Fatura for gerado por meio de uma Substituição, ele ficará com o valor final informado na Fatura. E será feito um ajuste proporcional nos Títulos de Conhecimento onde, se for um acréscimo, será incluído um valor de Juros, e se for decréscimo será incluído um valor de desconto. | Informações |
|---|
| Conhecimentos: - Conhecimento: 843 - Valor R$ 120,00 - Conhecimento: 844 - Valor R$ 180,00 Integração dos Conhecimentos com módulo de Faturamento Datasul: - Nota Fiscal: 843 - Valor R$ 120,00 - Nota Fiscal: 844 - Valor R$ 180,00 Integração das Notas Fiscais com o Contas a Receber: - Título de Conhecimento: 843 - Valor R$ 120,00 - Título de Conhecimento: 844 - Valor R$ 180,00 Geração da Fatura: - Fatura: 334 - Valor: R$ 400,00 - Conhecimentos da Fatura: 843 e 844 (Soma dos Conhecimentos: R$ 300,00) Integração da Fatura com o Contas a Receber: - Título de Fatura: 334 - Valor: R$ 400,00 (gerado a partir de Substituição). - Título de Conhecimento: 843 - Baixa total do Título (R$ 120,00 do saldo mais R$ 40 de Juros). - Título de Conhecimento: 844 - Baixa total do Título (R$ 180,00 do saldo mais R$ 60 de Juros). |
Como é determinado a Chave do Título (Estabelecimento, Espécie, Série, Número e Parcela) que será gerado no Contas a Receber a partir da Fatura?
O Estabelecimento do Título será o Estabelecimento de Débito da Fatura, caso ele não tenha sido informado, será considerado o Estabelecimento de Geração da Fatura.
O Número do Título terá o mesmo número da Fatura gerada no TMS Protheus.
A Parcela será um Sequencial conforme número de Parcelas da Condição de Pagamento do Cliente.
Para determinar a Espécie e a Série, serão utilizados as seguinte Rotinas:
Recebimento Padrão (bas_recebto_padr_acr): 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, Portador, Carteira, Motivo de Movimento e Condição de Cobrança e etc.
Seleção de Recebimento Padrão (bas_selec_recebto_padr): Cadastro que permite parametrizar qual Recebimento Padrão será utilizado para geração de um Título com base nas informações de Transação, Estabelecimento e Cliente. O cadastro poderá ser feito de forma mais genérica, por exemplo, deixando o Código do Cliente em branco, desta forma, independente do Cliente, será utilizado sempre o mesmo Recebimento Padrão. Ou, ser feito de forma mais especifica, por exemplo, informando um Código de Cliente, desta forma, sempre que for gerada uma Fatura para aquele cliente será utilizado um Recebimento Padrão diferente, podendo gerar títulos com características diferente, por exemplo, com outra Espécie. Para integração de Fatura, sempre será utilizada da Seleção de Recebimento Padrão, onde a "Transação" é igual a "Fatura de Transporte". | Informações |
|---|
| Recebimentos Padrões Cadastrados no Contas a Receber: - Código: X10 - Espécie: DP, Série: 1 - Código: X20 - Espécie: DM, Série: UN - Código: X30 - Espécie: DX, Série: 2 - Código: X40 - Espécie: DF, Série: UN Seleção de Recebimento Padrão Cadastrados no Contas a Receber para Transação: "Fatura de Transporte": - Estabelecimento: 10, Cliente: 0, Recebimento Padrão: X10 - Estabelecimento: 10, Cliente: 60, Recebimento Padrão: X20 - Estabelecimento: 10, Cliente: 10, Recebimento Padrão: X20 - Estabelecimento: 20, Cliente: 0, Recebimento Padrão: X30 - Estabelecimento: 20, Cliente: 10, Recebimento Padrão: X40 Geração de Faturas no TMS Protheus: - Fatura: 12040 - Estabelecimento: 10, Cliente: 50. Conhecimentos: 890 e 892 - Fatura: 12041 - Estabelecimento: 10, Cliente: 60, Conhecimentos: 910 e 920. - Fatura: 12042 - Estabelecimento: 20, Cliente: 10, Conhecimentos: 1001, 1002 e 1010. Integração das Faturas com o Contas a Receber - Ao integrar a Fatura "12040", o sistema irá procurar uma Seleção de Recebimento Padrão, onde o Estabelecimento seja o "10" e o Cliente seja o "50". Como não há cadastro com estas informações, o sistema irá procurar uma Seleção de Recebimento Padrão onde o Estabelecimento seja o "10" e o Cliente seja igual a "0" (Zero, qualquer um). Como há um cadastro com estas informações, o sistema irá utilizar o Recebimento Padrão "X10" para esta Fatura, portanto o Título no Contas a Receber será gerado com a Espécie igual a "DP" e a Série igual a "1". - Ao integrar a Fatura "12041", o sistema irá procurar uma Seleção de Recebimento Padrão, onde o Estabelecimento seja o "10" e o Cliente seja o "60". Como há um cadastro com estas informações, o sistema irá utilizar o Recebimento Padrão "X20" para esta Fatura, portanto o Título no Contas a Receber será gerado com a Espécie igual a "DM" e a Série igual a "UN". - Ao integrar a Fatura "12042", o sistema irá procurar uma Seleção de Recebimento Padrão, onde o Estabelecimento seja o "20" e o Cliente seja o "10". Como há um cadastro com estas informações, o sistema irá utilizar o Recebimento Padrão "X40" para esta Fatura, portanto o Título no Contas a Receber será gerado com a Espécie igual a "DF" e Série igual a "UN". |
- O que acontece se, no momento da Integração da Fatura, não for encontrada nenhuma Seleção de Recebimento Padrão que atenda as informações?
A integração não será permitida e a Fatura não será gerada.
No TMS Protheus os Conhecimentos estão vinculados a um "Tipo" determinado pelo usuário. É possível parametrizar o Contas a Receber para que os Títulos de Fatura sejam gerados de forma diferente conforme o Tipo dos Conhecimentos?
Sim, é possível. No momento da integração da Fatura, além da Chave do Conhecimento, o TMS também envia o Código do Tipo dele, que é utilizado na busca da Seleção do Recebimento Padrão. Para isto, ele utiliza o campo "Código da Transação". Se existir um cadastro de Seleção de Recebimento Padrão onde o Código da Transação seja igual ao Tipo de Conhecimento, será utilizada aquela Seleção para determinar o Código de Recebimento Padrão. | Informações |
|---|
| Recebimentos Padrões Cadastrados no Contas a Receber: - Código: Y10 - Espécie: DF, Série: 1 - Código: Y20 - Espécie: DH, Série: UN Seleção de Recebimento Padrão Cadastrados no Contas a Receber para Transação: "Fatura de Transporte": - Código Transação: "" (branco), Estabelecimento: 10, Cliente: 0, Recebimento Padrão: Y10 - Código Transação: 54, Estabelecimento: 10, Cliente: 60, Recebimento Padrão: Y20 Geração de Faturas no TMS Protheus: - Fatura: 410 - Estabelecimento: 10, Cliente: 60. Conhecimentos: 890 (Tipo: 50) e 892 (Tipo: 50) - Fatura: 411 - Estabelecimento: 10, Cliente: 60, Conhecimentos: 910 (Tipo: 54) e 920 (Tipo: 54). Integração das Faturas com o Contas a Receber - Ao integrar a Fatura "410", o sistema irá procurar uma Seleção de Recebimento Padrão onde o Código de Transação seja igual "50", o Estabelecimento seja igual "10" e o Cliente seja igual a "60". Como não há cadastro com estas informações, o sistema irá fazer uma nova procura onde o Código da Transação seja igual a "" (branco), o Estabelecimento seja igual a "10" e o Cliente seja igual a "60". Como não há cadastro, será feita uma nova busca onde o Código da Transação seja igual a "" (branco), o Estabelecimento seja igual a "10" e o Cliente seja igual a "0" (Zero). Como há um cadastro com estas informações, o sistema irá utilizar o Recebimento Padrão "Y10" para esta Fatura, portanto, o Título no Contas a Receber será gerado com a Espécie igual a "DF" e a Série igual a "1". - Ao integrar a Fatura "411", o sistema irá procurar uma Seleção de Recebimento Padrão onde o Código de Transação seja igual "54", o Estabelecimento seja igual "10" e o Cliente seja igual a "60". Como há um cadastro com estas informações, o sistema irá utilizar o Recebimento Padrão "Y20" para esta Fatura, portanto, o Título no Contas a Receber será gerado com a Espécie igual a "DH" e a Série igual a "UN". |
- O que acontece se, em uma mesma Fatura, existirem Conhecimentos que possuam Típos Diferentes?
Se todos os Tipos apontarem para o mesmo Recebimento Padrão, a Fatura será integrada normalmente, mas se algum deles apontar para um Recebimento Padrão diferente, a integração não será permitida e a Fatura não será gerada.
- E as demais informações do Título, por Exemplo Data de Vencimento e Rateio Contábil, como elas são determinadas?
As demais informações do Título de Fatura, são geradas conforme abaixo:
Cliente: Será o Cliente da Fatura.
Moeda: Será a Moeda da Fatura.
Data de Transação: Será a Data de Geração da Fatura. Se não for informada, será considerada a Data Atual.
Data de Emissão: Será a Data de Emissão da Fatura.
Data de Vencimento: Para a primeira Parcela, será considera a Data de Vencimento da Fatura, para as demais, será calculada 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 e Carteira: Será conforme parametrizado no Recebimento Padrão selecionado. Caso não tenham sido informados no Recebimento Padrão, serão utilizadas as informações parametrizadas no Cliente Financeiro.
Condição de Cobrança e Motivo de Movimento: Será conforme parametrizado no Recebimento Padrão selecionado.
Informações de Desconto, Juros e Multa: Será conforme parametrizado na Condição de Cobrança parametrizada no Recebimento Padrão selecionado.
Rateio Financeiro/Contábil: Será conforme parametrizado no Motivo de Movimento parametrizado no Recebimento Padrão selecionado.
Histórico: Será a lista de Conhecimentos da Fatura.
Observação: Caso o Cliente não tenha Condição de Pagamento parametrizada, será considerado a Condição de Pagamento do Grupo de Cliente.
OUTROS CONTROLES
- É possível saber, diretamente no TMS Protheus, se o Título de Fatura já foi liquidado no Contas a Receber Datasul?
Sim. Sempre que um Título de Fatura for liquidado no Contas a Receber, total ou 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 liquidação seja Estornada, um novo Status será enviado para o TMS Protheus.
- Os Títulos de Conhecimentos (gerados a partir da Nota Fiscal que foi gerada a partir do Conhecimento do TMS), poderão ser alterados no Contas a Receber?
Não. Os Títulos de Conhecimento não poderão ser alterados, cancelados, estornos ou liquidados, pois estes Títulos devem representar fielmente o que está no TMS, portanto, qualquer alteração deve ser realizada no TMS Protheus.
- E os Títulos gerados a partir das Faturas, poderão ser alterados?
Não. Os Títulos de Fatura não poderão ser alterados, cancelados ou estornados. Mas, poderão ser Liquidados normalmente, já que a liquidação deve ser feita no Contas a Receber.
- Mas, se por algum motivo, foi necessário realizar alguma alteração nos Títulos de Conhecimento e Fatura, existe alguma forma?
Sim. Se, por algum motivo, for 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 Protheus e o Contas a Receber.
- Se existir alguma inconsistência na base, onde seja necessário cancelar a Integração Manualmente no Datasul, é possível?
Sim. Existe um programa Especial que permite realizar o cancelamento Manual da integração diretamente no Datasul. É o programa "prgint\ufn\ufn809aa.r".
Para cancelar a integração de uma Fatura, basta escolher a opção "TMS x Contas a Receber" no Tipo de Integração, e "Fatura" no Tipo de Documento, e informar o Estabelecimento e Código da Fatura.
Esta rotina realiza o mesmo procedimento de um Cancelamento de Fatura onde, os Títulos relacionados serão Estornados.
Lembrando que, este programa é especial, portanto, deve ser utilizado somente em último caso. Outro detalhe é, somente os usuários que são do tipo "Super", tem permissão para executar este programa.
|
