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)
(Criou página com '1. 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, conform…')
Linha 1: Linha 1:
-
1. INTRODUÇÃO  
+
= 1. 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).
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).
Linha 15: Linha 15:
1.1.5 Service Appointment - Exporta para a montadora Ford as informações de agendamentos de serviços da oficina abertos no 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.
+
= 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:
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:
Linha 35: Linha 35:
NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)
NATUREZA DE OP. P/ INVENTÁRIO (SAÍDA)
-
3. ENVIO MANUAL DA EXPORTAÇÃO INTGUDB
+
= 3. 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.  
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.  
Linha 44: Linha 44:
[[Arquivo:675759 imagem1.jpg]]
[[Arquivo:675759 imagem1.jpg]]
-
4. INSTALAÇÃO E CONFIGURAÇÃO DO SERVIÇO
+
= 4. INSTALAÇÃO E CONFIGURAÇÃO DO SERVIÇO =
Antes da Instalação
Antes da Instalação
Linha 69: Linha 69:
[[Arquivo:675759 imagem6.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”.
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”.
Linha 75: Linha 74:
[[Arquivo:675759 imagem7.jpg]]
[[Arquivo:675759 imagem7.jpg]]
-
Observações
+
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  
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  
Linha 83: Linha 82:
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
+
= 5. REGRAS DAS INTERFACES DA INTEGRAÇÃO =
5.1 Regras comuns a todas as interfaces
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:
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]]
[[Arquivo:675759 imagem8.jpg]]
Linha 241: Linha 239:
"N" = New Appointment: Demais situações;
"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 Regras da interface Used Vehicle Sales (Retail Delivery Reporting): Alguns campos do XML exportado possuem definições que serão descritas logo abaixo:
Linha 253: Linha 250:
"C" = Certified Pre-owned: Não se aplica;
"C" = Certified Pre-owned: Não se aplica;
-
 
+
= 6. Monitor WebService =
-
6. 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:
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 17h50min de 26 de setembro de 2017

Tabela de conteúdo

1. 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.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)

3. 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.

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

4. INSTALAÇÃO E CONFIGURAÇÃO DO SERVIÇ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”.

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

5. REGRAS DAS INTERFACES DA INTEGRAÇÃO

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;

6. 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:

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.