Versão 63ESP3 - Instalação e Configuração da Integração IntGUDB

De Dealernet Wiki | Portal de Soluo, Notas Tcnicas, Verses e Treinamentos da Ao Informtica

(Diferença entre revisões)
Linha 2: Linha 2:
-
= 1. Introdução =
+
= Introdução =
-
O IntGUDB é uma solução de integração entre os sistemas Dealernet e a montadora Ford através de Web Service. A integração ocorre uma vez ao dia, conforme horário configurado na instalação do serviço (ver item 4.4).
+
1. O IntGUDB é uma solução de integração entre os sistemas Dealernet e a montadora Ford através de Web Service. A integração ocorre uma vez ao dia, conforme horário configurado na instalação do serviço (ver item 4.4).
1.1 INTERFACES DA INTEGRAÇÃO
1.1 INTERFACES DA INTEGRAÇÃO
Linha 38: Linha 38:
NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)
NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)
-
= 3. Envio Manual da Exportação INTGUDB =
+
= Envio Manual da Exportação INTGUDB =
-
Caso o usuário necessite executar a integração de datas retroativas, pode executar o processo de envio manual GUDB. A tela é executada a partir do servidor (pesquisar no menu iniciar do windows, a tela aparecerá como um programa instalado) onde esta instalado o serviço de envio da integração.  
+
3. Caso o usuário necessite executar a integração de datas retroativas, pode executar o processo de envio manual GUDB. A tela é executada a partir do servidor (pesquisar no menu iniciar do windows, a tela aparecerá como um programa instalado) onde esta instalado o serviço de envio da integração.  
O usuário deve selecionar as empresas e informar o período e depois clicar no botão Processar. Logo abaixo a tela de envio manual.
O usuário deve selecionar as empresas e informar o período e depois clicar no botão Processar. Logo abaixo a tela de envio manual.
Linha 47: Linha 47:
[[Arquivo:675759 imagem1.jpg]]
[[Arquivo:675759 imagem1.jpg]]
-
= 4. Instalação e Configuração do Serviço =
+
= Instalação e Configuração do Serviço =
* Antes da Instalação
* Antes da Instalação
-
Antes da instalação, certifique-se de que o serviço Windows não está instalado na máquina. Cheque se o serviço IntGUDB está na lista de serviços do Windows. Se existe, pare o serviço e desinstale-o via Menu Iniciar\Ação Informática\IntGUDB ou vá ao Painel de Controle do Windows e desinstale o programa “IntGUDB”.
+
4. Antes da instalação, certifique-se de que o serviço Windows não está instalado na máquina. Cheque se o serviço IntGUDB está na lista de serviços do Windows. Se existe, pare o serviço e desinstale-o via Menu Iniciar\Ação Informática\IntGUDB ou vá ao Painel de Controle do Windows e desinstale o programa “IntGUDB”.
* Durante a Instalação
* Durante a Instalação
Linha 85: Linha 85:
b) Após o processo de desinstalação do serviço, caso o serviço não saia da fila de console de serviços do Windows, execute no prompt de comando: cmd.exe /c SC DELETE IntGUDB_V1.0
b) Após o processo de desinstalação do serviço, caso o serviço não saia da fila de console de serviços do Windows, execute no prompt de comando: cmd.exe /c SC DELETE IntGUDB_V1.0
-
= 5. Regras das Interfaces da Integração =
+
= Regras das Interfaces da Integração =
 +
 
 +
5.
5.1 Regras comuns a todas as interfaces
5.1 Regras comuns a todas as interfaces
Linha 254: Linha 256:
"C" = Certified Pre-owned: Não se aplica;
"C" = Certified Pre-owned: Não se aplica;
-
= 6. Monitor WebService =
+
= Monitor WebService =
-
Serão inseridas no monitor WebService (SOF/ Monitor Nf-e NFS-e/ Monitor WebService) as mensagens retornadas pela Ford no caso de indisponibilidade do Web Service do GUDB. Para realizar a pesquisa, o usuário deve selecionar: Montadora FORD, integração INTGUDB, a empresa e o processo. A mensagem pode ser visualizar através do botão Detalhe, conforme imagem a baixo:
+
6. Serão inseridas no monitor WebService (SOF/ Monitor Nf-e NFS-e/ Monitor WebService) as mensagens retornadas pela Ford no caso de indisponibilidade do Web Service do GUDB. Para realizar a pesquisa, o usuário deve selecionar: Montadora FORD, integração INTGUDB, a empresa e o processo. A mensagem pode ser visualizar através do botão Detalhe, conforme imagem a baixo:
[[Arquivo:675759 imagem910.jpg]]
[[Arquivo:675759 imagem910.jpg]]
Nota: A tela do monitor WebService estará disponível apenas na versão 64FSP1. Caso seja necessário verificar a disponibilidade do WebService GUDB, essas informações também são escritas no log de execução do serviço que estão disponíveis na pasta de instalação do IntGUDB.
Nota: A tela do monitor WebService estará disponível apenas na versão 64FSP1. Caso seja necessário verificar a disponibilidade do WebService GUDB, essas informações também são escritas no log de execução do serviço que estão disponíveis na pasta de instalação do IntGUDB.

