Mudanças entre as edições de "Integração - TargetBank - Consultor`s"

Edição das 01h21min de 24 de agosto de 2022

1 - Objetivo

Este manual tem por objetivo orientar os usuários do Consultor`s a realizarem a integração com a TargetBank no âmbito da emissão do contrato de frete e emissão do CIOT na ANTT.

2 – Instrução/Orientações

Orientações para o processo completo da transmissão de um contrato de frete.

2.1 – Configurações

O primeiro passo é configurar a tela ciot002d, onde é necessário informar alguns parâmetros.

Após é necessário configurar os parâmetros específicos para a integração da TargetBank.

Clicar no botão Movimentação Financeira para configurar os históricos necessários para a emissão do contrato de frete(CIOT).

2.2 – Transportador/Freteiro

Para realizar a integração com a TargetBank é necessário enviar os dados do transportador. Para isso dentro do cadastro do transportador(ger033) foram criados algumas funções para enviar os dados para a TargetBank no programa ger033dg.

No grupo TargetBank temos as funções para Consultar Transportador, Cadastrar Transportador, Associar Cartão e Consultar Cartão. Devemos seguir a seguinte ordem para enviar corretamente o transportador para a TargetBank e possibilitar a emissão de um contrato de frete.

1. Consultar Transportador - Primeiramente devemos consultar se o transportador já está cadastrado na TargetBank, caso ele esteja o sistema automaticamente já vincula o cadastro existente na TargetBank com o sistema Consultor's.
2. Cadastrar o Transportador - Caso o transportador não esteja na TargetBank deverá ser chamado para cadastrar o transportador na TargetBank e após o cadastro já será vinculado o código do transportador registrado na TargetBank com o Consultor's.
3. Associar Cartão - Após cadastrar o transportador devemos vincular um cartão ao transportador, existem dois tipos de cartão ao portador um cartão para transportadores do tipo CNPJ e outro para CPF, sempre antes de chamar a função para associar o cartão devemos informar o número do cartão que será vinculado e também o CPF do portador desse cartão que é um campo obrigatório.
4. Consultar Cartão - Para os casos do transportador já possuir um cartão da TargetBank é possível informar o número do cartão e registrar no sistema chamando a função consultar cartão.
5. Substituir Cartão - Função utilizada para substituição de um cartão já associado a algum transportador, onde deverá ser selecionado um motivo para a sua substituição, lembrando de informar o novo número do cartão a ser associado na substituição.

Observação: Importante ressaltar que o CPF ao portador informado deverá ser de um motorista já cadastrado na TargetBank, então caso o CPF informado não está como motorista deverá ser criado um cadastro de motorista para o CPF informado.

2.3 – Motorista

Para realizar a integração com a TargetBank é necessário enviar os dados do motorista. Para isso dentro do cadastro do motorista(ger024) foram criados algumas funções para enviar os dados para a TargetBank no programa ger024.

No grupo TargetBank temos as funções para Consultar Motorista, Cadastrar Motorista, Associar Cartão e Consultar Cartão. Devemos seguir a seguinte ordem para enviar corretamente o motorista para a TargetBank e possibilitar a emissão de um contrato de frete.

1. Consultar Motorista - Primeiramente devemos consultar se o motorista já está cadastrado na TargetBank, caso ele esteja o sistema automaticamente já vincula o cadastro existente na TargetBank com o sistema Consultor's.
2. Cadastrar o Motorista - Caso o motorista não esteja na TargetBank deverá ser chamado para cadastrar o motorista na TargetBank e após o cadastro já será vinculado o código do motorista registrado na TargetBank com o Consultor's.
3. Associar Cartão - Após cadastrar o motorista devemos vincular um cartão ao motorista, normalmente o cartão do motorista é diferente do transportador, sendo que este recebe o valor do adiantamento caso marcado na tela ciot002d23 com a opção Transfêrencia Automática do Adiantamento para o Motorista marcada.
4. Consultar Cartão - Para os casos do motorista já possuir um cartão da TargetBank é possível informar o número do cartão e registrar no sistema chamando a função consultar cartão.
5. Substituir Cartão - Função utilizada para substituição de um cartão já associado a algum motorista, onde deverá ser selecionado um motivo para a sua substituição, lembrando de informar o novo número do cartão a ser associado na substituição.

2.4 – Rotas

O cadastro das rotas é um ponto muito importante para a emissão do contrato de frete na TargetBank, porque é a partir deste cadastro que será calculado o valor do pedágio caso ele existir.

Para isso na tela ger321 ou no fro003 criamos um botão de Consultar Rota na TargetBank, esse botão automaticamente consulta se a rota já está cadastrada na TargetBank pelo município de origem e município de destino, caso ela existir cadastrada na TargetBank o sistema Consultor's já vincula ela a rota da TargetBank caso contrário é chamado o método para cadastrar a rota, após o retorno do id da rota criada o Consultor's cria a vinculação no sistema.

Observação: pode acontecer algumas inconsistências no cadastro das rotas, devido à uma demora na sua criação, então irá retornar uma inconsistência informando que deverá aguardar alguns minutos e consultar novamente, após aguardar é só clicar no botão Consultar novamente que voltará o id da rota criada na TargetBank e o sistema irá vincular ela.

2.5 – Emissão do Contrato de Frete - CIOT

2.6 – Painel de Controle - TargetBank