Definição da Regra de Negócio
Visão Macro do Processo
No TMS Protheus, o controle de Transporte basicamente se inicia com o registro dos Conhecimentos de Transportes, ou CT-e’s, que são a representação legal do transporte realizado. O próximo passo é a Geração de uma Viagem, onde é indicado os locais de origem e destino (rotas) e quais CT-e’s fazer parte dela. Depois, é realizada a Geração de um Contrato, onde são indicadas as Viagens e qual será o Fornecedor que irá realizar efetivamente o transporte. O Fornecedor poderá ser uma Empresa, representada por uma Pessoa Jurídica, ou um Carreteiro, um é profissional autônomo.
Quando o Fornecedor é uma Pessoa Jurídica, o TMS realizada uma integração com o Módulo de GFE Protheus, para gerenciar o Transporte. Quando é necessário realizar algum pagamento a Fornecedor, o módulo de GFE realiza uma integração com o Contas a Pagar do Datasul. Esta integração já existe hoje.
Quando o Fornecedor é uma Pessoa Física, o TMS irá realizar o gerenciamento do Transporte, e quando for necessário realizar pagamentos a Fornecedor, irá integrar diretamente com o Contas a Pagar. O tratamento desta integração será realizado através desta Story e será denominada “Integração de Documento de Transporte”.
O TMS também pode ser parametrizada para ter um Fluxo adicional, chamado de Controle de Liberação de Contrato. Desta forma, após o Geração do Contrato, é necessário realizar o processo de Liberação do Contrato, que é realizada somente depois do retorno da Viagem. Isto é feito para que os valores de Frete efetivamente sejam liberados para o Carreiro somente neste momento.
Ver detalhes do Processo em: Fluxos do Processo.
Integração de Documento de Transporte
Ao realizar a integração de um Documento de Transporte, o TMS irá enviar as seguintes informações ao Datasul:
Informação | Descrição |
Operação | Indica a ação realizada, podendo ser: Inclusão: Indica que foi incluído um Documento de Transporte no TMS, portanto deve ser gerado Títulos no Contras a Pagar. Observações: Cancelamento: Indica que o Documentos de Transporte foi cancelado no TMS, portanto os Títulos relacionados aquele Documento de Transporte, devem ser Estornados no Contas a Pagar. Ver detalhes em: Estorno de Títulos. Observação: Não será possível alterar um Documento de Transporte no TMS, portanto neste caso, o usuário terá que cancelar o Documento e criar um novo. |
Informações do Documento de Transporte | Empresa, Estabelecimento, Código do Documento, Tipo do Documento, Sub-Tipo do Documento, Fornecedor, Moeda, Data de Implantação, Data de Transação, Data de Vencimento, Estabelecimento de Débito, Valores e Histórico. Observação: O Título será criado no Estabelecimento de Débito do Documento de Transporte, caso ele não tenha sido informado, será considerado o Estabelecimento de Geração. |
Informações de Controle de Fluxo do Processo | No TMS será possível parametrizar em que momento do Fluxo do Processo os Títulos serão Gerados no Contas a Pagar. Ver detalhes em: Outros Controles da Integração. |
Lista de Conhecimentos | Informações do Conhecimento: Estabelecimento, Número, Série. Observação: Somente será enviado quando o tipo de Documento for “Viagem”. |
Lista de Viagens | Informações da Viagem: Estabelecimento e Número. Observação: Somente será enviado quando o Tipo de Documento for “Contrato de Carreteiro”. |
Lista de Impostos | Informações dos Impostos calculados. Observações: Somente será enviado quando o Tipo de Documento for “Contrato de Carreteiro” e o TMS estiver parametrizado para enviar os Impostos a partir de um Sistema Externo (exemplo: REPOM). Ver detalhes em: Cálculo dos Impostos. |
Devolução das Informações
Após a criação dos Títulos no Contas a Pagar, o Datasul irá retornar as seguintes informações ao TMS:
Informação | Descrição |
Informações do Título | Empresa, Estabelecimento, Fornecedor, Espécie, Série, Número, Parcela, Moeda, Data de Emissão, Data de Vencimento, Valor Original e Valor de Saldo. |
Informações de Impostos | Informações dos Impostos calculados: Tipo de Imposto, País do Imposto, Estado do Imposto. Percentual, Base de Cálculo e Valor. Observações: Somente será enviado quando o Tipo de Documento for “Contrato de Carreteiro” e o TMS estiver parametrizado para que o cálculo seja feito pelo Datasul. Ver detalhes em: Cálculo dos Impostos. |
Tradução das Informações
Algumas das informações enviadas no Documento de Transporte, 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 Documento de Transporte, 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-1037_ELLECE-TMSxAPB-Mensagem_Receb_Docto_Transp_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 no Documento de Transporte, conforme regras de tradução descritas acima para “Empresa”. |
Fornecedor | 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_Fornecedor_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 Documento de Transporte 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-1037_ELLECE-TMSxAPB-Mensagem_Receb_Docto_Transp_Adapter);
- Para todas as informações de Empresa e Estabelecimento enviadas no Documento de Transporte, deverá existir uma Tradução na Matriz de Tradução Organização Externa;
- Deverá existir uma Tradução para a Moeda do Documento de Transporte, parametrizada na Matriz de Tradução de Finalidade Externa;
- Deverá existir um Fornecedor cadastrado no Datasul relacionado o Fornecedor do TMS enviado no Documento de Transporte. E este Fornecedor deverá ter o cadastro de Fornecedor Financeiro criado.
Geração de Títulos no Contas a Pagar
Os Títulos que serão gerados e os seus respectivos Tipos (Normal, Antecipação, etc...) irão variar conforme o Tipo de Documento de Transporte (ver detalhes em: Tipos de Documento de Transporte), mas de forma Geral eles serão criados da mesma forma, seguindo as regras baixo.
Para determinar algumas das informações que serão utilizadas para criação dos Títulos, serão utilizados os seguintes cadastros:
Serão verificadas as informações abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual Pagamento Padrão será utilizado na Inclusão do Título:
Informação | Valor |
Transação / Código da Transação | Conforme o Tipo do Documento de Transporte. Ver detalhes em: Tipos de Documento de Transporte |
Estabelecimento | Estabelecimento de Débito do Documento de Transporte |
Fornecedor | Fornecedor do Documento de Transporte |
Detalhes das regras que serão utilizadas para achar o Pagamento Padrão, estão descritos no seguinte documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1040_ELLECE-TMSxAPB-Selecao_Pagamento_Padrao_API
Para inclusão do Título, será utilizada a última versão das API’s Implantação, conforme o seu tipo:
- Normal, Nota de Crédito e Provisão: APB900ZG
- Antecipação: APB905ZD
E será passado as informações conforme descrito a abaixo.
Informação | Valor |
Empresa | Empresa de Geração do Documento de Transporte conforme tradução. |
Estabelecimento | Estabelecimento de Débito do Documento de Transporte conforme tradução. Caso o Estabelecimento de Débito não seja informado, será utilizado o Estabelecimento de Geração do Documento de Transporte conforme tradução. |
Origem | TMS |
Referência | Automática, baseada na data da atual. |
Fornecedor | Fornecedor do Documento de Transporte conforme tradução. |
Espécie | Espécie do Pagamento Padrão. |
Série | Série do Pagamento Padrão. |
Nr. Documento | Código do Documento de Transporte. |
Parcela | Sequencial, iniciando de “1”. Será gerada uma próxima sequência da parcela, se já existir outro Título com a mesma chave (Estabelecimento, Fornecedor, Espécie, Série, Número). |
Moeda | Moeda do Documento de Transporte conforme tradução. |
Data de Transação | Data de Geração do Documento de Transporte. Se não for enviada, será considerada a Data Atual. Observação: Para Antecipação, será considerada como Data de Transação, a Data de Emissão do Documento de Transporte. |
Data de Emissão | Data de Emissão do Documento de Transporte. |
Data de Vencimento | Data de Vencimento do Documento de Transporte. Caso não seja informada, será calculada conforme a Condição de Pagamento a partir da Data de Emissão. |
Data de Previsão de Pagamento | Igual a Data de Vencimento do Título. |
Valor | Valor do Documento de Transporte. |
Portador | Conforme Pagamento Padrão. Caso não tenham sido informados no Pagamento Padrão, serão utilizadas as informações do Fornecedor Financeiro. |
Forma de Pagamento | Conforme Fornecedor Financeiro. |
Rateio Financeiro/Contábil | Conforme Pagamento Padrão. |
Histórico | Será a Descrição do Tipo de Documento de Transporte, o Código do Sub-Tipo do Documento e o Histórico enviado no Documento de Transporte. Além disto, serão incluídas informações conforme o Tipo de Documento de Transporte: Se for “Viagem” será incluída a lista de Conhecimentos pertencentes a Viagem conforme abaixo: - Estab: XXXXX / Série: XXXXX / Número: XXXXXXXXX
- Estab: XXXXX / Série: XXXXX / Número: XXXXXXXXX
Se for “Contrato de Carreteiro” será incluída a lista de Viagens pertencentes ao Contrato conforme abaixo: - Estab: XXXXX / Número: XXXXXXXXX
- Estab: XXXXX / Número: XXXXXXXXX
|
Validações
Neste processo, serão feitas as validações abaixo e se ocorrer algum dos problemas descritos, a integração de Documento de Transporte não será realizada:
- Todos os Cadastros devem ser Traduzidos corretamente, conforme regras de tradução descritas anteriormente;
- O Fornecedor deve ter uma Condição de Pagamento parametrizada;
- Deverá existir uma Parametrização de “Seleção de Pagamento Padrão” que retorno um Pagamento Padrão, conforme a Transação, Código de Transação, Estabelecimento e Fornecedor do Documento de Transporte;
- Para o Pagamento Padrão selecionado, deve existir um Rateio Contábil/Financeiro cadastrado;
- Pelo menos um dos valores do Documento de Transporte deve ter sido informado;
- Demais validações realizadas atualmente pela API de Implantação de Títulos.
Relacionamento Documento de Transporte x Títulos
Para cada Título que for criado, será salvou o relacionamento dele com ao Documento de Transporte em uma nova tabela chamada “docto_transp” (Ver detalhes em: Dicionário de Dados), gravando a Chave do Documento de Transporte e a Chave do Título.
Estorno de Títulos
Ao cancelar um Documento de Transporte no TMS, todos os Títulos gerados a partir dele no Contas a Pagar, serão estornados.
Para o estorno dos Títulos, será utilizada a última versão da API’s de Estorno, conforme seu tipo:
- Normal, Nota de Crédito e Provisão: APB768ZE
- Antecipação: APB793ZA
Para encontrar os Títulos relacionados ao Documento de Transporte, será verificado a tabela de Relacionamento Documento de Transporte x Títulos (docto_transp) utilizando a chave do Documento de Transporte. 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 do Documento de Transporte.
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 ao Documento de Transporte;
- Deverá ser possível estornar todos os Títulos relacionados ao Documento de Transporte 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.
Outros Controles nos Títulos
Os Títulos de Origem TMS, não poderão ser Alterados, Estornados ou Cancelados manualmente no Contas a Pagar.
Eles representam os Documento de Transportes que estão no TMS, portanto, qualquer ação sobre eles, deve partir de lá.
Detalhes das regras que serão utilizadas para fazer este controle, estão descritos no seguinte documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1041_ELLECE-TMSxAPB-Bloqueio_de_Titulos_APB_com_origem_TMS
Observação: Quando for realizado cálculo de impostos na integração a partir de um Título de origem TMS, serão gerados Títulos de Impostos, este títulos ficaram com a origem "APB" e poderão ser utilizados normalmente dentro do Contas a Pagar sem bloqueio.
Tipos de Documento de Transporte
Na Integração do TMS com o Contas a Pagar, poderão ser gerados diversos Tipo de Documento de Transporte e, para cada um deles, serão gerados diferentes tipos de Título conforme detalhado abaixo.
Viagem
Pedágio
Durante a geração de uma viagem no TMS, com base na Rota, será calculado o valor de Pedágio a ser Pago. Caso o TMS seja parametrizado para integrar este valor neste momento com o Financeiro, será realizada uma integração com o Contas a Pagar para geração de um Título.
Adiantamento
Durante a geração de uma viagem no TMS, poderá ser informado um valor de Adiantamento, que representa o valor antecipado para o Carreteiro antes do início da viagem. Caso o TMS seja parametrizado para integrar este valor neste momento com o Financeiro, será realizada uma integração com o Contas a Pagar para geração de um Título.
Posteriormente, na Integração do Contrato de Carreiro, este valor será utilizado para abater o Saldo do Título de Frete (Ver detalhes em: Compensação de Antecipações).
Custos de Transporte
Na Viagem será possível informar Custos de Transporte, valores que devem ser descontados do valor do frente. Quando este valor for informado, será gerado um Título no Contas a Pagar que poderá ser de dois tipos: “Antecipação” ou “Nota de Crédito”, isto será determinado pelo Tipo da Espécie parametrizada no Pagamento Padrão utilizado para criação do Título.
Posteriormente, na Integração do Contrato de Carreiro, este valor será utilizado para abater o Saldo do Título de Frete (Ver detalhes em: Compensação de Antecipações).
Taxas do Operador de Frete
Quando a Empresa utiliza um Operador de Frete, por exemplo o REPOM ou PamCard, este operador poderá cobrar Taxa extra sobre alguma operação, por exemplo Taxa sobre os Saques do Cartão realizados pelo Carreteiro. Normalmente a Empresa repassa este Custo para o Carreiro. Portanto, no processo de Geração de Viagem, poderão ser informados estes valores de Taxa, que serão repassados o Contas a Pagar realizar a geração um Título.
Reembolso
Na Viagem será possível informar um valor de Reembolso, que representa gastos adicionais realizados pelo Carreteiro, que a empresa irá reembolsa-lo. Quando este valor for informado, será gerado um Título no Contas a Pagar.
Provisão de Frente a Pagar
O TMS também poderá ser parametrizado para que, na geração da Viagem, seja gerada uma Provisão no Contas a Pagar, desta forma, antes do fechamento do Contrato o usuário já terá uma visão na Contabilidade e no Fluxo de Caixa do valor do Frete.
Observações:
- Por se tratar apenas de um provisionamento e ocorrer em momento diferente de quando o Título de Frete efetivamente será criado, não serão tratados impostos neste momento;
- A Provisão sempre será criada pelo valor líquido do Frete a Pagar, isto é, caso tenha sido informado valor de Adiantamento na Viagem, este valor será descontado do valor total do Frete;
- Depois, na integração do Contrato de Carreteiro, quando o Título de Frete for criado, esta Provisão será estornada.
Geração dos Títulos da Viagem
Com base em cada um destes valores informados na Viagem, serão verificadas as informações abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Valores da Viagem | Transação da Seleção de Pagamento Padrão | Tipo de Título Criado |
Pedágio | Pedágio | Normal |
Adiantamento | Adiantamento | Antecipação |
Custos de Transporte | Custos de Transporte | Antecipação ou Nota de Crédito |
Taxas do Operador de Frete | Taxa de Operador de Frete | Normal |
Reembolso | Reembolso | Normal |
Valor da Viagem | Provisão de Frete a Pagar | Provisão |
Geração de Viagem x Fechamento de Viagem
Os Valores da Viagem (Pedágio, Adiantamento, etc..) podem basicamente ser calculados em dois processos do TMS, na Geração da Viagem e no Fechamento da Viagem. Em cada um destes processos é realizada uma integração com o Contas a Pagar para geração dos respectivos Títulos. Tanto a Geração como o Fechamento podem ser cancelados, desta forma, somente poderão ser estornados os Títulos gerados por aquele processo. Por Exemplo, se na Geração foi integrado o valor de Adiantamento e no Fechamento o valor de Pedágio, se o Fechamento for cancelado, somente o Título referente ao Pedágio deverá ser estornado.
Para realizar estes controle, tanto na integração de inclusão, como de cancelamento, o TMS irá enviar o processo que está sendo realizado (Geração ou Fechamento) para que o Contas a Pagar faça o controle daquilo que deve ser Estornado ou não. Esta informação será enviado no Sub-Tipo do Documento conforme abaixo:
Processo | Sub-Tipo |
Geração de Viagem | 101 |
Fechamento de Viagem | 102 |
Esta informação também será utilizada na Geração do Título, no momento da busca da Seleção de Pagamento Padrão, sendo considerada como o "Código da Transação". Desta forma, caso o usuário queria diferenciar as informações do Título com base no processo da Viagem (Geração u Fechamento), será possível através da criação de Seleções de Pagamento Padrão com códigos de transação diferentes.
Contrato de Carreteiro
Pedágio, Adiantamento, Custos de Transporte e Taxas do Operador de Frete
Os valores de Pedágio, Adiantamento, Custo de Transporte, Taxas do Operador de Frete e Reembolso também poderão ser informados na Geração do Contrato de Carreteiro (caso não tenham sido informados na viagem), neste caso, estes valores também serão enviados ao Contas a Pagar para geração de Títulos.
Frete a Pagar
Na geração de Contrato, também é enviado para o Contas a Pagar o valor do Frete a Pagar, que é utilizado para geração do Título de Frete e Cálculo dos Impostos (Ver detalhes em: Cálculo dos Impostos). Mas, o TMS pode ser parametrizado para não gerar o Título de Frete neste momento, desta forma, somente são calculados os impostos. Neste caso, o Título será gerado posteriormente, na Liberação do Contrato (ver detalhes em: Outros Controles da Integração).
Caso o Título de Frete seja criado, será verificado se foram criadas Provisões a partir das Viagens vinculadas ao Contrato. Caso afirmativo, estas Provisões serão estornadas. Neste momento, também será verificado se foram criadas Antecipações a partir da Viagens (provenientes dos valores de Adiantamento e Custo de Transporte), caso afirmativo, elas serão utilizadas para abater o Saldo do Título de Frete (Ver detalhes em: Compensação de Antecipações).
Caso o Contrato seja Cancelado, as compensações serão canceladas e as Antecipações terão seu saldo restaurado. No caso das Provisões, não é possível desfazer o estorno, portanto neste caso, serão criadas novas Provisões, exatamente iguais as anteriores, mas com a parcela incrementada (+1). Estas novas Provisões, serão vinculadas as receptivas Viagens, para que possam ser estornadas posteriormente quando o novo Contrato for criada.
Geração dos Títulos do Contrato de Carreteiro
Com base em cada um destes valores informados no Contrato, serão verificadas as informações abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Valores do Contrato | Transação da Seleção de Pagamento Padrão | Tipo de Título Criado |
Pedágio | Pedágio | Normal |
Adiantamento | Adiantamento | Antecipação |
Custos de Transporte | Custos de Transporte | Antecipação ou Nota de Crédito |
Taxas do Operador de Frete | Taxa de Operador de Frete | Normal |
Reembolso | Reembolso | Normal |
Frete a Pagar | Contrato de Carreteiro | Normal |
Indenização de Transporte
No TMS é possível realizar o apontamento Ocorrências que geram despesa financeira, por exemplo uma nova diária. Este tipo de despesa é chamado de Indenização e o TMS poderá ser parametrizado para integrar com o Financeiro no momento do apontamento, neste caso, será realizada uma integração com o Contas a Pagar para geração de um Título.
Será verificada a informação abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Transação da Seleção de Pagamento Padrão | Tipo de Título Criado |
Indenização de Transporte | Normal |
Seguro de Transporte
No TMS é possível realizar o controle de Seguros relacionados a Viagem. Neste processo, é possível realizar a integração com o Financeiro para geração dos Títulos referentes aos valores a serem pagos. No momento desta integração, além do valor do seguro, o TMS também irá enviar ao Contas a Pagar a origem dele, desta forma, será possível gerar Títulos com características diferentes, por exemplo, uma outra espécie. Para isto, serão verificadas as informações abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Origem | Transação da Seleção de Pagamento Padrão | Código da Transação | Tipo de Título Criado |
Premiação | Seguro de Transporte | 401 | Normal |
RCF-DC – Cobertura contra roubo ou desaparecimento da carga | Seguro de Transporte | 402 | Normal |
RCTR-C – Cobertura contra avarias ou tombamentos do equipamento | Seguro de Transporte | 403 | Normal |
Custos de Transporte
Além de informar o Custo de Transporte na Viagem ou no Contrato, no TMS poderá ser parametrizado para enviar estes custos individualmente para o Financeiro no momento do seu registro. Neste caso, será realizada uma integração com o Contas a Pagar para geração de um Título que poderá ser de dois tipos: “Antecipação” ou “Nota de Crédito”, isto será determinado pelo Tipo da Espécie parametrizada no Pagamento Padrão utilizado para criação do Título.
Posteriormente, na Integração do Contrato de Carreiro, este valor será utilizado para abater o Saldo do Título de Frete (Ver detalhes em: Compensação de Antecipações).
Será verificada a informação abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Transação da Seleção de Pagamento Padrão | Tipo de Título Criado |
Custos de Transporte | Antecipação ou Nota de Crédito |
Contrato Complementar
Para os Contratos de Carreteiro registrado no TMS, poderão ser gerados Contratos Complementares, para registrar despesas ocorridas depois da geração do Contrato, por exemplo uma diária a mais. Para cada Contrato Complementar registrado, será realizada uma integração com o Contas a Pagar para geração de um Título. Para isto, serão verificadas as informações abaixo no Cadastro de Seleção de Pagamento Padrão, para determinar qual o Pagamento Padrão será utilizado na Inclusão do Título:
Transação da Seleção de Pagamento Padrão | Tipo de Título Criado |
Contrato Complementar | Normal |
Compensação de Antecipações
Na Integração de Contrato de Carreteiro, no momento da geração do Título de Frete, será verificado se foram geradas Antecipações a partir dos valores de Adiantamento ou Custos de Transporte informados nas Viagens vinculadas ao Contrato ou diretamente no próprio Contrato.
Caso estas Antecipações já estejam disponíveis para uso, isto é, já exista o Título de Antecipação (por exemplo, se o Portador da Antecipação for do tipo Banco, primeiramente ela precisa ser paga para que o Título seja criado), elas serão utilizadas para abater o Saldo do Título de Frente já na sua implantação. Caso a Antecipação não esteja disponível neste momento, será necessário realizar o vínculo manualmente na baixa do Título de Frente.
Caso o Custo de Transporte tenha sido parametrizado para gerar um Título do Tipo Nota de Crédito, já na sua implantação, ele será baixado para criação de uma Antecipação no mesmo valor. Desta fora, podendo ser utilizada conforme descrito acima.
Cálculo dos Impostos
O TMS poderá ser parametrizado para indicar onde será realizado o Cálculo dos Impostos, podendo ser:
- Em um Sistema Externo, por exemplo REPOM ou PamCard;
- Ou no Datasul, através do Contas a Pagar.
Cálculo dos Impostos através de Sistema Externo
Quando o TMS for parametrizado para que os Impostos sejam calculados por um Sistema Externo, eles serão enviados ao Datasul no momento da Integração com o Contas a Pagar. Desta forma, o Datasul não irá calcular os impostos e irá assumir o que foi enviado na integração. Detalhes das regras para recepção e tratamento dos impostos recebidos, estão descritos no seguinte documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1048_ELLECE-REPOMxAPB-Tratativa_dos_Impostos_do_Contrato
Cálculo dos Impostos através do Contas a Pagar
Quando o TMS for parametrizado para que os Impostos sejam calculados pelo Datasul, o Contas a Pagar irá calcular os Impostos respeitando todas as regras já existentes atualmente no módulo, considerando as regras complementares descritas abaixo:
Regra para Cálculo dos Impostos
Os impostos somente serão calculados se:
- O Pagamento Padrão selecionado para geração do Título, estiver parametrizado para calcular impostos (ver detalhes em: Pagamento Padrão - Parametrização Calculo de Impostos);
- Se a Base de Cálculo de Imposto enviada pelo TMS for maior que Zero;
- Se os impostos estiverem vinculados ao Fornecedor Financeiro.
Impostos Considerados
Serão considerados para cálculo, todos os Impostos obrigatórios que estiverem vinculados ao Fornecedor Financeiro e que estejam parametrizados para cálculo na implantação.
Base de Cálculo
No momento da integração, o TMS irá enviar ao Contas a Pagar a Base para Cálculo dos impostos. A princípio, ela será igual ao valor do Contrato, mas poderá ser reduzida conforme parametrizado no TMS. Por exemplo, quando o valor do Pedágio estiver embutido no valor do Contrato, neste caso, a base irá desconsiderar o valor do Pedágio.
A partir desta Base, serão realizadas as demais reduções necessárias, conforme cada tipo de impostos, respeitando redução parametrizada no Fornecedor Financeiro. Por exemplo, para o IRRF do Carreteiro é considerar apenas 40% do valor do Frete.
INSS já Retido por Outras Empresas
No TMS, será possível informar o valor de INSS já retido por outras Empresas para o Fornecedor.
No momento da integração do Contrato, esta informação será enviada ao Contas a Pagar para considerar no cálculo de INSS.
O valor será atualizado automaticamente no Cadastro de Retenções em Outras Empresas, considerando a Data de Emissão do Contrato. Mas, conforme regra já existe, ele somente será considerado para aqueles Fornecedores que controlam valor Limite Máximo de Retenção.
Caso o Contrato seja cancelado, os valores cadastrados automaticamente também serão cancelados.
Cálculo do ISS
O ISS somente deve ser calculado para rotas municipais. Como o controle da Rota é realizado no TMS, ele irá determinar se o imposto deve ser calculado ou não. Além disto, como a alíquota do imposto pode ser diferente de uma Cidade para outra e o Datasul não controla impostos por Cidade, a inteligência para definir a alíquota também ficar no TMS.
Portanto, no momento da integração do Contrato, caso o imposto de ISS deva ser calculado, o TMS irá enviar ao Contas a Pagar a alíquota do imposto, que será considerada para o cálculo. Mas, de qualquer forma, o imposto somente será calculado se ele estiver vinculado como obrigatório no Fornecedor Financeiro do Contrato.
API de Cálculo de Imposto
Para realizar o cálculo dos Impostos, será utilizada a API APB719ZA já existente no Datasul. Mas, atualmente esta API sempre realiza o cálculo de todos os impostos, independente se ele ocorre na Implantação ou Pagamento.
Portanto, será realizada uma evolução nesta API, para receber um novo parâmetro indicando que impostos devem ser calculados: Somente os da Implantação, Somente os do Pagamento, ou todos.
Desta forma, sempre que utilizarmos esta API na integração, iremos passar a opção para calcular somente os impostos da Implantação.
Pagamento Padrão - Parametrização Calculo de Impostos
Será incluído um novo parâmetro no Pagamento Padrão, para indicar se os impostos deverão ou não ser calculados. Desta forma, quando o Contas a Pagar receber o Documento de Transporte e buscar o Pagamento Padrão para Geração do Título (ver detalhes em: Geração de Títulos no Contas a Pagar), será verifica este novo parâmetro, se ele estiver desmarcado, os impostos não serão calculados.
Ele será incluído no programa de cadastro (base, incluir, alterar e detalhe), dentro do agrupador "Outros", com o label "Calcula Imposto" e somente estará disponível se:
- A função do projeto (“TMS Transportador”) estiver habilitada;
- A Espécie informada for do tipo “Normal”.
Outros Controles da Integração
No TMS é possível realizar parametrizações para indicar em que momento será realizada a integração com o Contas a Pagar para alguns dos Documentos de Transportes. Além disto, existem outros controles relacionados ao Contrato de Carreiro. Para que estas parametrizações reflitam na Contas a Pagar, algumas delas serão repassadas no momento da integração. Abaixo segue o detalhamento.
Preview do Frete a Pagar
No TMS é possível realizar um Preview de Contrato, isto é, realizar apenas uma simulação, para ter uma previsão do valor do Frete a Pagar. Neste cenário, no momento da integração do Contrato, o Contas a Pagar irá realizar todos os cálculos, inclusive dos impostos (Ver detalhes em: Cálculo dos Impostos), mas não irá criar efetivamente os Títulos.
Geração do Título de Frete
Quando o TMS estiver parametrizado para realizar o Controle de Liberação de Contrato (ver detalhes em: Visão Macro do Processo), também poderá ser parametrizado para indicar quando o Título de Frete deve ser criado: na Geração ou na Liberação do Contrato.
Considerando o cenário onde a criação do Título será realizada na Liberação, no momento da integração da Geração do Contrato, o Contas a Pagar irá realizar todos os cálculos, inclusive dos impostos (Ver detalhes em: Cálculo dos Impostos), mas somente irá fazer a geração dos demais Títulos: Adiantamento, Pedágio, etc.... O Título referente ao valor do Frete e dos Impostos, não serão criados neste momento.
Desta forma, na Liberação do Contrato, será realizada uma nova integração com o Contas a Pagar, para geração dos Títulos de Frente e dos Impostos. Neste momento, os impostos serão recalculados, pois pode haver mudança de período ou acumulo de imposto referente a outras implantações.
Bloqueio de Pagamento do Frete
Quando o TMS estiver parametrizado para realizar o Controle de Liberação de Contrato (ver detalhes em: Visão Macro do Processo), e parametrizado para que a criação do Título de Frete seja na Geração do Contrato (ver detalhes em: Geração do Título de Frete), também poderá ser parametrizado para indicar que o Título de Frete seja criado com Bloqueado para Pagamento.
Considerando este cenário, no momento da integração da Geração do Contrato, o Contas a Pagar irá criar todos os Títulos, conforme os valores informados, e inclusive de impostos (Ver detalhes em: Cálculo dos Impostos), mas o Título referente ao valor do Frete, estará com o Status de “Bloqueado para Pagamento”, desta forma, não será possível realizar a Baixa deste Título.
Depois, na Liberação do Contrato, será realizada uma nova integração com o Contas a Pagar, para alterar o Status de Título e liberá-lo para pagamento, desta forma, ele poderá ser pago normalmente pelas rotinas já existentes no produto.
Detalhes das regras que serão utilizadas para fazer este controle, estão descritos no seguinte documento:
http://tdn.totvs.com/display/LDT/ER_MANFIN01-1050_ELLECE-REPOMxAPB-Bloqueio_Baixa_de_Titulos_com_REPOM
Requisito de Suportabilidade
Visando o auxílio ao suporte do Produto, será alterado o programa Extrator de Títulos do Contas a Pagar (UFN717AA) para, quando o Título for de origem TMS, seja exportada juntamente com as informações dos Títulos, a nova tabela de relacionamento com os Documentos de Transporte (docto_transp - ver detalhes em: Dicionário de Dados).