Edição de 10h52min de 27 de setembro de 2017

RASCUNHO


Tabela de conteúdo

Introdução

1. O IntGUDB é uma solução de integração entre os sistemas Dealernet e a montadora Ford através de Web Service. A integração ocorre uma vez ao dia, conforme horário configurado na instalação do serviço (ver item 4.4).

1.1 INTERFACES DA INTEGRAÇÃO

1.1.1. Parts Inventory - Exporta para a montadora Ford as informações históricas dos últimos 12 meses de venda de peças, quantidade em estoque, quantidade bloqueada, estoque ideal, última data de venda, custo médio entre outras. Essa exportação é baseada na Exportação Gestok Ford que existe no módulo de integração com a fábrica Ford.

1.1.2 Parts Invoice - Exporta para a montadora Ford as informações de venda e devoluções de peças do período. A exportação utiliza como base o Relatório Analítico/Sintético de Vendas de Peças (EAD/ Relatórios / Vendas / Analítico/Sintético).

1.1.3 Repair Order - Exporta para a montadora Ford as informações de das Ordens de Serviços encerradas e canceladas do período.

1.1.4 Used Vehicle Sales (Retail Delivery Reporting) - Exporta para a montadora Ford as informações de venda de veículos usados do período. A exportação utiliza como base o Relatório de Veículos Vendidos por Período (VEC/ Relatórios/ Vendas/ Veículos Vendidos por Período).

1.1.5 Service Appointment - Exporta para a montadora Ford as informações de agendamentos de serviços da oficina abertos no período.

2. Configuração do Sistema Dealernet para o Funcionamento da Integração

Para a exportação das informações para a montadora, é necessário que os seguintes parâmetros no módulo de segurança do sistema estejam devidamente configurados:

CODIGO DA CONCESSIONARIA NA MONTADORA

CÓDIGO DA MONTADORA

CÓDIGO DO FABRICANTE

CÓDIGO DO ESTOQUE DO BALCÃO

NOME SOFTWAREHOUSE

NATUREZAS QUE SERÃO GERADAS AS NOTAS DE SCRAP

NATUREZA DE OP. P/ INVENTÁRIO (ENTRADA)

NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)

Envio Manual da Exportação INTGUDB

3. Caso o usuário necessite executar a integração de datas retroativas, pode executar o processo de envio manual GUDB. A tela é executada a partir do servidor (pesquisar no menu iniciar do windows, a tela aparecerá como um programa instalado) onde esta instalado o serviço de envio da integração.

O usuário deve selecionar as empresas e informar o período e depois clicar no botão Processar. Logo abaixo a tela de envio manual.


Arquivo:675759 imagem1.jpg

Instalação e Configuração do Serviço

  • Antes da Instalação

4. Antes da instalação, certifique-se de que o serviço Windows não está instalado na máquina. Cheque se o serviço IntGUDB está na lista de serviços do Windows. Se existe, pare o serviço e desinstale-o via Menu Iniciar\Ação Informática\IntGUDB ou vá ao Painel de Controle do Windows e desinstale o programa “IntGUDB”.

  • Durante a Instalação

4.1 Execute o instalador IntGUDB.exe

4.2 Clique em Avançar, depois selecione o local de instalação e, por fim, clique em avançar até finalizar a instalação.

Arquivo:675759 imagem2.jpg

4.3 Selecione o local de instalação e, por fim, clique em avançar até finalizar a instalação.

Arquivo:675759 imagem3.jpg

Arquivo:675759 imagem4.jpg

