Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
CIOT POR PERÍODO - PAMCARD

Pamcard - CIOT Por Período

Características do Requisito

 Informe o requisito relacionado (Issue).

Linha de Produto:

Microsiga Protheus

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

Integração via webservice WebService SIGATMS X PAMCARD

TMSPAMCARD.PRW

Rotina(s) envolvida(s)

Nome Técnico

Fechamento de Viagem

TMSA310.PRW

Complemento de Viagem

TMSA240.PRW
Contrato CarreteiroTMSA250.PRW
Encerramento de CIOTTMSA256.PRW

Cadastros Iniciais:

O módulo Gestão de Transportes (SIGATMS) já integrado com a Operadora Pamcard.

Tickets relacionados

Requisito/Story/Issue (informe o requisito relacionado):

DLOGTMS03-332

País(es):

Brasil

Banco(s) de Dados:

Todos homologados

Tabelas Utilizadas:

DJL - Ciot x Veículos

DTR - Veiculos Veículos da Viagem

DUJ - Contrato de Fornecedores

Sistema(s) Operacional(is):

Todos


Descrição

Permitir a geração de CIOT por período, para que o mesmo um veículo utilize o mesmo CIOT em mais de uma viagem.

Contrato do Fornecedor

Foram criados

novos

os seguintes campos:

    • Tipo CIOT (DUJ_TPCIOT):
  • Informa
    •  Informa que o CIOT será gerado por Por Viagem ou Por Periodo
  • .
    • (multiplas viagens).
    • Prazo CIOT (DUJ_PRCIOT): Define o prazo de utilização do CIOT.

Complemento de Viagem

Foram criados

novos

os seguintes campos:

    • Tipo CIOT (DTR_TPCIOT
  • -
    • ):
      Informação será preenchida automaticamente,
  • apos
    • após informação do
  • veículo
    • veículo campo Cod.Veiculo (DTR_CODVEI), com o conteúdo do campo Tipo CIOT (DUJ_TPCIOT)
  •   do
    •  do Contrato do Fornecedor.

  • Caso
    •  Caso não exista o Contrato do Fornecedor
  • ,
    • será considerado o Contrato do Fornecedor
  • Generico
    • Genérico (MV_FORGEN).
    • Dt.Enc. CIOT (DTR_DTFMCI
  • , -Informação
    • ):
      Essa informação será preenchida automaticamente,
  • apos
    • após a informação do veículo, campo Cod.Veiculo (DTR_CODVEI), com o conteúdo do campo Prazo
  • CIOT 
    • CIOT (DUJ_PRCIOT)
  •   do Contrato
    •  do Contrato do Fornecedor somada a Data Atual do
  • Sistema  
    • Sistema (respeitando prazo máximo de 30 dias).
      Ddatabase + DUJ_DTFCMI.

Fechamento da Viagem

Ao realizar o fechamento da viagem

e a viagem

, se esta for integrada com

Pamcard

a Pamcard (Tipo CIOT (DTR_TPCIOT == ‘2’))

,

é gerado um novo CIOT ou reutilizado

um CIOT

o já existente para o

veiculo

veículo.

 

Após o retorno da Pamcard

,

é

efetuado

efetuada a gravação da tabela DJL, com as informações do CIOT e

Veículo

veículo.

Contrato de Carreteiro - Quebra do

contrato por período. Na

Contrato Por Período

Na geração do

contrato

Contrato de

carreteiro

Carreteiro por período, o CIOT fará composição da quebra por veículo. Deste modo, caso o terceiro tenha realizado uma viagem sem integração com a operadora (e, portanto, sem CIOT), esta viagem terá um

contrato

Contrato de

carreteiro

Carreteiro (DTY) com número diferente daquelas que tiveram o CIOT.

Pagamento de Saldo

-  Preparar método que faz o encerramento do CIOT junto a Pamcard.

Ao

fazer

realizar o pagamento de saldo ou liberação do Contrato do

contrato de carreteiro, é enviando através do método UpdateValuesFreightContract

Carreteiro, a liberação para pagamento da parcela.é enviada por meio do método UpdateValuesFreightContract.

Será solicitada a baixa do CIOT e

apos

após o retorno do método informado que os CIOTs foram encerrados,

