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

De Wiki CGI Software de Gestão
Ir para: navegação, pesquisa
Linha 79: Linha 79:
 
'''<big>2.2 – Transportador/Freteiro</big>'''
 
'''<big>2.2 – Transportador/Freteiro</big>'''
 
----
 
----
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''.
+
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''.<br><br>
 +
Menu de Acesso - ''Menu Geral => Contas a Pagar => Manutenções => Fornecedores''
 
<br><br>
 
<br><br>
 +
Acesso a tela de configuração do transportador para a TargetBank - ''Alterar Fornecedor(''ger033'') => Botão Frota(''ger033d'') => Botão CIOT(''ger033dc'') => Fornecedor - Dados CIOT(''ger033dg'')''
 +
[[Arquivo:ger033dg.png]]
 +
<br><br>
 +
 
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.
 
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.
  
Linha 94: Linha 99:
 
'''<big>2.3 – Motorista</big>'''
 
'''<big>2.3 – Motorista</big>'''
 
----
 
----
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''.
+
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''.<br> <br>
 +
Menu de Acesso - ''Menu Geral => Geral => Tabelas de Implantação => Departamento de Vendas => Vendas => Motorista''
 +
 
 
<br><br>
 
<br><br>
 
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.
 
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.

Edição das 08h57min 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.

Campo
Descrição / Comentário sobre os campos
Exemplo de Preenchimento
Arquivos Informar o local onde os arquivos da integração (logs) serão amrazenados g:\consult\ciot\TargetBank
Identificação do Ambiente Informar se o ambiente utilizado será de Homologação ou Produção Homologação
Integrador CIOT Selecione qual integrador deseja utilizar, neste caso TargetBank TargetBank
CNPJ Emissor CNPJ que será utilizado para assinatura digital da comunicação 12123123123412
Servidor CGI URL do servidor da CGI Software na Nuvem https://datacenter.webcgi.com.br
Senha Certificado Senha do certificado digital utilizado no CNPJ Emissor 12345abcde


Ciot002d target1.png

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

Campo
Descrição / Comentário sobre os campos
Exemplo de Preenchimento
Usuário Informar o usuário disponibilizado pela TargetBank para o acesso aos web services cgisoftware
Senha Informar a senha disponibilizado pela TargetBank para o acesso aos web services 12345
Checkbox Transfêrencia Automática do Adiantamento para o Motorista Sim/Não
Botão Movimentação Financeira
Botão Taxas e Transferências


Ciot002d23.png

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

Campo
Descrição / Comentário sobre os campos
Exemplo de Preenchimento
Banco Informar o banco que será utilizado para a integração 1
Adiantamento Informar o histórico para o adiantamento 215
Saldo de Frete Informar o histórico para o saldo de frete 60
Quebra Informar o histórico para o quebra 2043
Avaria Informar o histórico para a avaria 2042
Desconto Frete Informar o histórico para o desconto antecipado do contrato de frete 2044
 % Desconto Antecipação Informar o histórico para o desconto por antecipação do frete 15.00


Ciot002d25.png


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.

Menu de Acesso - Menu Geral => Contas a Pagar => Manutenções => Fornecedores

Acesso a tela de configuração do transportador para a TargetBank - Alterar Fornecedor(ger033) => Botão Frota(ger033d) => Botão CIOT(ger033dc) => Fornecedor - Dados CIOT(ger033dg) Ger033dg.png

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.

Menu de Acesso - Menu Geral => Geral => Tabelas de Implantação => Departamento de Vendas => Vendas => Motorista



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