4.4 Na tela de configuração, informe o servidor, o nome do banco e o usuário e senha do banco de dados com privilégios para gravar dados. Depois, informe a hora de execução do serviço, conforme print abaixo:

Arquivo:675759 imagem5.jpg

Arquivo:675759 imagem6.jpg

4.6 O usuário pode checar se o serviço está instalado e iniciado no console de serviços do Windows. Caso não esteja iniciado, é só clicar no link “Iniciar o serviço”.

Arquivo:675759 imagem7.jpg

Observações:

a) Para alterar as configurações do serviço, é necessário pará-lo na janela de serviços do Windows, realizar a alteração das configurações (No Windows

7: Todos os C:\Program Files (x86)\Ação Informática\IntGUDB) e depois iniciar novamente o serviço.

b) Após o processo de desinstalação do serviço, caso o serviço não saia da fila de console de serviços do Windows, execute no prompt de comando: cmd.exe /c SC DELETE IntGUDB_V1.0

Regras das Interfaces da Integração

5.

5.1 Regras comuns a todas as interfaces

5.1.1 O tipo de privacidade para e-mail (Privacy/PrivacyTypeString) é definido pela configuração do cadastro do cliente, onde para configuração de todos os e-mails cadastrados (inclusive os da aba contato) será considerado o campo permite divulgação de E-Mail para informar o valor Yes ou No na tag PrivacyTypeString, conforme configuração abaixo:

Arquivo:675759 imagem8.jpg

5.1.2 O tipo de privacidade para SMS (Privacy/PrivacyTypeString) é definido pela configuração do cadastro do cliente, onde para configuração de todos os telefones do tipo celular cadastrados (inclusive os da aba contato) será considerado o campo permite enviar de SMS para informar o valor Yes ou No na tag PrivacyTypeString, conforme configuração abaixo:

Arquivo:675759 imagem9.jpg

5.1.3 Para os dados de endereço, são enviados de forma default o valor Yes na tag PrivacyTypeString.

5.1.4 Os tipos de telefones considerados para a tag CompleteNumber são: Residencial (home), Celular (Cell), SMS (SMS), Virtual (MMS) e para os demais é considerado Work.

5.1.5 A tag star:ID que identifica o vendedor, que apenas será enviado um valor, podendo ser STARS ou local, conforme: STARS: Envia a informação contida no campo Cód.Fun. Montadora do cadastro do vendedor;local: Envia o código interno do cadastro do funcionário quando o campo Cód.Fun. Montadora não esta preenchido;

5.2 Regras da interface Parts Inventory: Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:

5.2.1 Campo AdjustmentDaily, conforme:

LOSS: é definido pelas movimentações de ajuste com natureza igual à definida no parâmetro “NATUREZAS QUE SERÃO GERADAS AS NOTAS DE SCRAP”;

POPP: é definido pelas movimentações de ajuste com natureza igual à definida no parâmetro “NATUREZA DE OP. P/ INVENTÁRIO (ENTRADA)”;

SCRAP: é definido pelas movimentações de ajuste com natureza igual à definida no parâmetro “NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)”;

UNKNOWN: é definido pelas demais movimentações de ajuste que não se enquadram nos casos anteriores;

5.3 Regras da interface Parts Invoice: Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:

5.3.1 Campo PartsCustomerTypeCode, conforme:

"B" = Body Shop: Vendas de origem de oficina;

"D" = Dealer to Dealer: Vendas onde o tipo de cliente seja concessionária;

"F" = Fleet: Vendas onde o segmento de mercado seja do grupo frotista;

"G" = Government : Vendas onde o tipo de cliente seja governo;

"I" = Internal: Vendas onde o tipo de cliente seja departamento;

"J" = Jobber: Vendas onde o segmento de mercado seja do grupo loja de peças;

"R" = Retail: Vendas onde o tipo de cliente não seja cliente, governo ou departamento;

"W" = Wholesale: Vendas onde o segmento de mercado seja grupo rede;

"U" = Unknown: Nenhuma das opções anteriores;

5.3.2 Campo PartsInvoiceType, conforme o indicador de presença informado na nota fiscal de saída, onde o valor será:

“E” = eCommerce: Operação não presencial, pela Internet;

“P” = Phone: Operação não presencial, Teleatendimento;

“W” = Walk in: Operação presencial;

“Q” = Quick Parts: NFC-e em operação com entrega em domicílio;

“U” = Unknown: Demais situações;

5.4 Regras da interface Repair Order: Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:

