Histórico da Página
Pamcard - CIOT Por Período
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||||||||||
Segmento: | Supply Chain - Logística | ||||||||||||||
Módulo: | SIGATMS - Gestão de Transportes | ||||||||||||||
Rotina: |
| ||||||||||||||
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): | Informe o requisito relacionado (Issue).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 os seguintes campos:
- Tipo CIOT (DUJ_TPCIOT): 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 os seguintes campos:
- Tipo CIOT (DTR_TPCIOT):
Informação será preenchida automaticamente, após informação do veículo campo Cod.Veiculo (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 (MV_FORGEN).
- Tipo CIOT (DTR_TPCIOT):
- Dt.Enc. CIOT (DTR_DTFMCI):
Essa informação será preenchida automaticamente, após a informação do veículo, campo Cod.Veiculo (DTR_CODVEI), com o conteúdo do campo Prazo CIOT (DUJ_PRCIOT) do Contrato do Fornecedor somada a Data Atual do Sistema (respeitando prazo máximo de 30 dias).
Ddatabase + DUJ_DTFCMI.
- Dt.Enc. CIOT (DTR_DTFMCI):
Fechamento da Viagem
Ao realizar o fechamento da viagem, se esta for integrada com a Pamcard (Tipo CIOT (DTR_TPCIOT == ‘2’)) é gerado um novo CIOT ou reutilizado o já existente para o veículo.
Após o retorno da Pamcard é efetuada a gravação da tabela DJL, com as informações do CIOT e veículo.
Contrato de Carreteiro - Quebra do Contrato Por Período
Na geração do Contrato de 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 de Carreteiro (DTY) com número diferente daquelas que tiveram o CIOT.
Pagamento de Saldo
Ao realizar o pagamento de saldo ou liberação do Contrato do Carreteiro, a liberação para pagamento da parcela.é enviada por meio do método UpdateValuesFreightContract.
Será solicitada a baixa do CIOT e após o retorno do método informado que os CIOTs foram encerrados, serão atualizados os status dos CIOTs encerrados, campo Status CIOT (DJL_STATUS := “3”) (“Encerrado”).
Encerra CIOT (TMSA256)
Para atender à exigência da ANTT foi desenvolvida nova funcionalidade que solicita o Encerramento dos CIOTs.
Pela regulamentação podem haver apenas 2 CIOTs não encerrados para o terceiro, fazendo-se necessário o controle dos CIOTs não encerrados. Se o Contrato foi gerado em um CIOT por Periodo, não será possível estorná-lo se houver outro em aberto.
As opções desta rotina são:
- Fechar CIOT:
Atualiza apenas 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.
- Fechar CIOT:
- 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 do CIOT estão pagos, neste momento.
É válido citar que a operadora encerra automaticamente os CIOTs após determinado período (atualmente, 60 dias).
- Encerrar CIOT:
Informações | ||||
---|---|---|---|---|
| ||||
Exemplo: |
Informações | ||||
---|---|---|---|---|
| ||||
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 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 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 |
as taxas bancárias do Contrato Pamcard. Portanto, no período |
não será possível realizar adiantamentos ou pagamentos de Saldo com valores |
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 |
em outras viagens já tenham sido enviados valores superiores à soma das taxas. Com |
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 |
referentes ao estorno serão excluídas do Contrato Pamcard e constarão como " |
Excluí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 |
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 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). |
Se apenas uma viagem Protheus |
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. |
Encerra CIOT (TMSA256)
Para atender à exigência da ANTT, fora desenvolvida nova funcionalidade que solicita o Encerramento dos CIOT's.Pela regulamentação, podem haver apenas 2 CIOT's não encerrados para o terceiro, fazendo-se necessário o controle dos CIOT's não encerrados.
Se o Contrato fora gerado em um CIOT por Periodo, não poderá estorná-lo se houver outro em aberto.
FECHAR CIOT - Faz com que seja possivel iniciar um novo CIOT para as novas viagens enquanto nao tenha sido efetuado o pagamento de saldo das viagens
ENCERRAR CIOT -
Após o retorno do método informado que os CIOTs foram encerrados, é atualizado o status dos CIOTs na Tabela DUJ (DJL_STATUS = '3' - Encerrado ).
Metodo | Funcionalidade |
---|---|
UpdateValuesFreightContrac | Liberação para pagamento da parcela. Esse método é executado ao |
efetuar o pagamento de saldo ou liberação do |
Contrato de |
Carreteiro. | |
CloseFreightContract | Efetua a baixa do CIOT junto a Pamcard. |
InsertFreightContract | Retorna o código do CIOT. |
title | Encerra CIOT (TMSA256) |
---|
Essa rotina está preparada para ser executada via Exchedule.
Serão processados os registros do Ciot por Periodo (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
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 | ||||
---|---|---|---|---|
| ||||
Disponibilizado para download o dicionário de dados e patch do pacote deste chamado em: |
Atualizações de Dicionário
- 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ção | 1=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ção | 1=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ção | Pertence('12') |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Relação | '1' |
Opção | 1=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ção | Positivo() |
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çãoUtilização
Exemplo:
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato de Fornecedores (TMSA800).
- Posicione o cursor no Contrato de Fornecedor desejado e clique em Alterar.
- Selecione o Tipo de CIOT como "2-Por Periodo".
- Preencha Informe o Prazo CIOT com o prazo (em dias) desejado, por exemplo 30 dias.
- 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. - 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).
- Acesse Atualizações / Terceiros / Contrato de Carreteiro (TMSA250).
- 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.
- Confirme todas as operações por meio do site disponível disponibilizado pela operadoraOperadora.