Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Integração TMS Protheus x Contas a Receber Datasul


Produto:

Datasul

Versões:

12.1.19 ou Superior

Ocorrência:

Descrever a Integração do TMS Protheus x Contras Contas a Receber Datasul

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. É através por meio deste documento, que a Empresa realiza a cobrança contra o Cliente. Esta cobrança é realizada através 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 encontrados aqui: DUFN0025 - Parâmetros Gerais da Integração do Operador Logístico.

  • Como as informações são trocadas entre as Linhas Protheus e Datasul?
    Para realizar a comunicação das informações entre as linhas Protheus e Datasul é utilizada a funcionalidade EAI, através por meio da troca de mensagem mensagens XML, utilizando o Conceito de Mensagem Única TOTVS.

  • 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 através 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” (cd00596CD00596). 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 gera 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, através 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 as à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 baixado baixados totalmente através 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 por intermédio de uma inclusão normal.
    Para um melhor entendimento, segue abaixo um diagrama demonstrando o processo:
    Image RemovedImage Added

  • O que acontece se, em uma mesma Fatura existirem Conhecimentos que foram integrados com o Financeiro (através 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 descrécimo em decréscimo em relação ao valor da soma dos Conhecimentos. Se o Título de Fatura for gerado através 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 o um valor de Juros, e se for descrécimo será decréscimo será incluído um valor de desconto.

    Informações
    titleExemplo

    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 mas mais R$ 40 de Juros).

    - Título de Conhecimento: 844 - Baixa total do Título (R$ 180,00 do saldo mas 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
    titleExemplo

    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, Recebimmento 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 sitema 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). Neste caso, para esta Fatura, será utilizado 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 ficará 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 sitema sistema irá utilizar o Recebimento Padrão "X20" para esta Fatura, portanto o Título no Contas a Receber ficará 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 uam 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 ficará 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
    titleExemplo

    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 sitema sistema irá fazer um 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 Estabelecimetno Estabelecimento seja igual a "10" e o Cliente seja igual a "0" (Zero). Como há um cadastro com estas informações, o sitema sistema irá uitlizar utilizar o Recebimento Padrão "Y10" para esta Fatura, portanto, o Título no Contas a Receber ficará 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 sitema sistema irá uitlizar utilizar o Recebimento Padrão "Y20" para esta Fatura, portanto, o Título no Contas a Receber ficará 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 normalmantenormalmente, 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, com 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, diretamante 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.

Observações: