Histórico da Página
Pamcard - CIOT Por Período
Características do Requisito
Linha de Produto: | Microsiga Protheus® 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 | DLOGTMS03-332 | ||||||||||||||
País(es): | Brasil | ||||||||||||||
Banco(s) de Dados: | Todos homologados | ||||||||||||||
Tabelas Utilizadas: | DJL - Ciot x Veículos DTR - 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 um veículo utilize o mesmo CIOT em mais de uma viagem.
Contrato do Fornecedor
Foram criados
novosos 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
novosos 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).
Caso
- Dt.Enc. CIOT (DTR_
DTFMC) - Informação - DTFMCI):
Essa informação será preenchida automaticamente, após a informação do
veículo campo - DTFMCI):
- 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.
- 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).
Fechamento da Viagem
Ao realizar o fechamento da viagem
e, se
a viagemesta for integrada com a Pamcard (Tipo CIOT (DTR_TPCIOT == ‘2’))
,é gerado um novo CIOT ou reutilizado
um CIOTo 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ículoveículo.
Contrato de Carreteiro - Quebra do
contrato por período. NaContrato Por Período
Na geração do
contratoContrato de
carreteiroCarreteiro 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
contratoContrato de
carreteiroCarreteiro (DTY) com número diferente daquelas que tiveram o CIOT.
Pagamento de Saldo
Ao realizar o pagamento de saldo ou liberação do
contrato de carreteiro, é enviandoContrato do Carreteiro, a liberação para pagamento da parcela.é enviada por meio do método UpdateValuesFreightContract
a liberação para pagamento da parcela.
Será solicitada a baixa do CIOT e após o retorno do método informado que os CIOTs foram encerrados,
será atualizado oserão atualizados os status dos CIOTs
encerrados campoencerrados, campo Status CIOT (DJL_STATUS := “3”) (“Encerrado”).
Encerra CIOT (TMSA256)
Para atender à exigência da ANTT
, fora desenvolvidafoi desenvolvida nova funcionalidade que solicita o Encerramento dos
CIOT'sCIOTs.
Pela regulamentação
,podem haver apenas 2
CIOT'sCIOTs não encerrados para o terceiro, fazendo-se necessário o controle dos
CIOT'sCIOTs não encerrados.
E seSe o Contrato
forafoi 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 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 - Contratos do CIOT estão pagos, neste momento.
- CIOTs após determinado período (atualmente, 60 dias).
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 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 à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 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 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. |
Metodo | Funcionalidade |
---|---|
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. |
CloseFreightContract | Efetua a baixa do CIOT junto a Pamcard. |
InsertFreightContract | Retorna 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 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 |
Caractere | |
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 - Código Identificador da |
Operação de Transporte. Código gerado por meio de |
Operadora homologada para a ANTT. |
Campo | DJL_CODVEI |
Tipo |
Caractere | |
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 |
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 perí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.