|
|
| (9 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.
| + | |