será atualizado o

serão atualizados os status dos CIOTs encerrados, campo Status CIOT (DJL_STATUS := “3”) (“Encerrado”).

Encerra CIOT (TMSA256)

Para atender à exigência da ANTT

, fora  desenvolvida

foi desenvolvida nova funcionalidade que solicita o Encerramento dos

CIOT's

CIOTs.

  

 

Pela regulamentação

,

podem haver apenas 2

CIOT's

CIOTs não encerrados para o terceiro, fazendo-se necessário o controle dos

CIOT's

CIOTs não encerrados.

E se

Se o Contrato

fora

foi gerado em um CIOT por Periodo, não

poderá

será possível estorná-lo se houver outro em aberto.

As opções desta rotina são:

    FECHAR
    • Fechar CIOT
  •  -
    • :
      Atualiza apenas
  • o DJL
    • o campo Status CIOT (DJL_STATUS) para 2- Fechado (não integrada à Pamcard/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.
  • ENCERRAR
    • Encerrar CIOT
  •  -
    • :
      Atualiza o campo Status CIOT (DJL_STATUS) para 3- Encerrado.
      Ação de integração com a Pamcard onde o CIOT é encerrado na ANTT - todos os
  • contratos
    • Contratos do CIOT estão pagos, neste momento.
      É válido citar que a operadora encerra automaticamente os
  • CIOT's
    • CIOTs após determinado período (atualmente, 60 dias).


Informações
Observações:
iconfalse
titleObservações!
  • Essa rotina está preparada para ser executada via
Exchedule
  • Schedule.
  • Serão processados os registros do
Ciot
  • CIOT por
Periodo
  • Período (DJl), com status
'
  • 1- Em aberto
'
  • ou
'
  • 2- Fechado
'
  • , até a Data do Prazo Final do CIOT
.
  • (Data Base do Sistema - 30 dias).

Exemplo:
TMSA256(aParam)
Onde: aParam[1]- Empresa, aParam[2] - Filial

Informações
iconfalse
titleImportante!

Com a utilização do CIOT por período, as taxas bancárias serão enviadas uma única vez ao Contrato Pamcard (CIOT).

A Pamcard não permite adicionar valor de pedágio ao Contrato Pamcard (CIOT) e, por esta razão, são gerados contratos Contratos adicionais sem integração com a ANTT, apenas com o valor do pedágio. Portanto, as parcelas e os documentos de uma viagem Protheus estarão em um único Contrato Pamcard (CIOT) para o período (Identificado pelo pelo campo Id.Ope.Vge. (DTQ_IDOPE)), enquanto o pedágio de cada viagem Protheus terá um Contrato Pamcard específico (ID.Vge.Pdg (DTQ_IDPDG) identifica este "elo" de ligação para o pedágio).

A Pamcard não permite que sejam inseridas parcelas com valores inferiores às as taxas bancárias do Contrato Pamcard. Portanto, no período , não será possível realizar adiantamentos ou pagamentos de Saldo com valores inferior inferiores à soma das taxas. 

Exemplo: Taxas de saque/transferência = R$ 50,00. Não poderá ocorrer adiantamento de R$ 40,00 em nenhuma viagem do período, mesmo que já tenha sido enviada em outras viagens já tenham sido enviados valores superiores à soma das taxas.

Com o uso a utilização de um mesmo Contrato Pamcard para múltiplas viagens Protheus, caso haja estorno no Protheus (na operação que gerou a integração: Fechamento de viagem, Saída de viagem ou Pagto. de Saldo), as parcelas referente referentes ao estorno serão excluídas do Contrato Pamcard e constarão como "EXCLUÍDASExcluídas" no site da Pamcard. Isto vale tanto para parcelas de "Adiantamento" (integradas no fechamento da viagem Protheus e liberadas na operação de saída de viagem) como parcelas de "Saldo Final" (integradas na Liberação de Saldo do contrato de carreteiro Protheus).

Diferente do que acontece na integração utilizando CIOT o CIOT por viagem, a Pamcard exige um ID único do sistema que realiza a integração (Protheus). Como teremos múltiplas parcelas de adiantamento neste novo cenário (no outro cenário - CIOT por viagem - existe uma única parcela de adiantamento identificada como '1'), será utilizado como ID da parcela o "IDCNAB" (E2_IDCNAB) do título financeiro no Protheus referente à a parcela.

Apesar de destacar as taxas de transferência em campos diferentes no Contrato Pamcard (CIOT), a operadora Operadora exige que seja enviada parcela para o referido valor. Esta parcela será enviada no momento da geração do Contrato Pamcard (CIOT) e terá a identificação de '1'. No caso de estorno, esta parcela nunca será excluída, pois outras viagens estarão vinculadas ao mesmo Contrato Pamcard (CIOT). 

Caso Se apenas uma viagem Protheus esteja estiver vinculada à a um Contrato Pamcard (CIOT) por Período e esta seja estornada, o Contrato Pamcard (CIOT) será cancelado, bem como o Contrato referente ao pedágio, se este existir. 

MetodoFuncionalidade
UpdateValuesFreightContrac

Liberação para pagamento da parcela.

Esse método é executado ao fazer efetuar o pagamento de saldo ou liberação do contrato Contrato de carreteiroCarreteiro.

CloseFreightContractEfetua a baixa do CIOT junto a Pamcard.
InsertFreightContractRetorna o codigo código do CIOT.


Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Aplique o patch do chamado e execute a atualização do pacote de dicionário de dados para a criação de tabela e campos. O pacote de dicionário de dados estará disponível apenas no release release 12.1.17 com  com expedição em Janeiro em Abril/2018. 

Informações
iconfalse
titleDicionário de Dados Release 12.1.17

Disponibilizado para download o dicionário de dados e patch do pacote deste chamado em:

https://cat.totvs.com.br/TrocaArquivos/download.aspx?id=2480&key=mQbvmZ3OQkYmhQImlkkUPzOOIqrKS3YlUQVXWTsSde41


Atualizações de Dicionário

  1. Inclusão de tabela no arquivo SX2 – Tabelas:

Chave

Nome

Único

DJL

CIOT por periodo x veiculo  

DJL_FILIAL+DJL_CIOT  


2. Criação de Campos no arquivo SX3 – Campos:

  • Tabela DJL – CIOT por periodo x veiculo 

Campo

DJL_FILIAL

Tipo

CaracterCaractere

Tamanho

2

Decimal

0

Título

Filial

Descrição

Filial do Sistema

Usado

Não

Obrigatório

Não

Browse

Não

Contexto

Real

Propriedade

Visualizar

Grupo de Campos

033 - Tamanho da Filial

Ordem

01

Help do Campo

Filial do Sistema.

Campo

DJL_CIOT

Tipo

CaracterCaractere

Tamanho

17

Decimal

0

Título

CIOT

Descrição

Cod. Ident.Operac.Transp.

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Ordem

02

Help do Campo

CIOT - Codigo Código Identificador da Operacão Operação de Transporte. Código gerado por meio de operadora Operadora homologada para a ANTT.

Campo

DJL_CODVEI

Tipo

CaracterCaractere

Tamanho

8

Decimal

0

Título

Cod.Veiculo

Descrição

Codigo do Veiculo

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Ordem

03

Help do Campo

Código do Veículo o ao qual é associado o CIOT.

Campo

DJL_DATINI

Tipo

Data

Tamanho

8

Decimal

0

Título

Dt. Ger CIOT

Descrição

Data geracao do CIOT

Usado

Sim

Obrigatório

Não

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Ordem

04

Help do Campo

Data da geração do CIOT.

Campo

DJL_DATFIM

Tipo

Data

Tamanho

8

Decimal

0

Título

Dt.Prz. CIOT

Descrição

Data de validade do CIOT

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Ordem

05

Help do Campo

Data prevista para o Encerramento encerramento do CIOT.

Campo

DJL_DATFEC

Tipo

Data

Tamanho

8

Decimal

0

Título

Dt.Fech CIOT

Descrição

Data Fechamento do CIOT

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Ordem

06

Help do Campo

Data de fechamento do CIOT no TMS Protheus.

Campo

DJL_STATUS

Tipo

CaracterCaractere

Tamanho

1

Decimal

0

Título

Status CIOT

Descrição

Status CIOT

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Grupo de Campos


Opção1=Aberto;2=Fechado;3=Encerrado;9=Cancelado

Ordem

07

Help do Campo

Status do CIOT no TMS Protheus.


Tabela DTR – Veiculos da Viagem

Campo

DTR_TPCIOT

Tipo

CaracterCaractere

Tamanho

1

Decimal

0

Título

Tipo CIOT

Descrição

Tipo de CIOT

Usado

Sim

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Visualizar

Relação

'1'

Opção1=Por viagem;2=Por periodo

Ordem

56

Help do Campo

Tipo de CIOT: Por período ou por Viagem.

Campo

DTR_DTFMCDTFMCI

Tipo

Data

Tamanho

8

Decimal

0

Título

Dt.Enc. CIOT

Descrição

Data de encerramento CIOT

Usado

Sim

Obrigatório

Não

Browse

Sim

Contexto

Real

Propriedade

Visualizar

Ordem

57

Help do Campo

Data de encerramento CIOT.


  • Tabela DUJ – Contrato de Fornecedores

Campo

DUJ_TPCIOT

Tipo

CaracterCaractere

Tamanho

1

Decimal

0

Título

Tipo CIOT

Descrição

Tipo de CIOT

Usado

Sim

ValidaçãoPertence('12')

Obrigatório

Sim

Browse

Sim

Contexto

Real

Propriedade

Alterar

Relação'1'
Opção1=Por Viagem;2=Por Veiculo

Ordem

15

Help do Campo

Tipo de CIOT: Por viagem ou Por periodoperíodo.

Campo

DUJ_PRCIOT

Tipo

NumericoNumérico

Tamanho

16

Decimal

4

Título

Prazo CIOT

Descrição

Prazo CIOT

Usado

Sim

ValidaçãoPositivo()

Obrigatório

Sim

Browse

Não

Contexto

Real

Propriedade

Alterar

Ordem

16

Help do Campo

Prazo do CIOT em dias. Será computado este prazo na abertura de um CIOT por periodo.


3. Criação de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela DTR - Veiculos da Viagem

Campo

DTR_CODVEI

Sequência

011

Campo Domínio

DTR_TPCIOT

Tipo

P

Regra

a240TpCiot()

Campo

DTR_CODVEI

Sequência

012

Campo Domínio

DTR_DTFMCI

Tipo

P

Regra

a240TpCiot()


4. Criação e Alteração de Índices no arquivo SIX – Índices

Índice

DJL

Ordem

1

Chave

DJL_FILIAL+DJL_CIOT+DJL_CODVEI 

Descrição

Filial+Ciot+Cod.Veiculo

Mostra Pesq.

Sim

Índice

DJL

Ordem

2

Chave

DJL_FILIAL+DJL_CODVEI+DJL_CIOT       

Descrição

Filial+Cod.Veiculo+Ciot

Mostra Pesq.

Sim

Índice

DJL

Ordem

3

Chave

DJL_FILIAL+DJL_CODVEI+DTOS(DJL_DATINI)          

Descrição

Filial+Cod.Veiculo+Dt. Ger CIOT

Mostra Pesq.

Sim


Procedimento para

Utilização 

Utilização 

Exemplo:

      

  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 Periodo".
  4. Preencha Informe o Prazo CIOT com o prazo (em dias) desejado, por exemplo 30 dias.
  5. Efetue a geração de viagens para o terceiro, cujo contrato Contrato indica Tipo de CIOT como "2-Por Periodo".
    Verifique , no fechamento, que o CIOT (DTR_CIOT) e o Id da operadora (DTQ_IDOPE), continuam o mesmo para todas as viagens.
  6. Para as viagens com CIOT por período, cujo o valor do pedágio seja pago no cartão Pamcard, será gerada uma viagem adicional no sistema Pamcard para o crédito do valor do pedágio (DTQ_IDPDG).
  7. Acesse Atualizações / Terceiros / Contrato de Carreteiro (TMSA250).
  8. Após a quitação dos contratos Contratos gerados com Tipo de CIOT por período, executar execute a opção "Encerra CIOT" , para que seja gerado novo CIOT nas próximas viagens.
  9. Confirme todas as operações por meio do site disponível disponibilizado pela operadoraOperadora.