5.4.1 Campo Job/OperationID, conforme:

"C" = Customer Pay: Tipo de OS grupo cliente;

"E" = ESP: Tipo de OS grupo Garantia onde o tipo de garantia seja classificação estendida;

"I" = Internal: Tipo de OS grupo Departamento ou Reclamação;

"W" = Warranty: Tipo de OS grupo Garantia;

"U" = Unknown: Demais situações;

5.4.2 Campo Job/WorkshopCode, conforme:

"B" = Body Shop: Código montadora do setor de serviço igual a B;

"D" = Dealer Prep: Código montadora do setor de serviço igual a D;

"M" = Mobile Service Operation: Código montadora do setor de serviço igual a M;

"O" = Satellite Service Location: Código montadora do setor de serviço igual a O;

"Q" = Quicklane: Serviço rápido;

"S" = Service Department: Tipo de OS grupo Departamento ou Reclamação;

"U" = Unknown / Blank: Demais situações;

5.4.3 Campo DepartmentType, conforme:

"B" = Body Shop: Se existir serviço com setor de serviço funilaria e pintura;

"D" = Dealer to Dealer: Vendas onde o tipo de cliente seja concessionária;

"F" = Fleet: Vendas onde o segmento de mercado seja do grupo frotista;

"G" = Government: Vendas onde o tipo de cliente seja governo ;

"I" = Internal: Vendas onde o tipo de cliente seja departamento;

"J" = Jobber: Vendas onde o segmento de mercado seja do grupo loja de peças;

"A" = Authorized Repair Centers: Segmento de mercado do grupo Oficina Especializada;

"W" = Wholesale: Vendas onde o segmento de mercado seja grupo rede;

"R" = Retail: Nenhuma das opções anteriores e o tipo de cliente seja pessoa física ou jurídica;

"U" = Unknown: Nenhuma das opções anteriores;

5.4.4 Campo AppointmentType, conforme:

"I" = Internet: Agendamento criado pelo Agenda Ford;

"W" = Walk In: Agendamento RECEPTIVO + (Passante e data do agendamento for posterior Data de abertura da OS);

"A" = Dealership Initiated by employees: Agendamento ATIVO;

"P" = Phone: Agendamento RECEPTIVO;

"S" = Service Advisor Initiated: Agendamento PRESENCIAL;

"U" = Unknown: Demais situações;

5.5 Regras da interface Service Appointment: Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:

5.5.1 Campo LeadSourceCode conforme:

"I" = Internet: Agendamento criado pelo Agenda Ford;

"W" = Walk In: Agendamento RECEPTIVO + (Passante e data do agendamento for posterior Data de abertura da OS);

"A" = Dealership Initiated by employees: Agendamento ATIVO;

"P" = Phone: Agendamento RECEPTIVO;

"S" = Service Advisor Initiated: Agendamento PRESENCIAL;

"U" = Unknown: Demais situações;

5.5.2 Campo AppointmentStatus conforme:

"C" = Appointment is Cancelled: Agendamento cancelado;

"K" = Appointment is Kept, update when customer shows up for appointment: Agendamento não confirmado;

"M" = Missed Appointment without cancelling or rescheduling: No Show;

"U" = Appoint: Agendamento com mudança de horário e não confirmado;

"N" = New Appointment: Demais situações;

5.6 Regras da interface Used Vehicle Sales (Retail Delivery Reporting): Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:

5.6.1 Campo SaleCategoryString, conforme:

"F" = Fleet: Grupo do segmento de mercado do cliente da venda Frotista;

"R" = Retail: Demais situações diferentes do anterior;

"C" = Certified Pre-owned: Não se aplica;

Monitor WebService

6. Serão inseridas no monitor WebService (SOF/ Monitor Nf-e NFS-e/ Monitor WebService) as mensagens retornadas pela Ford no caso de indisponibilidade do Web Service do GUDB. Para realizar a pesquisa, o usuário deve selecionar: Montadora FORD, integração INTGUDB, a empresa e o processo. A mensagem pode ser visualizar através do botão Detalhe, conforme imagem a baixo:

Arquivo:675759 imagem910.jpg

Nota: A tela do monitor WebService estará disponível apenas na versão 64FSP1. Caso seja necessário verificar a disponibilidade do WebService GUDB, essas informações também são escritas no log de execução do serviço que estão disponíveis na pasta de instalação do IntGUDB.