De Dealernet Wiki | Portal de Soluo, Notas Tcnicas, Verses e Treinamentos da Ao Informtica
| Linha 17: | Linha 17: | ||
= Configuração do Sistema Dealernet para o Funcionamento da Integração = | = 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: | + | '''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 | CODIGO DA CONCESSIONARIA NA MONTADORA | ||
Edição de 14h13min de 28 de setembro de 2017
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.
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.
4.3 Selecione o local de instalação e, por fim, clique em avançar até finalizar a instalação.
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:
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”.
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:
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:
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:
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.