01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Necessário implementar a  Integração do TOTVS Logística TMS  (SIGATMS) com a tecnologia PagBem. Visando permitir a geração de CIOT por período, para que um veículo utilize o mesmo CIOT em mais de uma viagem.

03. SOLUÇÃO

Implementado a nova funcionalidade para Integração do TOTVS Logística TMS  (SIGATMS) com a tecnologia PAGBEM, para a geração de CIOT por período nas viagens. 

Foram implementadas as seguintes melhorias:

• A configuração do tipo de CIOT ocorre por meio da configuração do Contrato do fornecedor. Através dos campos pré-existentes Tipo CIOT (DUJ_TPCIOT) e Prazo CIOT (DUJ_PRCIOT).
  • Tipo CIOT:
    • 1 - Por Viagem;
    • 2 - Por Período. 
  • Prazo CIOT: Define o prazo de utilização do CIOT em dias. 
• Recursos da Viagem Modelo 3: 
  
  • Tipo CIOT (DTR_TPCIOT)
    • Informação preenchida automaticamente, após informação do veículo Cod. veículo (DTR_CODVEI), com o conteúdo do campo Tipo CIOT (DUJ_TPCIOT) do contrato do fornecedor. Caso não exista o contrato do fornecedor será considerado o contrato do fornecedor genérico configurado no parâmetro MV_FORGEN. 
  • Dt. Enc. CIOT (DTR_DTFMCI)
    • Essa informação será preenchida automaticamente, após a informação do veículo (DTR_CODVEI), com o conteúdo do campo Prazo CIOT (DUJ_PRCIOT) do contrato do fornecedor somada a data atual do sistema, respeitando o prazo máximo de 30 dias (DataBase + DUJ_DTFCMI).
• Fechamento da Viagem: 
  • Consulta a tabela DJL - CIOT por período x veículo para verificar se existe CIOT em aberto para o veículo da viagem. CIOT em aberto atualiza o complemento da viagem (DTR) com o número do CIOT e integra a viagem com a PAGBEM; 
  • Novo CIOT - Cria novo CIOT com a PAGBEM e integra o contrato da Viagem, atualiza o complemento da viagem (DTR) com número do novo CIOT e cria novo registro na tabela CIOT por período x veículo (DJL) vinculado a operadora PAGBEM através do campo  Cod. Operad. (DJL_CODOPE).  
• Estorno fechamento da Viagem:  
  • Verifica se existe apenas 1 viagem no CIOT e realiza o cancelamento do CIOT por período gerado. 
• Encerra CIOT:
  • Através desta rotina é possível realizar as ações de fechamento e encerramento de CIOTs. 
    • Fechar CIOT:
      • Atualiza o campo Status CIOT (DJL_STATUS) para 2 - Fechado (não integra PAGBEM/ANTT), para que as novas viagens do veículo sejam colocadas em novo CIOT, sem impedir que se pague o saldo dos contratos do CIOT fechado.
      • Data Fechamento CIOT (DJL_DATFEC) atualiza o campo com a data de fechamento do CIOT. 
    • Encerrar CIOT:
      • Atualiza o campo Status CIOT (DJL_STATUS) para 3 - Encerrado. Ação de integração junto a PAGBEM onde o CIOT é encerrado na ANTT, todos os contratos do CIOT estão pagos (quitados) neste momento. 
      • Data Encerramento CIOT (DJL_DATENC) atualiza o campo com a data de encerramento do CIOT.  
  • Esta rotina está preparada para ser executada através de JOB Schedule. Onde serão processados os registros do CIOT por período (DJL) com status 2 - Fechado.   

04. DEMAIS INFORMAÇÕES

Procedimento para utilização:

• Possuir integração ativa entre o SIGATMS x PAGBEM;
• Pacote 009932 de dicionário Integração TMS x PAGBEM.
  
• Fontes atualizados das rotinas envolvidas, mencionadas no item 01. desta documentação.

1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato de Fornecedores (TMSA800);
2. Posicione o cursor no contrato de fornecedor desejado e clique em Alterar;
3. Selecione o Tipo de CIOT como 2 - Por Período. 
   1. Exemplo:
4. Em seguida informe o prazo do CIOT (em dias), por exemplo 30 dias. 
5. Efetue geração de viagens para o terceiro, cujo contrato indica o Tipo de CIOT como 2 - Por período. 
6. Verifique no fechamento da viagem, que o CIOT (DTR_CIOT) continuam o mesmo para todas as viagens;
7. Aponte as operações da Viagem;
8. Acesse Atualizações / Terceiros / Contrato de Carreteiro (TMSA250) realize a geração dos contratos de carreteiros e seus respectivos pagamento de saldos para quitação junto a PAGBEM. 
9. Após a quitação dos Contratos gerados com o Tipo de CIOT por período, acesse Atualizações / Terceiros / Encerra CIOT preencha os parâmetros da rotina informando a operadora 03 - PAGBEM e execute a opção "Encerra CIOT" para que seja gerado novo CIOT nas próximas viagens.
    

05. ASSUNTOS RELACIONADOS

• Pagbem Integração PagBem (Integrações - SIGATMS)