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)
(Página substituída por '[https://dealernet.atlassian.net/servicedesk/customer/kb/view/155025501?applicationId=f4dbae30-cc22-37c8-a506-19d1f44f129c&spaceKey=TICKET&src=991838120&title=Win+-+%40%40…')
 
(10 edições intermediárias não estão sendo exibidas.)
Linha 1: Linha 1:
-
= 1. INTRODUÇÃO =
+
[https://dealernet.atlassian.net/servicedesk/customer/kb/view/155025501?applicationId=f4dbae30-cc22-37c8-a506-19d1f44f129c&spaceKey=TICKET&src=991838120&title=Win+-+%40%40%40hl%40%40%40Instala%26ccedil%3B%26atilde%3Bo%40%40%40endhl%40%40%40+e+Configura%26ccedil%3B%26atilde%3Bo+da+Integra%26ccedil%3B%26atilde%3Bo+%40%40%40hl%40%40%40IntGUDB%40%40%40endhl%40%40%40 Instalação e Configuração da Integração IntGUDB]
-
 
+
-
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.
+

Edição atual tal como 16h26min de 28 de janeiro de 2019

Instalação e Configuração da Integração IntGUDB