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

Edição feita às 14h20min de 28 de setembro de 2017 por Verena.santos (disc | contribs)

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.

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

2. 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.5 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. 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;

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.