Você está na página 1de 89

Ford Fcil Interface

______________________________________________________________________________________________

Ford Fcil Interface (CRR)


Descrio de Servios e Interfaces

Verso 1.9

Copyright 2008 Ford Motor Company


(U.S. and international notice, and original material were added in each indicated year.)

Ford Fcil Pg. 1/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

1 Objetivo.....................................................................................................................................................................................5
2 Escopo.......................................................................................................................................................................................5
3 Arquitetura................................................................................................................................................................................5
4 Pr-requisitos de funcionamento..............................................................................................................................................6
5 Sincronismo de informaes....................................................................................................................................................7
6 Segurana..................................................................................................................................................................................7
7 Configuraes do Certificado...................................................................................................................................................8
8 Conhecimento da Tecnologia (LEITURA OBRIGATRIA)...................................................................................................8
9 Etapas para publicao do certificado na Ford........................................................................................................................9
10 Implementar o WS-Security (Criptografia)..........................................................................................................................9
11 Servios disponiveis............................................................................................................................................................10
12 Processo...............................................................................................................................................................................11
12.1 FLUXO DE INFORMAES DO PROCESSO ATUAL DE VENDAS.......................................................................................11
12.2 FLUXO DE INFORMAES DO PROCESSO PROPOSTO DE VENDAS.............................................................................11
12.3 SEQUNCIA DO PROCESSO DE NEGCIO................................................................................................................ 12
12.4 REGRAS ESPECIAIS PARA GRUPO DN COM DE MAIS DE 1 LOJA...............................................................................13
13 Estrutura.............................................................................................................................................................................14
14 Consulta de mensagens no DMS........................................................................................................................................14
15 Descrio detalhada de cada servio..................................................................................................................................15
15.1 FLUXO DE LOJA.................................................................................................................................................. 15
15.1.1 Dicionrio de Dados da Requisio:......................................................................................................................17
15.1.2 Dicionrio de Dados da Resposta:........................................................................................................................21
15.1.3 Validaes de Negcio............................................................................................................................................21
15.2 PROSPECO....................................................................................................................................................... 23
15.2.1 Dicionrio de Dados da Requisio:.....................................................................................................................24
15.2.2 Dicionrio de Dados da Resposta:........................................................................................................................25
15.3 VENDA............................................................................................................................................................... 28
15.3.1 Dicionrio de Dados da Requisio:.....................................................................................................................29
15.3.2 Dicionrio de Dados da Resposta:........................................................................................................................35
15.3.3 Validaes de Negcio............................................................................................................................................35
15.4 CANCELAMENTO PEDIDO..................................................................................................................................... 38
15.4.1 Dicionrio de Dados da Requisio:.....................................................................................................................39
15.4.2 Dicionrio de Dados da Resposta:........................................................................................................................39
15.4.3 Validaes de Negcio............................................................................................................................................40
15.5 CONSULTA CVVG............................................................................................................................................... 41
15.5.1 Dicionrio de Dados da Requisio:.....................................................................................................................42
15.5.2 Dicionrio de Dados da Resposta:........................................................................................................................42
15.6 RECEBIMENTO DE VECULO.................................................................................................................................. 44
15.6.1 Dicionrio de Dados da Requisio:.....................................................................................................................45
15.6.2 Dicionrio de Dados da Resposta:........................................................................................................................45
15.6.3 Validaes de Negcio............................................................................................................................................45
15.7 CONSULTA DE ESTOQUE....................................................................................................................................... 46
15.7.1 Dicionrio de Dados da Requisio:.....................................................................................................................47
15.7.2 Dicionrio de Dados da Resposta:........................................................................................................................48
15.8 RESERVA DE VECULO.......................................................................................................................................... 49
15.8.1 Dicionrio de Dados da Requisio:.....................................................................................................................50
15.8.2 Dicionrio de Dados da Resposta:........................................................................................................................50
15.8.3 Validaes de Negcio............................................................................................................................................51
15.9 BLOQUEIO DE VECULO........................................................................................................................................ 52

Ford Fcil Pg. 2/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.9.1 Dicionrio de Dados da Requisio:.....................................................................................................................53


15.9.2 Dicionrio de Dados da Resposta:........................................................................................................................53
15.9.3 Validaes de Negcio............................................................................................................................................54
15.10 DESBLOQUEIO DE VECULO.................................................................................................................................. 55
15.10.1 Dicionrio de Dados da Requisio:.................................................................................................................56
15.10.2 Dicionrio de Dados da Resposta:....................................................................................................................56
15.10.3 Validaes de Negcio........................................................................................................................................57
16 Status dos Veiculos..............................................................................................................................................................57
17 Importar certificado com chave pblica - .p7b ( entidade externa)...................................................................................58
18 Importar certificado com chave privada - .pfx ( pessoal)..................................................................................................66
19 Exportar certificado com chave privada.............................................................................................................................74
20 Exportar somente chave publica.........................................................................................................................................82
21 Sobre a documentao........................................................................................................................................................89

Ford Fcil Pg. 3/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Histrico das Revises


Nmero Data Autor Descrio
da
Verso
1.0 31/11/2007 Luiz Moraes Ford Fcil Direto - ID Assess, Analysis
1.1 25/02/2008 Luiz Moraes Ford Fcil Direto - Design
1.2 05/05/2008 Luiz Moraes Ford Fcil Direto - Build
1.3 17/10/2008 Luiz Moraes Ford Fcil Direto - Deploy
1.4 20/02/2009 Luiz Moraes Ford Fcil Direto - PILOTO
1.5 04/05/2009 Gabriel Ribeiro Validaes de Negcio
1.6 08/06/2009 Gabriel Ribeiro Cdigos de Status nas Validaes de Negcio
1.7 16/11/2009 Luiz Moraes Incluso de novas regras p/alterao da venda
1.8 10/02/2010 Luiz Moraes Consulta de mensagens no DMS
1.9 12/04/2010 Gabriel Ribeiro Insero dos itens 12.3 e 12.4

Ford Fcil Pg. 4/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

1 Objetivo

Construir uma nova ferramenta de troca de informaes entre os distribuidores e a Ford,


mantendo a infraestrutura existente de cada distribuidor.

2 Escopo

Permitir a Ford atravs da aplicao Ford Fcil e ao distribuidor atravs da alicao


DMS as opes de enviar e receber informaes referentes: veculo, cliente, dados do
pedido, fluxo de loja, prospeco de novos clientes, CVVG, estoque, recebimento de
veiculos, reserva e bloqueio de veiculos, evitando redigitao das informaes entre as
duas aplicaes: Ford Fcil e DMS.
Essa interface dever ser segura e permitir um sincronismo nas informaes contidas no
Ford Fcil e o DMS.
A Ford ser responsvel pelo controle de acesso a essa nova interface do Ford Fcil.

3 Arquitetura

Trfego baseado em HTTP (trfego liberado atravs de firewalls).


Utilizao de Arquitetura orientada a servios (Web Services).
As mensagens devero ser enviadas em um envelope SOAP com o XML populado,
todas as mensagens devero ser validadas, verificando se a mesma no est vazia e
efetuar as consistncias de acordo com o template.
Trfego criptografado (confidencialidade de trfego) e garantia de no-violao dos
dados trafegados. Cada distribuidor dever possuir uma certificao digital que dever
ser informada a Ford, para carga no Ford Fcil.

Ford Fcil Pg. 5/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

WSDL

Publica XSD Importa


SOAP
Provedor Requisio Consumidor
Servios
(FF Servios
Interface)
Resposta (DMS)
XML
Ordena Atende
Envelope Envelope

Header Header
WS-Policy
Body Body

4 Pr-requisitos de funcionamento

O DRD vai prover o acesso aos Distribuidores que desejam utilizar a nova interface do
Ford Fcil.
Todos os vendedores do Distribuidor devero estar configurados e permanecerem ativos
no Ford Fcil WEB.

Ford Fcil Pg. 6/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

5 Sincronismo de informaes

Com a utilizao do Ford Fcil Interface com os servios: Fluxo de Loja, Prospeco,
Venda, Cancelar Venda, Consulta CVVG e Recebimento de veiculo. Todo sincronismo
de informaes estar mantido.
O Distribuidor poder utilizar as duas arquiteturas disponibilizadas pelo Ford Fcil:
Aplicao WEB (Ford Fcil WEB) ou Web Sevices (Ford Fcil Interface) ao mesmo
tempo, mas com isso ser necessrio e mandatrio a utilizao dos servios: consulta
de veiculo, reserva de veiculo, bloqueio de veiculo, desbloqueio de veiculo. Eles so
necessrios para manter o sincronismo da base de dados do DMS e Ford Fcil.
Demais processos como: relatrios, atualizao de cpf do gerente e vendedor, busca de
clientes, agenda, pedidos de veiculos que no foram faturados pelo Ford (pedidos
confirmados), etc no estaro disponiveis nessa release do Ford Fcil Interface.

6 Segurana

WS-Policy WS-Policy

Provedor Requisio Consumidor


Servios
Servios
(FF
Interface)
Resposta (DMS)

X509
Certificao
Digital

Ford Fcil Pg. 7/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

7 Configuraes do Certificado

Verso X509 V3 para todos os certificados na corrente.


PKIX.
Basic Constraints para todos os certificados na corrente.
Subject Key Identifier presente.
Enhance Key Usage
- Client Authentication OID (no necessrio porm aceitavel)
- Server Authentication OID (no necessrio porm aceitavel)
Key Usage (finalidade) para pelo menos Digital Signature (Assinatura digital) , Key
Encipherment (a0) (Criptografia)
Se qualquer propriedade (constraints) estiver marcada como "critical" ento esta deve
ser bem definida e identificada, por exemplo: "Basic Constraints".
necessrio gerar uma requisio CSR ( SSL Certificate Signing Request). Trata-se de
um arquivo gerado por computador e usado para criar o certificado. IMPORTANTE: os
dados da empresa do Subject NO podem conter acentos!!!

8 Conhecimento da Tecnologia (LEITURA OBRIGATRIA)

Tutoriais (AMIGAVEL)
http://www.w3schools.com/webservices/ws_intro.asp
http://www.w3schools.com/wsdl/default.asp
http://www.w3schools.com/soap/default.asp
http://www.w3schools.com/schema/default.asp
Especificaes ( NO amigvel)
http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/ws-securitypolicy-1.2-
spec-os.html
http://www.w3.org/TR/ws-policy/
http://www.w3.org/TR/wsdl
http://www.w3.org/XML/Schema

Ford Fcil Pg. 8/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

9 Etapas para publicao do certificado na Ford

o Compra do certificado;
o Envio da chave pblica para a FORD;
o Publicao da chave pblica da Software House no servidor FORD;
o Envio da chave pblica FORD para a Software House;
o Publicao da chave pblica FORD no servidor da Software House;
o Efetuar testes com um executvel somente para testes que a Ford ira fornecer
(ConsoleApplication.exe).
o Desenvolver comunicao criptografada na tecnologia padro WS-Security
X509;

10 Implementar o WS-Security (Criptografia)

partir dos arquivos WSDL, pode-se gerar todos os XML utilizando a ferramenta
SOAPUI: http://www.soapui.org/
O WCF (Windows Communication Foundation) uma biblioteca da Microsoft para
Webservices, SOAP WS-Security etc.
a nica biblioteca da microsoft que implementa o WS-Policy 1.5 (2007) na verso da
Ford. http://msdn.microsoft.com/en-us/library/ms734712.aspx
Segue tutorial de uso do WCF no Visual Studio:
http://imasters.uol.com.br/artigo/6408/uso_simplificado_do_wcf_-
_windows_communication_foundation
No WCF, as configuraes dos certificados e WS-Security so os WCF Security
Behaviors. Eles referenciam o certificado atravs dos campos Subject . O behavior
intercepta a mensagem para manipular, neste caso criptografar usando os certificados
digitais. Para entender importante ler: http://msdn.microsoft.com/en-
us/library/ms731199.aspx .
possvel utilizar o WCF via delphi http://edn.embarcadero.com/article/36962
As nicas bibliotecas que implementam a criptografia do WS-Security so: WCF,
Java(jax-ws) e C++, sendo que para Delphi Win32 possvel usar o WCF.

Ford Fcil Pg. 9/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

11 Servios disponiveis

Nessa nova interface sero disponilibizados 10 servios na WEB:

o Prospeco
o Fluxo de Loja
o Venda
o Cancelamento de Venda
o Consulta de CVVG
o Recebimento de Veculo
o Consulta de Estoque
o Reserva de Veiculo
o Bloqueio de Veiculo
o Desbloqueio de Veiculo

Ford Fcil Pg. 10/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

12 Processo

12.1 Fluxo de Informaes do processo atual de Vendas

12.2 Fluxo de Informaes do processo proposto de Vendas

Ford Fcil Pg. 11/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

12.3 Sequncia do processo de negcio

Afim de iniciar o processo de vendas, o DMS deve sincronicar os chassis do seu estoque com
os da consulta estoque ( QueryStockService) passando o cdigo do DN de estoque ( pode ser
mais de 1, em caso de grupo DN com vrias lojas) .

Aps receber os chassis em TRNSITO ( status 68) da consulta estoque por DN e sincronizar
com os do seu estoque, o DMS pode fazer a consulta 1 a 1 nos chassis restantes NO
sincronizados para descobrir qual o status ( 80-ESTOQUE, 82-RESERVADO, 84-
BLOQUEADO, 90-NEGOCIADO, 100-FATURADO, 110-CVVG).
Os chassis em TRNSITO ou ESTOQUE ( 68 ou 80) J podem ser negociados.

Segue seqncia de negcios abaixo:

consulta estoque por DN ( QueryStockService) - retorna lista somente status 68


(Trnsito).
consulta estoque por chassi (QueryStockService) - retorna 1 chassi com dados em
qualquer status ( 80-ESTOQUE, 82-RESERVADO, 84-BLOQUEADO, 90-NEGOCIADO,
100-FATURADO, 110-CVVG).
recebimento do veculo ( ReceiveVehicleService) - altera status 68 para 80 em estoque
reserva de veculo ( ReserveVehicleService ) - altera para status 82, com liberao via
desbloqueio ou automtica em 2 horas
bloqueio de veculo ( BlockVehicleService) - - altera para status 84, com liberao
somente via desbloqueio
desbloqueio de veculo ( UnlockVehicleService) - volta para status 80, caso esteja 82 ou
84
fluxo de loja ( ShareActivitesService) - gera cdigo de oportunidade para o pedido
( chave chassi + DN + opportunity)
pedido sem dados Invoice ( SaleVehicleService) - gera pedido NO faturado com chave
composta ( chave chassi + DN + opportunity + order)
pedido COM dados Invoice ( SaleVehicleService) - gera ou atualiza pedido FATURADO
com chave composta ( chave chassi + DN + opportunity + order)
cancelamento de pedido ( CancelPurchaseOrder) - cancela pedido pela chave ( DN +
order)
consulta CVVG por chassi ( QueryCVVGService ) - retorna chassi com CVVG
consulta CVVG por data ( QueryCVVGService ) - retorna lista de chassis com CVVG
consulta Leads por DN ( QueryLeadsService) - consulta lista de oportunidades futuras
cadastradas via Ford.com ou database marketing.

Ford Fcil Pg. 12/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

12.4 Regras especiais para grupo DN com de mais de 1 loja

Para distribuidores com grupo composto por mais de 1 loja existem regras de dados
importantes a serem seguidas.

Para a Ford o distribuidor pode receber o veculo em uma loja DN 00001, vender por outra loja
00002 , sendo a venda registrada no nome do vendedor de uma terceira loja 00003 ( todos do
mesmo grupo).
A venda fica registrada no DN da loja 00002.
O CVVG ser enviado para o DN do vendedor de mrito da venda ( 00003 por exemplo).

O MAIS IMPORTANTE:
A chave composta do FLUXO DE LOJA (ShareActivitiesService) no banco de dados
Ford formada por 2 campos DealerCode + OpportunityCode ( ou seja: DN +
oportunidade).
A chave composta do PEDIDO (SaleVehicleService) no banco de dados Ford formada
por 4 campos VIN + DealerCode + OpportunityCode + PurchaseOrderCode ( ou seja:
chassi + DN + oportunidade + pedido).

LOGO: uma vez feito o fluxo de loja e gerada a oportunidade pelo DN 00002, no importa onde
FOI feito recebimento, onde SER feita a venda, ou de onde o vendedor, A CHAVE DEVE
SER MANTIDA COM O MESMO DealerCode do fluxo de loja em diante. Guarde a chave com a
qual foi feito o fluxo de loja e utilize a mesma (DealerCode + OpportunityCode) para gerao
do pedido e alteraes do fluxo ou do pedido.

DETALHE:
A chave do fluxo de loja pode ser utilizada para gerar pedidos para vrios chassis
diferentes, ou seja a MESMA oportunidade pode gerar MAIS DE 1 venda.

Se for feito o fluxo de loja em um DN 00001 e a venda ou faturamento com outro cdigo DN
00002 o sistema acusar que a oportunidade no existe porque a chave foi alterada
(DealerCode + OpportunityCode).
Se for feito um pedido em um DN 00001 e alterao do mesmo pedido com outro cdigo DN
00002 o sistema acusar que o pedido no existe porque a chave foi alterada (VIN +
DealerCode + OpportunityCode + PurchaseOrderCode).

Como a chave do pedido (VIN + DealerCode + OpportunityCode + PurchaseOrderCode)


um mesmo cdigo de pedido 1001 por exemplo pode constar reutilizado para vrios DNs
diferentes.
Ento cuidado ao salvar somente o cdigo do pedido e no a chave completa (VIN +
DealerCode + OpportunityCode + PurchaseOrderCode) pois corre-se o risco de tentar
atualizar o pedido e receber mensagens como " pedido no existe ", ou " pedido no pode ter
chassi alterado ", pois estar sendo acessado o pedido de outro DN do mesmo grupo.

Ford Fcil Pg. 13/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

13 Estrutura

A descrio de cada interface seguir a estrutura a seguir:


WSDL: arquivo "Web Service Description Language";
Provedor de Servio: sistema que atuar como servidor na interface (Ford ou DMS);
Provedor de Dados: sistema que prover os dados, podendo ser o servidor ou o cliente.
Exemplos:
1. O cliente envia uma consulta ao servidor, que por sua vez responde com os dados, logo,
o provedor de dados o servidor;
2. O cliente envia dados ao servidor para serem processados, o servidor responde com o
resultado do processamento baseado nos dados enviados pelo cliente, logo, o servidor
atua como inteligncia de negcio e o cliente como provedor de dados;
Frequncia: a periodicidade em que a interface ativada, podendo ser por demanda, horrio
estipulado ou intervalo de tempo;
Dependncia: a dependncia de dados entre interfaces indica a interface que dever ser
executada anteriormente, quando aplicvel. Exemplo: a interface de venda no pode ser
acionada no caso de um cliente no haver sido previamente enviado atravs das atividades de
clientes;
URL: Endereo de acesso quando o provedor de servio for a Ford;
Descrio: Descrio de funcionamento e regras de negcio envolvidas;
Template de requisio: Referncia ao arquivo XSD com template da mensagem de
requisio, distribudo junto com este documento;
Template de resposta: Referncia ao arquivo XSD com template da mensagem de resposta,
distribudo junto com este documento;
Exemplo de requisio: Referncia ao arquivo XML com exemplo de mensagem de
requisio, distribudo junto com este documento;
Exemplo de resposta: Referncia ao arquivo XML com exemplo de mensagem de resposta,
distribudo junto com este documento;

14 Consulta de mensagens no DMS

Construir dentro do DMS uma nova funcionalidade, que permita para o Distribuidor na
operao do software, consultar todas as mensagens de resposta do Ford Fcil
Interfaces. Essas mensgens devem estar de uma forma amigvel e de fcil
compreenso, tambm se faz necessrio incluir no manual de operao do software as
tomadas de deciso que o Distribuidor dever executar. Essa nova funcionalidade
poder ser representada atravs de uma tela de consulta, onde dever conter todos os
processos (com sucesso ou erro).

Ford Fcil Pg. 14/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15 Descrio detalhada de cada servio

15.1 Fluxo de Loja

WSDL:
wsdl/ShareActivities.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/ShareActivitiesService
qa (com criptrografia): http://xgtwqa.ford.com/5015/ShareActivitiesService
produo ( somente criptografia): http://xgtw.ford.com/5015/ShareActivitiesService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Depende da origem da prospeco do cliente:
1. Para clientes que a Ford disponibilizou na interface PROSPECO e o
Distribuidor j obteve contato ou no, o vendedor deve informar o DMS e
esse dever enviar para o CAF no mesmo momento, ou criar um processo
batch, que entre em contato com o Ford Fcil a cada 15 minutos;
2. Para clientes que o Distribuidor fez prospeco, atendimento, o DMS
poder enviar essas informaes a cada 15 minutos ou 4 vezes ao dia,
isso depender da estratgia, e da performance da aplicao.;

Horrio:
Esse servio estar disponivel de segunda domingo, 24 horas por dia;

Descrio:
Nesse servio o Ford Fcil ir registrar os atendimentos que o Distribuidor realizou, seja
uma ligao, test drive, etc;

Observao:
O Cdigo do Cliente Ford necessariamente ser nulo caso o cliente tenha sido criado
no DMS e ainda no tenha sido enviado para a Ford, caso contrrio, dever ser
informado;

Ford Fcil Pg. 15/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Em alguns casos o DMS j ter o cdigo do cliente Ford, ou por que este foi enviado
anteriormente na interface LEADS ou este cliente j tenha sido atendido e enviado para
o Ford Fcil;
A oportunidade deve possuir uma lista de atividades. Caso a oportunidade esteja:
o aberta: todas as atividades devem ser fechadas, exceto a ltima, que deve ser
um agendamento;
o fechada: todas as atividades devem ser fechadas;
Uma atividade fechada uma atividade que possui o horrio de fim preenchido;
Depois que uma oportunidade enviada, ao passo em que for atualizada no DMS,
estas mudanas devem ser enviadas ao Ford Fcil ainda por meio deste servio, para
tanto, a oportunidade deve ser enviada com todos os seus dados preenchidos e, neste
caso, o cdigo da oportunidade tambm deve estar preenchido, inclusive os dados do
cliente. A exceo so as atividades. Apenas atividades novas e a ltima atividade
enviada previamente e que estava aberta devem ser enviadas. Para esta nova leva de
atividades, caso a oportunidade esteja:
o aberta: todas as atividades devem ser fechadas, exceto a ltima, que deve ser
um agendamento;
o fechada: todas as atividades devem ser fechadas;
Um mesmo cliente no pode ter duas oportunidades abertas ao mesmo tempo;
Todas as oportunidades que no forem fechads pelo DMS, tero o prazo de 30 dias
para serem atualizadas, caso isso no ocorra sero fechadas automaticamento;
Essa interface muito importante caso o FLUXO DE LOJA seja originado de um LEAD
enviado pela FORD, o seu envio para o Ford Fcil ir evitar ligaes desnecessrias
pelo CAF para o Distribuidor;

Pr-Condies:
O Distribuidor ter efetuado um atendimento a um cliente, ou ter efetuado um contato com
um cliente atravs de um telefonema, etc;

Gatilho:
O processo poder ser on-line, ou seja, logo que o vendedor faa a entrada das
informaes no DMS ou atravs de um processo batch dentro do DMS para buscar os
FLUXOS DE LOJA realizados em um determinado periodo;

Ps-Condies:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML e
processa os dados, e informa o DMS o cdigo do cliente Ford;
Esse servio uma pr condio para a Venda, caso seja enviada uma venda sem que o
DMS tenha enviado o FLUXO DE LOJA anteriormente, todas as vendas enviadas sem
FLUXO DE LOJA sero rejeitadas;

Ford Fcil Pg. 16/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.1.1 Dicionrio de Dados da Requisio:


Layout Fluxo de Loja
ID Nome/Descrio Ind Tipo Dado Tamanho Observao
Dado Uso
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
3 Code (Cdigo da O positiveInteger 11 Cdigo numrico da oportunidade gerado pela Ford.
Oportunidade Ford) No enviado durante a insero, porm usado
para atualizar o fluxo de loja j existente.
4 Customer - ClientCode O int 11 Cdigo do cliente dentro da Ford.
(Cdigo do Cliente)
5 Customer - FullName M String 35 Exemplo: Jos da Silva
(Nome Completo)
6 Customer - DOC1 O String 14 Exemplo: 012345678901
(Nmero do CPF / CNPJ)
7 Customer - DOC2 O String 14 Exemplo: 012345678
(Nmero RG / Inscrio
Estatual)
8 Customer - Gender O String 1 Valores M ou F.
(Sexo)
9 Customer - PersonType O String 1 1 - Pessoa Fisica
(Tipo de Cliente) 2 - Pessoa Juridica
10 Customer - Email O String 70 Exemplo: cliente@provedor.com.br
11 Customer - MaritalState O String 1 C - Casado
(Estado Civil) S - Solteiro
D - Divorciado
E - Separado
O - Outros
V - Viuvo
A - Amaziado
N - No sei
12 Customer - O String 1 0 - ANALFABETO
EducationDegree 1 - PRIMEIRO GRAU INCOMPLETO (PRIMARIO)
(Escolaridade) 2 - PRIMEIRO GRAU COMPLETO (PRIMARIO)
3 - SEGUNDO GRAU INCOMPLETO (COLEGIAL)
4 - SEGUNDO GRAU COMPLETO (COLEGIAL)
5 SUPERIOR INCOMPLETO
6 - SUPERIOR COMPLETO
7 - POS-GRADUACAO
8 - MESTRADO
9 - DOUTORADO
13 Customer - BirthDate O DateTime 10 Data de nascimento do cliente.
(Data de Nascimento)
14 Customer - O String 40 Nome da rua da Residncia do Cliente.
HomeAddress - Street
(Nome da Rua)
15 Customer - O String 15 Nmero da Residncia do Cliente.
HomeAddress - Number
(Nmero do Endereo)
Ford Fcil Pg. 17/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

16 Customer O String 50 Complemento do Endereo Residencial.


HomeAddress
Complement
(Complemento)
17 Customer M String 30 Cidade do Endereo Residencial.
HomeAddress City
(Cidade)
18 Customer M String 2 Sigla do estado do Endereo Residencial.
HomeAddress State
(Estado)
19 Customer O String 8 CEP do Endereo Residencial.
HomeAddress ZIP
(CEP)
20 Customer O String 60 Bairro do Endereo Residencial.
HomeAddress District
(Bairro)
21 Customer M Integer 2 Cdigo de rea do Telefone Residencial
HomePhone Area (Valores 11 at 99).
(Cdigo de rea)
22 Customer M Integer 10 Nmero do Telefone Residencial
HomePhone Number (Valor at 99999999).
(Nmero)
23 Customer O Integer 3 Ramal do Telefone Residencial.
HomePhone
Extension (Ramal)
24 Customer O String 2 01 = Empresrio
OccupationCode 02 = Assalariado
(Profisso) 03 = Autnomo
04 = Profissional Liberal
05 = Aposentado
06 = Produtor Rural
07 = Outros
25 Customer M Integer 2 Cdigo de rea do Telefone Comercial
BusinessPhone Area (Valores 11 at 99).
(Cdigo de rea)
26 Customer M Integer 10 Nmero do Telefone Comercial
BusinessPhone (Valor at 99999999).
Number (Nmero)
27 Customer O Integer 10 Ramal do Telefone Comercial.
BusinessPhone
Extension (Ramal)
28 Customer M Integer 2 Cdigo de rea do Telefone Alternativo
AlternativePhone (Valores 11 at 99).
Area (Cdigo de rea)
29 Customer M Integer 10 Nmero do Telefone Alternativo
AlternativePhone (Valor at 99999999).
Number (Nmero)
30 Customer O Integer 10 Ramal do Telefone Alternativo.
AlternativePhone
Extension (Ramal)
31 Customer - O String 40 Rua do endereo Comercial do Cliente.
BusinessAddress -
Street (Nome da Rua)
32 Customer - O String 15 Nmero do endereo Comercial do Cliente.
Ford Fcil Pg. 18/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

BusinessAddress -
Number (Nmero do
Endereo)
33 Customer O String 50 Complemento do Endereo Comercial.
BusinessAddress
Complement
(Complemento)
34 Customer O String 30 Cidade do Endereo Comercial.
BusinessAddress City
(Cidade)
35 Customer O String 2 Sigla do estado do Endereo Comercial.
BusinessAddress
State (Estado)
36 Customer O String 8 CEP do Endereo Comercial.
BusinessAddress ZIP
(CEP)
37 Customer O String 60 Bairro do Endereo Comercial.
BusinessAddress
District (Bairro)
38 Customer O String 11 Cdigo do cliente no aplicativo do DMS.
DMSClientCode (Cdigo
do Cliente DMS)
39 ModelCode (Modelo) O String 4 Cdigo do Modelo Ford ( TMA).
Exemplo: EUA ( Ecosport).
40 DMSOpportunityCode M String 11 Cdigo da oportunidade no aplicativo do DMS.
(Cdigo do DMS)
41 Date (Data da O DateTime 10 Data da Oportunidade.
Oportunidade)
42 StatusCode (Status da O int 1 1 - Oportunidade Perdida
Oport.) 3 - Prospeco
4 - Negociao
5 Fechada
43 CloseReasonCode O int 2 1 - Comprou o veculo neste distribuidor
(Motivo) 2 - Venda Perdida
3 - Outros
4 - Venda Perdida - Veculo no disponvel
5 - Venda Perdida - Preo
6 - Venda Perdida - Condies de pagamento
7 - Venda Perdida - Veculo usado mal avaliado
8 - Venda Perdida Distribuidor no compra veculo
usado
9 Venda Perdida - Indeciso do cliente
10 - Venda Perdida - Postergou a compra
11 - Venda Perdida - Cliente desistiu da compra
12 - Veculo no disponvel - Comprou o veculo em
outro distribuidor Ford
13 - Veculo no disponvel - Comprou o veculo em
outro distribuidor
14 - Veculo no disponvel - Comprou o veculo de
outra marca
15 - Preo - Comprou o veculo em outro distribuidor
Ford
16 - Preo - Comprou o veculo em outro distribuidor
17 - Preo Comprou o veculo de outra marca
18 Condies de pagamento - Comprou o veculo
Ford Fcil Pg. 19/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

em outro distribuidor Ford


19 Condies de pagamento - Comprou o veculo
em outro distribuidor
20 - Condies de pagamento - Comprou o veculo
de outra marca
21 - Veculo usado mal avaliado - Comprou o
veculo em outro distribuidor Ford
22 - Veculo usado mal avaliado - Comprou o
veculo em outro distribuidor
23 - Veculo usado mal avaliado - Comprou o
veculo de outra marca
24 - Distribuido no compra veculo usado -
Comprou o veculo em outro distribuidor Ford
25 - Distribuido no compra veculo usado -
Comprou o veculo em outro distribuidor
26 - Distribuido no compra veculo usado -
Comprou o veculo de outra marca
27 - Crdito no Aprovado.
28 - Crdito no Aprovado - Comprou o veculo em
outro distribuidor Ford
29 - Crdito no Aprovado Comprou o veculo em
outro distribuidor
30 - Crdito no Aprovado - Comprou o veculo de
outra marca
44 ContactSourceId M int 1 1 - Prospeco
(Forma de Contato) 2 - Internet
3 - Showroom
4 - Telefone
45 TestDriveOffered M boolean 1 Indica se foi oferecido o Test Drive ( true ou false).
46 TestDriveTaken M boolean 1 Indica se foi feito Test Drive ( true ou false).
47 Activity ActivityCode O Integer 11 Cdigo da atividade na Ford.
(Cdigo da atividade)
48 Activity M String 8 Cdigo do Vendedor cadastrado na Ford.
SalesmanCode (Cdigo
do Vendedor)
49 Activity Date (Data da O DateTime 10 Data da criao da Atividade.
Atividade)
50 Activity TypeCode O Int 1 1 - Telefone
(Tipo de Atividade) 2 - Visita
3 - Email
4 - Atendimento
5 - Fax
6 - Test Drive
7 - Servios
51 Activity Description O String 400 Descrio da Atividade.
(Descrio)
52 Activity - StartTime O String 5 Hora de incio da atividade.
Formato dgitos hh:mm.
53 Activity - EndTime O String 5 Hora de fim da atividade.
Formato dgitos hh:mm.
54 Activity - O Int 1 1 - O cliente est interessado no veculo
ProspectionResultCode 2 - No foi possvel fazer contato diretamente com o
cliente
3 - O cliente foi contactado mas no est
interessado no veculo
Ford Fcil Pg. 20/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

4 - Informao do cliente est errada

15.1.2 Dicionrio de Dados da Resposta:

Layout Fluxo de Loja


ID Nome/Descrio Ind Tipo Dado Tamanho Observao
Dado Uso
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do Distribuidor M String 10 Exemplo: para DN 1234 -
Ford) SZBRA01234.
3 Code (Cdigo da Oportunidade Ford) O positiveInteger 11 Cdigo numrico da oportunidade
gerado pela Ford.
criado na insero e usado para
atualizar o fluxo de loja, e
posteriormente na criao do
pedido da venda.
4 DMSOpportunityCode (Cdigo do M String 11 Cdigo da oportunidade no
DMS) aplicativo do DMS.
5 ClientCode (Cdigo do Cliente) O int 11 Cdigo do cliente dentro da Ford.
6 LastActivityCode (ltima atividade) O Integer 11 Cdigo da ltima atividade na Ford.
7 Status M 1 1 - OK 2 - Error
8 Message O String 400 Mensagem do resultado.
Exemplo: Sucesso.

15.1.3 Validaes de Negcio

1. Status 2 - Caso seja uma nova oportunidade ( no update), e no exista uma Activity ,
o sistema exibe a mensagem: Oportunidade no possui atividades.
2. Status 3 - Caso sejam enviadas mais de 1 atividade sendo que duas (2) delas NO
possuam o campo Activity - EndTime ( agendamento), o sistema exibe a mensagem:
A lista de atividades possui algum agendamento que no o ltimo, ou existe mais que
um agendamento.
3. Status 4 Caso sejam enviadas mais que 1 atividade de agendamento, o sistema exibe
a mensagem: Existe mais que uma atividade de agendamento ao mesmo tempo.
4. Status 5 - Caso a atividade enviada NO possua o campo Activity - EndTime (
agendamento), porm a oportunidade esteja sendo fechada (StatusCode = 5) , o
sistema exibe a mensagem: A oportunidade foi fechada, logo no pode haver
agendamento.
5. Status 6 - Caso a atividade enviada possua o campo Activity - EndTime ( NO
agendamento), mas a oportunidade NO esteja sendo fechada (StatusCode = 5) , o
sistema exibe a mensagem: No existe atividade de agendamento.
6. Status 7 - Caso o StatusCode seja 5 (fechada) e no exista um motivo
CloseReasonCode , o sistema exibe a mensagem: A oportunidade est fechada mas
no foi informado o motivo.
7. Status 8 - Caso o valor Activity SalesmanCode no exista na base Ford, ou no
corresponda ao DN do DealerCode ,o sistema exibe a mensagem: O vendedor
informado invlido.
Ford Fcil Pg. 21/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

8. Status 9 Caso ocorra algum erro inesperado, o sistema exibe a exceo ocorrida
juntamente com a mensagem: Erro inesperado: ({0}).
9. Status 10 - Caso j exista uma oportunidade para o valor DMSOpportunityCode
enviado, o sistema exibe a mensagem: Uma oportunidade j existe para este cdigo
DMS({0})!\n Favor informar tambm o cdigo da oportunidade Ford correto para
update({1}).
10. Status 11 - Caso seja enviado um cdigo de atividade Activity ActivityCode invlido,
ou que no corresponda oportunidade, o sistema exibe a mensagem: Cdigo da
Atividade informada({0}) invlida para esta oportunidade!

Ford Fcil Pg. 22/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.2 Prospeco

WSDL:
wsdl/QueryLead.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/QueryLeadService
qa (com criptrografia): http://xgtwqa.ford.com/5015/QueryLeadService
produo ( somente criptografia): http://xgtw.ford.com/5015/QueryLeadService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
Ford Fcil Interface;

Frequncia:
A cada 15 minutos;

Horrio:
Esse servio estar disponivel de segunda sexta das 08:00 as 17:15;

Descrio:
Nesse servio o Ford Fcil disponibilizar LEADS para que o Distribuidor possa entrar
em contato;

Processo:
Atravs do site (www.ford.com.br) o cliente informa que deseja ser contactado pela Ford
para agendar uma visita a um Distribuidor e conhecer um determinado veiculo, nesse
momento a Central de Atendimento Ford (CAF) atravs do Ford Fcil, visualiza essa
solicitao, o atendente do CAF inicia o processo de contato com o cliente, para
confirmar o seu real interesse, caso isso seja confirmado, o atendente atualiza as
informaes do cliente e o Distribuidor que ele deseja ser contactado, aps o aceite do
cliente o Gerente do Distribuidor visualiza o LEAD e envia para o vendedor que dever
efetuar o contato, e informando todo contato, tudo atravs do Ford Fcil;
Todo processo do CAF parametrizado por tempos, o Ford Fcil faz controles de todas
as atividades e mostra para a atendente as ligaes que a mesma deve efetuar, aps a
confirmao das informaes pelo cliente o Distribuidor tem 1 hora e 30 minutos para
entrar em contato com o cliente, caso isso no ocorra, o CAF vai entrar em contato com
o Distribuidor e efetuar a cobrana;
O CAF trabalha de segunda sexta das 08:00 as 17:00 horas;

Ford Fcil Pg. 23/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Observao:
O sincronismo nessa interface muito importante para evitar acumulos de ligaes pelo
CAF ao Distribuidor, ou seja, o DMS dever executar essa interface de acordo com a
frequencia e horrio informados acima;

Gatilho:
Agendar um processo batch dentro do DMS para buscar os LEADS que o CAF j
efetuou o contato com o Cliente;

Ps-Condies:
O DMS receber a interface, validar o XML, processar e responder para o Ford Fcil
Interface que o registro foi carregado com sucesso, informando o cdigo do cliente
dentro do DMS;
Todo lead tambm considerado uma oportunidade, portanto todas as atividades
executadas sobre o lead devem ser enviadas ao Ford Fcil por meio da interface de
Fluxo de Loja, onde o cdigo da oportunidade Ford o mesmo cdigo do Lead;

15.2.1 Dicionrio de Dados da Requisio:


Layout Prospeco
ID Nome/Descrio Ind Uso Tipo Tama Observao
Dado Dado nho
1 DivisionCode (Cdigo da M int 1 1 USA
Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)

Ford Fcil Pg. 24/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.2.2 Dicionrio de Dados da Resposta:

Layout - Leads
ID Nome/Descrio Ind Uso Tipo Dado Tamanho Observao
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
3 Code (Cdigo da M positiveInteger 11 Cdigo numrico da oportunidade gerado pela
Oportunidade Ford) Ford.
Pode ser usado para atualizar oportunidade j
existente.
4 Customer - ClientCode M int 11 Cdigo do cliente dentro da Ford.
(Cdigo do Cliente)
5 Customer - FullName M String 35 Exemplo: Jos da Silva
(Nome Completo)
6 Customer - DOC1 M String 14 Exemplo: 012345678901
(Nmero do CPF / CNPJ)
7 Customer - DOC2 O String 14 Exemplo: 012345678
(Nmero RG / Inscrio
Estatual)
8 Customer - Gender O String 1 Valores M ou F.
(Sexo)
9 Customer - PersonType O String 1 1 - Pessoa Fisica
(Tipo de Cliente) 2 - Pessoa Juridica
10 Customer - Email M String 70 Exemplo: cliente@provedor.com.br
11 Customer - MaritalState O String 1 C - Casado
(Estado Civil) S - Solteiro
D - Divorciado
E - Separado
O - Outros
V - Viuvo
A - Amaziado
N - No sei
12 Customer - O String 1 0 - ANALFABETO
EducationDegree 1 - PRIMEIRO GRAU INCOMPLETO
(Escolaridade) (PRIMARIO)
2 - PRIMEIRO GRAU COMPLETO (PRIMARIO)
3 - SEGUNDO GRAU INCOMPLETO
(COLEGIAL)
4 - SEGUNDO GRAU COMPLETO (COLEGIAL)
5 SUPERIOR INCOMPLETO
6 - SUPERIOR COMPLETO
7 - POS-GRADUACAO
8 - MESTRADO
9 - DOUTORADO
13 Customer - BirthDate O DateTime 10 Data de nascimento do cliente.
(Data de Nascimento)
14 Customer - M String 40 Nome da rua da Residncia do Cliente.
HomeAddress - Street
(Nome da Rua)
Ford Fcil Pg. 25/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

15 Customer - M String 15 Nmero da Residncia do Cliente.


HomeAddress -
Number (Nmero do
Endereo)
16 Customer O String 50 Complemento do Endereo Residencial.
HomeAddress
Complement
(Complemento)
17 Customer M String 30 Cidade do Endereo Residencial.
HomeAddress City
(Cidade)
18 Customer M String 2 Sigla do estado do Endereo Residencial.
HomeAddress State
(Estado)
19 Customer M String 8 CEP do Endereo Residencial.
HomeAddress ZIP
(CEP)
20 Customer M String 60 Bairro do Endereo Residencial.
HomeAddress District
(Bairro)
21 Customer M Integer 2 Cdigo de rea do Telefone Residencial
HomePhone Area (Valores 11 at 99).
(Cdigo de rea)
22 Customer M Integer 10 Nmero do Telefone Residencial
HomePhone Number (Valor at 99999999).
(Nmero)
23 Customer O Integer 10 Ramal do Telefone Residencial.
HomePhone
Extension (Ramal)
24 Customer O String 2 01 = Empresrio
OccupationCode 02 = Assalariado
(Profisso) 03 = Autnomo
04 = Profissional Liberal
05 = Aposentado
06 = Produtor Rural
07 = Outros
25 Customer O Integer 2 Cdigo de rea do Telefone Comercial
BusinessPhone Area (Valores 11 at 99).
(Cdigo de rea)
26 Customer O Integer 10 Nmero do Telefone Comercial
BusinessPhone (Valor at 99999999).
Number (Nmero)
27 Customer O Integer 10 Ramal do Telefone Comercial.
BusinessPhone
Extension (Ramal)
28 Customer O Integer 2 Cdigo de rea do Telefone Alternativo
AlternativePhone (Valores 11 at 99).
Area (Cdigo de rea)
29 Customer O Integer 10 Nmero do Telefone Alternativo
AlternativePhone (Valor at 99999999).
Number (Nmero)
30 Customer O Integer 10 Ramal do Telefone Alternativo.
AlternativePhone
Extension (Ramal)
Ford Fcil Pg. 26/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

31 Customer - O String 40 Rua do endereo Comercial do Cliente.


BusinessAddress -
Street (Nome da Rua)
32 Customer - O String 15 Nmero do endereo Comercial do Cliente.
BusinessAddress -
Number (Nmero do
Endereo)
33 Customer O String 50 Complemento do Endereo Comercial.
BusinessAddress
Complement
(Complemento)
34 Customer O String 30 Cidade do Endereo Comercial.
BusinessAddress
City (Cidade)
35 Customer O String 2 Sigla do estado do Endereo Comercial.
BusinessAddress
State (Estado)
36 Customer O String 8 CEP do Endereo Comercial.
BusinessAddress ZIP
(CEP)
37 Customer O String 60 Bairro do Endereo Comercial.
BusinessAddress
District (Bairro)
38 Customer O String 11 Cdigo do cliente no aplicativo do DMS.
DMSClientCode (Cdigo
do Cliente DMS)
39 ModelCode (Modelo) M String 4 Cdigo do Modelo Ford ( TMA).
Exemplo: EUA ( Ecosport).

Ford Fcil Pg. 27/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.3 Venda

WSDL:
wsdl/SaleVehicle.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/SaleVehicleService
qa (com criptrografia): http://xgtwqa.ford.com/5015/SaleVehicleService
produo ( somente criptografia): http://xgtw.ford.com/5015/SaleVehicleService

Provedor de Servio:
Ford Fcil Interface

Provedor de Dados:
DMS

Frequncia:
Por demanda sempre que houver um pedido (negociao) ou na gerao da Nota Fiscal
(venda), ou por lote, respeitando o horrio de atendimento do Ford Fcil Interface.

Horrio:
Esse servio estar disponivel de segunda sabado, das 06:00 as 19:00 horas.

Descrio:
O DMS enviara a venda realizada no Distribuidor para o Ford Fcil Interface.

Observao:
Nessa interface poder existir dois tipos de envio: pedido e venda, a nica diferena
que no caso da venda as informaes da nota fiscal so mandatrias;
No existe diferena entre o XML do pedido e da venda, o Ford Fcil ir registrar como
uma negociao quando as informaes sobre a nota fiscal estar em branco, vai
considerar como venda quando as informaes da nota fiscal estiverem preenchidas;
No caso do pedido o Ford Fcil Interface, bloqueia o veiculo para o vendedor ;
O processamento da Nota Fiscal no DMS ser independente do envio dessa interface,
ela muito importante para bloquear o veiculo, pois quando o DMS enviar uma venda
sem nota fiscal o veiculo ficar bloqueado aguardando o envio da nota fiscal, isso dever
ocorrer atravs da mesma interface, nesse momento ser a concretizao da venda;
Caso o cliente desista da compra, o DMS poder cancelar o pedido/venda atravs da
interface cancelamento de venda (seguir as regras da interface de cancelamento);

Ford Fcil Pg. 28/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

S ser possivel efetuar um pedido ou venda para veiculos que estejam em transito (68),
estoque (80), reservado (82) - nesse caso o mrito da venda do pedido ou da venda
deve ser igual ao cdigo do vendedor que reservou o veiculo, negociado (90) - nesse
caso o mrito da venda da venda deve ser igual mrito da venda do pedido;
Caso o veiculo esteja bloqueado (84) ser necessrio efetuar o desbloqueio;
Para casos que o DMS j enviou a nota fiscal mas o Ford Fcil no processou o CVVG,
as informaes contidas na VENDA podero sero alteradas. Lembrando que o processo
de consolidao do CVVG inicia as 19:00 horas de segunda sbado.
Para casos que o DMS j enviou a nota fiscal e o Ford Fcil j processou o CVVG, s
ser permitida uma alterao e essa dever ser enviada at o ltimo dia do ms do
processamento do CVVG, desde que o cliente no seja alterado.

Pr-Condio:
O DMS dever enviar o Fluxo de Loja do cliente antes da venda, caso contrrio o Ford
Fcil Interface ir recusar essa venda;
O status do veiculo dever estar em 68, 80, caso o mesmo esteja em 82 (reservado), o
mrito da venda dever estar associado ao vendedor que reservou o veiculo;
Caso o veiculo esteja com status 90 (negociado), o mrito da venda dever estar
associado ao vendedor que negociou o veicuo;

Gatilho:
O DMS concluir um pedido ou uma venda de veiculo para um cliente;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML, e
efetua cadastro do pedido ou da venda;

15.3.1 Dicionrio de Dados da Requisio:


Layout - Venda
ID Nome/Descrio Ind Tipo Tamanho Observao
Dad Uso Dado
o
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do Distribuidor Ford) M String 10 Exemplo: para DN 1234 -
SZBRA01234.
3 PurchaseOrderCode (Cdigo do Pedido) O Integer 11 Cdigo do Pedido gerado pela
Ford. No enviado durante a
insero, porm usado para
atualizar o pedido j existente.

4 DMSPurchaseOrderCode (Cdigo do M String 10 Cdigo do Pedido gerado pelo


Ford Fcil Pg. 29/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

Pedido DMS) aplicativo DMS.


5 Date ( Data do Pedido) M Date 10 Data da Criao do Pedido.
6 InvoiceCustomerData FullName M String 35 Nome completo do Cliente na
(Nome Completo) Nota Fiscal.
7 InvoiceCustomerData - DOC1 (Nmero M String 14 Exemplo: 012345678901
do CPF / CNPJ)
8 InvoiceCustomerData - DOC2 (Nmero O String 14 Exemplo: 012345678
RG / Inscrio Estatual)
9 InvoiceCustomerData - Gender (Sexo) M String 1 Valores M ou F.
10 InvoiceCustomerData - PersonType M String 1 1 - Pessoa Fisica
(Tipo de Cliente) 2 - Pessoa Juridica
11 InvoiceCustomerData - Email O String 70 Exemplo:
cliente@provedor.com.br
12 InvoiceCustomerData - MaritalState M String 1 C - Casado
(Estado Civil) S - Solteiro
D - Divorciado
E - Separado
O - Outros
V - Viuvo
A - Amaziado
N - No sei
13 InvoiceCustomerData - M String 1 0 - ANALFABETO
EducationDegree (Escolaridade) 1 - PRIMEIRO GRAU
INCOMPLETO (PRIMARIO)
2 - PRIMEIRO GRAU
COMPLETO (PRIMARIO)
3 - SEGUNDO GRAU
INCOMPLETO (COLEGIAL)
4 - SEGUNDO GRAU
COMPLETO (COLEGIAL)
5 SUPERIOR INCOMPLETO
6 - SUPERIOR COMPLETO
7 - POS-GRADUACAO
8 - MESTRADO
9 - DOUTORADO
14 InvoiceCustomerData - BirthDate (Data M DateTime 10 Data de nascimento do cliente.
de Nascimento)
15 InvoiceCustomerData - HomeAddress - M String 40 Nome da rua da Residncia do
Street (Nome da Rua) Cliente.
16 InvoiceCustomerData - HomeAddress - M String 15 Nmero da Residncia do
Number (Nmero do Endereo) Cliente.
17 InvoiceCustomerData HomeAddress O String 50 Complemento do Endereo
Complement (Complemento) Residencial.
18 InvoiceCustomerData HomeAddress M String 30 Cidade do Endereo Residencial.
City (Cidade)
19 InvoiceCustomerData HomeAddress M String 2 Sigla do estado do Endereo
State (Estado) Residencial.
20 InvoiceCustomerData HomeAddress M String 8 CEP do Endereo Residencial.
ZIP (CEP)
21 InvoiceCustomerData HomeAddress M String 60 Bairro do Endereo Residencial.
District (Bairro)
22 InvoiceCustomerData HomePhone M Integer 2 Cdigo de rea do Telefone
Area (Cdigo de rea) Residencial
(Valores 11 at 99).
Ford Fcil Pg. 30/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

23 InvoiceCustomerData HomePhone M Integer 10 Nmero do Telefone Residencial


Number (Nmero) (Valor at 99999999).
24 InvoiceCustomerData HomePhone O Integer 10 Ramal do Telefone Residencial.
Extension (Ramal)
25 InvoiceCustomerData M String 2 01 = Empresrio
OccupationCode (Profisso) 02 = Assalariado
03 = Autnomo
04 = Profissional Liberal
05 = Aposentado
06 = Produtor Rural
07 = Outros
26 InvoiceCustomerData O Integer 2 Cdigo de rea do Telefone
BusinessPhone Area (Cdigo de rea) Comercial
(Valores 11 at 99).
27 InvoiceCustomerData O Integer 10 Nmero do Telefone Comercial
BusinessPhone Number (Nmero) (Valor at 99999999).
28 InvoiceCustomerData O Integer 10 Ramal do Telefone Comercial.
BusinessPhone Extension (Ramal)
29 InvoiceCustomerData O Integer 2 Cdigo de rea do Telefone
AlternativePhone Area (Cdigo de Alternativo
rea) (Valores 11 at 99).
30 InvoiceCustomerData O Integer 10 Nmero do Telefone Alternativo
AlternativePhone Number (Nmero) (Valor at 99999999).
31 InvoiceCustomerData O Integer 10 Ramal do Telefone Alternativo.
AlternativePhone Extension (Ramal)
32 InvoiceDate (Data da Nota Fiscal) O Date 10 Data da Nota Fiscal.
Opcional caso enviados Data e
Nmero da Nota Fiscal, o pedido
Ford confirmado.
Do contrrio, o pedido fica em
aberto, aguardando confirmao
e podendo ser alterado.
OBS: aps confirmado, no se
pode mais atualizar os dados do
pedido.
33 InvoiceNumber (Nmero da Nota Fiscal) O String 6 Nmero da Nota Fiscal.
Opcional caso enviados Data e
Nmero da Nota Fiscal, o pedido
Ford confirmado.
Do contrrio, o pedido fica em
aberto, aguardando confirmao
e podendo ser alterado.
OBS: aps confirmado, no se
pode mais atualizar os dados do
pedido.
34 VIN (Chassi) M String 17 Nmero do Chassi Ford.
35 StandardPrice (Preo do Veiculo) M float 13.2 Preo que o Distribuidor est
comercializando o veiculo.
Compe o valor da nota fiscal:
Invoice value = standard price
- discount value +
accessories( se includedInNF) =
down payment + used vehicles +
financing.

Ford Fcil Pg. 31/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Exemplo: Veiculo est disponivel


para venda no valor 50.000,00
reais (tabela de preos praticado
pelo distribuidor).
36 DiscountValue ( Desconto) O Float 13.2 Valor do desconto sobre e
espcie.
Compe o valor da nota fiscal:
Invoice value = standard price -
discount value +
accessories( se includedInNF) =
down payment + used vehicles +
financing .
Exemplo: Veiculo est disponivel
para venda no valor 50.000,00
reais (tabela de preos praticado
pelo distribuidor) que concedeu
um desconto de 1.000,00 reais
(referente ao pagamento de
IPVA).
37 Comments ( Comentrio) O String 255 Comentrios adicionais.
38 OpportunityCode (Cdigo da M Integer 11 Cdigo da Oportunidade Ford
Oportunidade) criado durante Fluxo de Loja.
39 StockTypeCode ( Tipo de Estoque) M Integer 1 1 - Estoque
2 - Pedidos confirmados
40 SalesmanCode (Vendedor Ford) M String 8 Cdigo do Vendedor Ford.
Deve estar vlido dentro do
FordFcil.
41 CustomerDataSourceType (Origem dos M String 1 Que dados de cliente utilizar no
Dados do CVVG) CVVG:
C - Dados do cadastro do cliente
do fluxo de loja (Oportunidade)
I - Dados do cliente na Nota
Fiscal (Venda)
42 DownPaymentList Type (Tipo de O String 2 1 - Espcie (Dinheiro)
Pagamento) 3 - Cheque
4 TED (Transf. Elet.Disponvel)
5 - DOC (Documento de Crdito)
6 - Carto de crdito
7 Boleto bancrio
8 - Carta de crdito
9 - Milhas (Cia. Area)
10 - Pontuao carto FORD
UNICARD
43 DownPaymentList Value (Valor do O float 13.2 Valor do Pagamento do
Pagamento) adiantamento.
Pode compor o valor da nota
fiscal:
Invoice value = standard price -
discount value + accessories( se
includedInNF) = down payment
+ used vehicles + financing.

44 DownPaymentList Date (Data do O Date 10 Data do Pagamento do


Pagamento) adiantamento.
45 UsedVehicleList LicenseCode (Placa O String 7 Placa do Veculo Usado.
Ford Fcil Pg. 32/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

do Veculo)
46 UsedVehicleList Brand (Marca) O String 30 Marca do Veculo Usado.
47 UsedVehicleList ModelName (Nome do O String 30 Nome do Modelo do Veculo
Modelo) Usado.
48 UsedVehicleList ProductionYear (Ano O Year 4 Ano de Produo do Veculo
de Produo) Usado.
49 UsedVehicleList ModelYear (Ano de O Year 4 Ano do Modelo do Veculo
Produo) Usado.
50 UsedVehicleList Fuel (Combustvel) O String 1 G gasolina
A - lcool
D - diesel
F - flex
N no definido
51 UsedVehicleList Color (Cor) O String 17 Cor do Veculo Usado.
52 UsedVehicleList VIN (Chassi) O String 23 Nmero do Chassi do Veculo
Usado.
53 UsedVehicleList OwnerName (Nome O String 40 Nome do Dono do veculo usado.
do Dono)
54 UsedVehicleList Value (Valor) O float 13.2 Valor do veculo usado.
Pode compor o valor da nota
fiscal:
Invoice value = standard price -
discount value + accessories( se
includedInNF) = down payment +
used vehicles + financing.

55 AcessoryList AccessoryCode (Cdigo O String 22 Cdigo do Acessrio.


do Acessrio)
56 AcessoryList Value (Valor do Acessrio) O float 13.2 Preo do Acessrio.
Valores: true ou false.
Pode compor o valor da nota
fiscal, caso a flag IncludedInNF
seja true:
Invoice value = standard price -
discount value + accessories( se
includedInNF) = down payment +
used vehicles + financing.

57 AcessoryList IncludedInNF (Incluso na M Boolean 1 Flag que indica se o preo do


Nota Fiscal) acessrio ser incluso (somado)
ao valor da Nota Fiscal.
58 ServiceList Code (Cdigo) O String 4 1 - Teto solar
2 Seguro
3 Cristalizao
4 Despachante
5 Blindagem
6 - Teto Solar Special
7 - Pelicula 1
8 - Pelicula 2
9 Impermeabilizao
10 - Bancos em couro
59 ServiceList Value (Valor) O float 13.2 Preo do Servio.
Nunca ser incluso no valor da
Nota Fiscal.
Ford Fcil Pg. 33/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

60 FinancingData - Value O float 13.2 Valor Financiado.


Pode compor o valor da nota
fiscal:
Invoice value = standard price -
discount value + accessories( se
includedInNF) = down payment +
used vehicles + financing.

61 FinancingData - Terms 0 Integer 3 Nmero de parcelas.


62 FinancingData - Coeficient O float 15.11 Valor do coeficiente da taxa de
juros do financiamento.
63 FinancingData - BankCode O String 2 0 - Ford Credit
1 - Banespa
2 - Safra
3 - Itau
4 - Alpha
5 - Safra - Leasing
6 - Itau - Leasing
7 - Alpha - Leasing
8 - Banespa - Leasing
9 - Bradesco
10 - Finasa
11 - Abn Amro Real
12 - Citibank
13 - Dibens
14 - Brasil
15 Mercantil do Brasil
16 - Mercantil Finasa
17 - Panamericano
18 - Santander Brasil S.A
19 - Santander Noroeste S.A
20 - Sudameris Brasil
21 - BankBoston Multiplo
22 - BankBoston N.A.
23 - Caixa Economica Federal
24 - Citibank N.A.
25 - HSBC Bank Brasil S.A.
26 - Nossa Caixa
27 - Unibanco Uniao de Bancos
28 - Outros Bancos
35 - Banco Votorantim S.A.
36 - HSBC - Leasing
37 - Banco do Estado do Rio
Grande
38 - HSBC Bank Brasil S.A. - 1
39 HSBC Bank Brasil S.A. - 2
40 - Itau - Leasing - 1
41 - Itau - Leasing - 2
42 - Safra - Leasing - 1
43 - Safra - Leasing - 2
44 - AMAURI ADM. DE
CONSRCIO S/C
45 - CARBURGO ADM DE
CONSRCIO LTDA
46 - Bradesco consrcios LTDA

Ford Fcil Pg. 34/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

47 - Alpha
48 - Distribuidor
49 - UNICRED BCO.
COOPERATIVO SICRE
50 - BANESTES - B. E. Esprito
Sant
51 - Santander Banespa S.A.
52 - Sudameris Arrend Mercantil
S/A
64 FinancingData - MonthlyPaymentValue O float 13.2 Valor das parcelas de pagamento
mensal.

15.3.2 Dicionrio de Dados da Resposta:


Layout - Venda
ID Dado Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Uso Dado
1 DivisionCode (Cdigo da M int 1 1 USA
Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
3 PurchaseOrderCode M Integer 11 Cdigo do Pedido gerado pela Ford.
(Cdigo do Pedido) criado na insero e usado para atualizar o
pedido.
4 DMSPurchaseOrderCode M String 11 Cdigo do Pedido gerado pelo aplicativo DMS.
(Cdigo do Pedido DMS)
5 Status M int 1 Resultado do Processamento do pedido.
1 - OK
2 - Error
6 Message O String 400 Mensagem informativa sobre o status.

15.3.3 Validaes de Negcio

1. Status 3 - Caso o pedido informado para atualizao j esteja com status 'Cancelado', o
sistema exibe a mensagem: Este pedido j foi cancelado.
2. Status 5 - Caso algum dos campos abaixo no seja enviado, o sistema exibe a seguinte
mensagem: O campo {0} obrigatrio. Segue lista de campos:
a. InvoiceDate(+InvoiceNumber)
b. InvoiceNumber(+InvoiceDate)
c. InvoiceCustomerData/FullName
d. InvoiceCustomerData/DOC1,DOC2
e. InvoiceCustomerData/HomeAddress/Street
f. InvoiceCustomerData/HomeAddress/Number
g. InvoiceCustomerData/HomeAddress/ZIP
h. InvoiceCustomerData/HomePhone/Area
i. InvoiceCustomerData/HomePhone/Number
j. InvoiceCustomerData/PersonType
Ford Fcil Pg. 35/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

k. SalesmanCode
l. OpportunityCode
m. StandardPrice
n. VIN
3. Status 5 - Caso o campo UsedVehicleList seja informado, e algum dos campos abaixo
no seja enviado, o sistema exibe a seguinte mensagem: O campo {0} obrigatrio.
a. UsedVehicleList/Brand
b. UsedVehicleList/Color
c. UsedVehicleList/Fuel
d. UsedVehicleList/LicenseCode
e. UsedVehicleList/ModelName
f. UsedVehicleList/ModelYear
g. UsedVehicleList/OwnerName
h. UsedVehicleList/ProductionYear
i. UsedVehicleList/Value
j. UsedVehicleList/VIN
4. Status 6 - Caso seja um novo pedido ( no update), porm j exista um pedido vlido
( no cancelado) para a oportunidade informada (OpportunityCode), o sistema exibe a
mensagem: Um pedido vlido j existe para esta oportunidade.
5. Status 7 - Caso a oportunidade informada no exista (OpportunityCode), o sistema
exibe a mensagem: A oportunidade informada no existe.
6. Status 10 - Caso o pedido informado para atualizao possua o cdigo do chassi VIN
diferente do pedido original, o sistema exibe a mensagem: O campo VIN no pode ser
alterado.
7. Status 12 - Caso seja informado o pedido PurchaseOrderCode, ou seja, uma
atualizao ( update), porm a oportunidade (OpportunityCode) no corresponda ao
pedido, o sistema exibe a mensagem: Proposta deste pedido no a mesma para a
oportunidade informada.
8. Status 13 - Caso o pedido informado para atualizao j esteja com status 'Aprovado', o
sistema exibe a mensagem: Um pedido aprovado no pode ser alterado, apenas
cancelado.
9. Status 103 - Caso a soma dos adiantamentos DownPaymentList Value, mais os
veculos usados UsedVehicleList Value, mais o financiamento FinancingData -
Value seja menor que a soma do preo pblico StandardPrice, menos o desconto
DiscountValue , o sistema exibe a mensagem: O total pago ({0}) menor que o valor da
nota fiscal ({1}). \n Invoice value = standard price - discount value + accessories( se
included) = down payment + used vehicles + financing . \n Servios NO so levados
em conta!
10. Status 104 - Caso no campo financiamento o valor FinancingData - Value seja menor
que zero, ou cdigo do banco FinancingData - BankCode seja nulo, ou coeficiente
FinancingData - Coeficient seja menor que zero, ou nmero de parcelas
FinancingData - Terms seja menor que zero, ou o pagamento mensal FinancingData -
MonthlyPaymentValue seja menor que zero, o sistema exibe a mensagem:
Inconsistncia nos dados de financiamento. As informaes de financiamento devem ser
vlidas, ou no devem ser enviadas.
11. Status 105 - Caso no campo adiantamento o valor DownPaymentList Value seja
menor que zero, ou a data DownPaymentList Date seja nula, o sistema exibe a
Ford Fcil Pg. 36/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

mensagem: Inconsistncia nos dados do adiantamento. Algum valor ou data pode estar
nulo ou o valor zero ou negativo.
12. Status 106 - Caso no campo acessrios, o valor AcessoryList Value seja menor que
zero ou a resposta AcessoryList IncludedInNF no seja vlida, o sistema exibe a
mensagem: Inconsistncia nos dados de acessrios. Verifique se so vlidos para o
modelo do chassi informado, ou se alguma valor est nulo, zero ou negativo.
13. Status 107 Caso no seja informado o cdigo da oportunidade OpportunityCode, o
sistema exibe a mensagem: Falta a identificao da oportunidade.
14. Status 108 Caso no seja informado o cdigo do vendedor SalesmanCode, o sistema
exibe a mensagem: Falta a identificao do vendedor.
15. Status 109 Caso no seja informado o preo pblico StandardPrice, o sistema exibe
a mensagem: Falta o preo pblico.
16. Status 111 - Caso o chassi informado no campo VIN no esteja mais disponvel para a
venda, o sistema exibe a mensagem: Este veculo no est disponvel para venda.
17. Status 112 - Caso o cdigo do vendedor SalesmanCode do pedido seja de um DN
diferente do cdigo do vendedor informado no fluxo de loja da oportunidade
OpportunityCode, o sistema exibe a mensagem: Cdigo do Dealer({0}) do
vendedor({1}) diferente daquele na oportunidade!

Ford Fcil Pg. 37/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.4 Cancelamento Pedido

WSDL:
wsdl/CancelPurchaseOrder.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/CancelPurchaseOrderSe
rvice
qa (com criptrografia): http://xgtwqa.ford.com/5015/CancelPurchaseOrderService
produo ( somente criptografia):
http://xgtw.ford.com/5015/CancelPurchaseOrderService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Por demanda;

Horrio:
Esse servio estar disponivel de segunda sabado, das 06:00 as 19:00 horas;

Descrio:
Aps o processamento da Venda pelo Ford Fcil Interface essa interface poder ser
acionada pelo DMS para o Cancelamento de uma ou mais Vendas;
No sero processados os cancelamentos de Venda, que j resultaram em um CVVG e
que o CAF ainda no fez o cancelamento;
Todos cancelamentos do CAF sero refletidos no Ford Fcil Interface, no prximo dia til;

Pr-Condio:
Existir uma venda processada pelo Ford Fcil Interface;

Gatilho:
O DMS processar um cancelamento de pedido ou venda;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML, e
processa o cancelamento do pedido;

Ford Fcil Pg. 38/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.4.1 Dicionrio de Dados da Requisio:


Layout Cancelar Venda
ID Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Dado Uso Dado
1 DivisionCode (Cdigo da M int 1 1 USA
Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
3 PurchaseOrderCode (Cdigo M Integer 11 Cdigo do Pedido gerado pela Ford. No enviado
do Pedido) durante a insero, porm usado para atualizar o
pedido j existente.

4 DMSPurchaseOrderCode M String 11 Cdigo do Pedido gerado pelo aplicativo DMS.


(Cdigo do Pedido DMS)

15.4.2 Dicionrio de Dados da Resposta:


Layout Cancelar Venda
ID Dado Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Uso Dado
1 DivisionCode (Cdigo da M int 1 1 USA
Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
3 PurchaseOrderCode M Integer 11 Cdigo do Pedido gerado pela Ford.
(Cdigo do Pedido) criado na insero e usado para atualizar o
pedido.
4 DMSPurchaseOrderCode M String 11 Cdigo do Pedido gerado pelo aplicativo DMS.
(Cdigo do Pedido DMS)
5 Status M int 1 Resultado do Processamento do cancelamento.
1 - OK
2 - Error
6 Message O String 400 Mensagem informativa sobre o status.

Ford Fcil Pg. 39/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.4.3 Validaes de Negcio

1. Status 3 - Caso o pedido informado j tenha sido cancelado anteriormente, o sistema


exibe a mensagem : Este pedido j foi cancelado.
2. Status 4 - Caso o pedido informado j tenha sido processado com CVVG, o sistema
exibe a mensagem : O CVVG j foi processado.
3. Status 11 - Caso o pedido PurchaseOrderCode enviado para cancelamento no seja
encontrado na base Ford, o sistema exibe a mensagem: Pedido no encontrado na base
de dados.

Ford Fcil Pg. 40/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.5 Consulta CVVG

WSDL:
wsdl/QueryCVVG.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/QueryCVVGService
qa (com criptrografia): http://xgtwqa.ford.com/5015/ QueryCVVGService
produo ( somente criptografia): http://xgtw.ford.com/5015/ QueryCVVGService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
Ford Fcil Interface;

Frequncia:
Por demanda;

Horrio:
Esse servio estar disponivel de segunda sabado, das 06:00 as 19:00 horas;

Descrio:
O DMS envia essa interface para o Ford Fcil Interface, disponibilizar as informaes
sobre os veiculos que foram vendidos pelo distribuidor, e j foram processados pela
Ford, ou seja, aps o processamento do CVVG;
A consulta de CVVG poder ser parametrizada atravs da identificao (nmero) do
chassi ou por data de processamento e uma lista de cdigos de distribuidores (um
distribuidor s pode consultar cvvg's de outros distribuidores do mesmo grupo);

Pr-Condio:
Existir uma CVVG processado pelo Ford Fcil Interface;

Gatilho:
O DMS necessita verificar o processamento de gerao de CVVG das vendas que foram
enviadas para o Ford Fcil Interface;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa e responde para o DMS com as informaes referentes ao chassis.

Ford Fcil Pg. 41/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.5.1 Dicionrio de Dados da Requisio:


Layout CVVG (By VIN)
ID Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Dado Uso Dado
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo do Distribuidor M String 10 Exemplo: para DN 1234 - SZBRA01234.
Ford)

Dicionrio de Dados da Requisio:


Layout CVVG (By Date)
ID Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Dado Uso Dado
1 Date ( Data dos CVVG's) M Date 10 1
2 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do Distribuidor M String 10 Exemplo: para DN 1234 - SZBRA01234.
Ford)

15.5.2 Dicionrio de Dados da Resposta:


Layout - CVVG (By VIN ou Date)
ID Nome/Descrio Ind Tipo Tamanho Nome/Descrio
Dado Uso Dado
1 DivisionCode (Cdigo da M int 1 1 USA
Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo do M String 10 Exemplo: para DN 1234 - SZBRA01234.
Distribuidor Ford)
4 Date ( Data do CVVG) M DateTime 10 Data do CVVG.
5 ErrorId ( Erro FordFcil) O String 5 Cdigo de erro, caso este tenha ocorrido no
FordFcil.
6 ErrorSamis ( Erro Samis) O String 5 Cdigo de erro, caso este tenha ocorrido no
Samis.
7 InvoiceDate ( Data da Nota) M DateTime 10 Data da Nota Fiscal
8 InvoiceNumber (Nmero da M String 6 Nmero da Nota Fiscal
Ford Fcil Pg. 42/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

Nota)
9 SalesmanDOC1 ( CPF do M String 14 CPF do vendedor.
vendedor)
10 SalesmanName ( Nome do M String 110 Nome do vendedor.
Vendedor)
11 Status ( Status do CVVG) M String 1 Status do CVVG.

Ford Fcil Pg. 43/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.6 Recebimento de veculo

WSDL:
wsdl/ReceiveVehicle.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/ReceiveVehicleService
qa (com criptrografia): http://xgtwqa.ford.com/5015/ReceiveVehicleService
produo ( somente criptografia): http://xgtw.ford.com/5015/ReceiveVehicleService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Por demanda ou necessitar atualizar o seu estoque dentro do Ford Fcil;

Horrio:
Esse servio estar disponivel de segunda domingo, 24 horas por dia;

Descrio:
Nesse servio o DMS ir informar ao Ford Fcil os veculos que foram recebidos
fisicamente no estoque do Distribuidor;

Observao:
Nessa interface o DMS os veculos que estavam em trnsito (68) e chegaram ao estoque
do distribuidor, sero alterados para estoque (80) dentro do Ford Fcil;
O Ford Fcil Interface processar os chassis que tiverem o estado alterado de trnsito
para estoque e enviar a confirmao de alterao de estado como resposta;
O DMS ir informar ao Ford Fcil Interface os veculos que que esto bloqueados, com
isso, o seu desbloqueio tambm dever ser feito pela interface;
Incluir uma flag no DMS nos veiculos que esto na inteface, para que o mesmo veiculo
no seja enviado vrias vezes;

Pr-Condio:
Existir veiculos no DMS que foram recebidos fisicamente e que no foram enviados para
o Ford Fcil;

Gatilho:
Ford Fcil Pg. 44/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

Agendar um processo batch dentro do DMS para buscar as informaes sobre o


recebimento fisico de veiculos, que no foram enviados para o Ford Fcil;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa a interface;
15.6.1 Dicionrio de Dados da Requisio:
Layout - Recebimento
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)

15.6.2 Dicionrio de Dados da Resposta:

Layout - Recebimento
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)
4 Status M int 1 Resultado do Processamento do recebimento.
1 - OK
2 - Error
5 Message O String 400 Mensagem informativa sobre o status.

15.6.3 Validaes de Negcio

1. Status 3 - Caso tente fazer o recebimento que no esteja no status 'Em Trnsito', o
sistema apresenta a mensagem : Veculo no est no status 'em trnsito'.
2. Status 10 - Caso o chassi VIN informado no exista na base Ford, o sistema apresenta
a mensagem: Veculo no encontrado na base de dados.

Ford Fcil Pg. 45/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.7 Consulta de estoque

WSDL:
wsdl/QueryStock.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/QueryStockService
qa (com criptrografia): http://xgtwqa.ford.com/5015/QueryStockService
produo ( somente criptografia): http://xgtw.ford.com/5015/QueryStockService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
Ford Fcil Interface;

Frequncia:
Por demanda, sempre que o DMS necessitar consultar um chassi, ou necessitar atualizar
o seu estoque;

Horrio:
Esse servio estar disponivel de segunda domingo, das 08:00 as 21:00 horas;

Descrio:
Nesse servio o Ford Fcil ir disponibilizar os veiculos que a Ford faturou, ou
informaes de um determinado chassi;

Observao:
A consulta pode ser feita filtrando-se por nmero de chassi (at um limite de 100 chassis)
ou por cdigo identificador do distribuidor (desde que o cdigo seja de um distribuidor do
grupo), nesse caso a consulta ir retornar em que estado est o veiculo: 68 (transito), 80
(estoque), 82 (reservado), 84 (bloqueado), 90 (negociado), 100 (aguardando aprovao),
110 (CVVG);
Para consultas por cdigo de distribuidor, sero retornados apenas os chassis que se
encontrarem no estado de trnsito (68), ou seja, veiculos que a Ford faturou e j sairam
do ptio e esto a caminho do Distribuidor;
O DMS dever informar o Ford Fcil atravs da interface de Recebimento de Veiculos, os
veiculos que esto fisicamente no Distribuidor, com isso o seu estado ser alterado para
80 (estoque);
O DMS dever informar o Ford Fcil atravs da interface de Reserva de Veiculos, os
veiculos que devero ser reservados por duas horas, com isso o seu estado ser
alterado para 82 (reservado);
Ford Fcil Pg. 46/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

O DMS dever informar o Ford Fcil atravs da interface de Bloqueio de Veiculos, os


veiculos que devero ser bloqueados no Distribuidor, com isso o seu estado ser
alterado para 84 (bloqueado);

Gatilho:
Agendar um processo batch dentro do DMS para buscar as informaes sobre o estoque
do distribuidor dentro do Ford Fcil;
No caso de consultas especificas de chassi, essa interface poder ser solicitada por
demanda, conforme a necessidade do DMS, respeitando o horrio do servio;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa e envia a resposta com as informaes do chassi;

15.7.1 Dicionrio de Dados da Requisio:


Layout - Consulta de Estoque (By VIN)
ID Nome/Descrio Ind Uso Tipo Tamanho Observao
Dado Dado
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo do Distribuidor M String 10 Exemplo: para DN 1234 -
Ford) SZBRA01234.

Dicionrio de Dados da Requisio:


Layout - Consulta de Estoque (By Dealer)
ID Nome/Descrio Ind Uso Tipo Tamanho Observao
Dado Dado
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
3 Argentina
4 Venezuela
2 DealerCode (Cdigo do Distribuidor Ford) M String 10 Exemplo: para DN 1234 -
SZBRA01234.

15.7.2 Dicionrio de Dados da Resposta:


Layout - Consulta de Estoque (By VIN ou Dealer)
ID Nome/Descrio Ind Uso Tipo Tamanho Observao
Dado Dado
1 DivisionCode (Cdigo da Diviso) M int 1 1 USA
2 Brazil (default)
Ford Fcil Pg. 47/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

3 Argentina
4 Venezuela
2 DealerCode (Cdigo do Distribuidor Ford) M String 10 Exemplo: para DN 1234 -
SZBRA01234.
3 VIN (Chassi) M String 23 Nmero do Chassi do
Veculo.
4 Status ( Status do Veculo) M Integer 2 65 - Faturado Ford
68 - Transito
80 - Estoque
82 - Reservado
84 - Bloqueado
90 - Negociao
100 - Faturado
110 - CVVG
5 ModelCode (Cdigo do Modelo Ford) M String 4 Cdigo do Modelo Ford
(TMA).
6 Version (Cdigo da Verso Ford) M String 4 Cdigo da Verso Ford.
7 Catalog (Cdigo do Catlogo Ford) M String 4 Cdigo do Catlogo ou
Package Ford.
8 ExternalColor (Cor Externa) M String 4 Cdigo da cor externa Ford.
9 InternalColor (Cor Interna) M String 3 Cdigo da cor interna Ford.
10 ProductionYear (Ano de Produo) M Year 4 Ano de Produo do
veculo.
11 ModelYear (Ano do Modelo) M Year 4 Ano do Modelo do veculo.
12 Fuel (Combustvel) M String 1 G - gasolina
A - lcool
D - diesel
F - flex
N no definido
13 Engine (Motor) M String 8 Cdigo do Motor Ford.

Ford Fcil Pg. 48/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.8 Reserva de veculo

WSDL:
wsdl/ReserveVehicle.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/ReserveVehicleService
qa (com criptrografia): http://xgtwqa.ford.com/5015/ReserveVehicleService
produo ( somente criptografia): http://xgtw.ford.com/5015/ReserveVehicleService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Por demanda;

Horrio:
Esse servio estar disponivel de segunda domingo, 24 horas por dia;

Descrio:
Nesse servio o DMS ir informar ao Ford Fcil os veculos que sero reservados no
Ford Fcil;

Processo:
Dentro do Ford Fcil o vendedor ao iniciar o atendimento de um cliente pode reservar um
veiculo, isso se faz necessrio, para que outro vendedor no consiga negociar o mesmo
veiculo, essa reserva tem validade de duas horas;

Observao:
Essa interface ser muito importante caso seja utilizado as duas arquiteturas, o Ford
Fcil e o Ford Fcil Interface, porque o risco existe se o DMS estiver negociando um
determinado veiculo e no tiver informado o Ford Fcil Interface e outro vendedor estiver
utilizando o Ford Fcil, poder negociar o mesmo veiculo pois o estoque no estar
sincronizado.
Caso o Distribuidor s utilize o Ford Fcil Interface essa interface no ser necessria,
pois o estoque estar somente no DMS;
Caso o vendedor desejar efetuar uma reserva maior que duas horas, o mesmo dever
entrar em contato com o gerente e pedir o bloqueio do veiculo no DMS, dessa forma o
veiculo no ser negociado para mais nenhum vendedor. O DMS ir enviar a interface
Ford Fcil Pg. 49/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

bloqueio de veiculos para bloquear o veiculo, com isso esse veiculo no poder ser mais
negociado, para que isso seja possivel o gerente dever efetuar o desbloqueio no DMS,
que tambm ir enviar a interface de desbloqueio;
S ser possivel efetuar uma reserva para veiculos que estejam em estoque (80) ou em
transito (68);
Pr-Condio:
Existir veiculos no estoque do DMS e do Ford Fcil liberados para negociao;

Gatilho:
O DMS dever informar on-line o Ford Fcil Interface quando o vendedor reservar o
veiculo;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa a reserva do veiculo;

15.8.1 Dicionrio de Dados da Requisio:


Layout Reserva de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)
4 SalesmanCode M String 8 Cdigo do Vendedor na Ford.
(Cdigo do Vendedor)
5 LockStartDate (Data M DateTime 15 Data e hora do incio da reserva.
de incio)

15.8.2 Dicionrio de Dados da Resposta:


Layout - Reserva de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)
4 Status M int 1 Resultado do Processamento da reserva.
1 - OK
2 - Error
Ford Fcil Pg. 50/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

5 Message O String 400 Mensagem informativa sobre o status.

15.8.3 Validaes de Negcio

3. Status 10 - Caso o chassi VIN informado no exista na base Ford, o sistema apresenta
a mensagem: Veculo no encontrado na base de dados.
4. Status 11 - Caso o veculo informado j esteja reservado ou bloqueado por outro
vendedor, o sistema apresenta a mensagem: Veculo j foi bloqueado por outro
vendedor.
5. Status 12 - Caso o campo vendedor SalesmanCode no seja informado, o sistema
apresenta a mensagem : Falta identificao do vendedor 'salesman'.
6. Status 13 - Caso o vendedor SalesmanCode informado no seja vlido para o grupo do
DN, o sistema apresenta a mensagem : Vendedor invlido.
7. Status 14 - Caso o veculo possua um pedido em aberto, ou seja, em status 'Em
Negociao', o sistema apresenta a mensagem : Veculo est no status 'negociao'.
8. Status 15 - Caso o veculo possua um pedido confirmado, ou seja, em status 'Faturado',
o sistema apresenta a mensagem: Veculo est no status 'faturado'.
9. Status 16 - Caso o veculo possua CVVG processado, ou seja, em status 'CVVG', o
sistema apresenta a mensagem: Veculo est no status 'CVVG'.
10. Status 17 - Caso data de incio da reserva LockStartDate seja menor que a data
corrente, o sistema apresenta a mensagem: Data informada menor que o presente.

Ford Fcil Pg. 51/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.9 Bloqueio de veculo

WSDL:
wsdl/BlockVehicle.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/BlockVehicleService
qa (com criptrografia): http://xgtwqa.ford.com/5015/BlockVehicleService
produo ( somente criptografia): http://xgtw.ford.com/5015/BlockVehicleService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Por demanda;

Horrio:
Esse servio estar disponivel de segunda domingo, 24 horas por dia;

Descrio:
Nesse servio o DMS ir informar ao Ford Fcil os veculos que sero bloqueados no
Ford Fcil;

Processo:
Dentro do Ford Fcil o gerente pode bloquear um veiculo por um determinado periodo,
isso se faz necessrio, para que esse veiculo no seja negociado, somente o gerente
poder desbloquear, ou ser desbloqueado automticamente pelo Ford Fcil repeitando
a data para desbloqueio que o Gerente informou;

Observao:
Essa interface ser muito importante caso seja utilizado as duas arquiteturas, o Ford
Fcil e o Ford Fcil Interface, porque o risco existe se o DMS estiver negociando um
determinado veiculo e no tiver informado o Ford Fcil Interface e outro vendedor estiver
utilizando o Ford Fcil, poder negociar o mesmo veiculo pois o estoque no estar
sincronizado.
Caso o Distribuidor s utilize o Ford Fcil Interface essa interface no ser necessria,
pois o estoque estar somente no DMS;
Todo veiculo loqueado (84) no Ford Fcil, no permite uma negociao, at que o
mesmo seja desbloqueado: automaticamente ou pelo gerente, caso o Ford Fcil Interface
Ford Fcil Pg. 52/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

receba as interfaces de reserva de veiculo, venda e bloqueio, as mesmas sero


recusadas;
S ser possivel efetuar um bloqueio para veiculos que estejam em estoque (80) ou em
transito (68);

Pr-Condio:
Existir veiculos no estoque no DMS e do Ford Fcil liberados para negociao;

Gatilho:
O DMS dever informar on-line o Ford Fcil Interface quando o gerente bloquear o
veiculo;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa o bloqueio do veiculo;

15.9.1 Dicionrio de Dados da Requisio:


Layout Bloqueio de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)
4 SalesmanCode M String 8 Cdigo do Vendedor na Ford.
(Cdigo do Vendedor)
5 LockStartDate (Data M DateTime 15 Data e hora do incio da reserva.
de incio)
6 LockEndDate (Data M DateTime 15 Data e hora do final da reserva.
de incio)

15.9.2 Dicionrio de Dados da Resposta:


Layout Bloqueio de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)

Ford Fcil Pg. 53/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

4 Status M int 1 Resultado do Processamento do bloqueio.


1 - OK
2 - Error
5 Message O String 400 Mensagem informativa sobre o status.

15.9.3 Validaes de Negcio

1. Status 7 - Caso a data final de bloqueio LockEndDate no seja informada, o sistema


apresenta a mensagem : Data final 'End date' no pode ser nula para o bloqueio de
veculo.
2. Status 9 - Caso a data final de bloqueio LockEndDate informada seja menor que a data
inicial SalesmanCode , o sistema apresenta a mensagem : Data final 'End date' no
pode ser maior que Data inicial 'start date'.
3. Status 10 - Caso o chassi VIN informado no exista na base Ford, o sistema apresenta
a mensagem: Veculo no encontrado na base de dados.
4. Status 11 - Caso o veculo informado j esteja reservado ou bloqueado por outro
vendedor, o sistema apresenta a mensagem: Veculo j foi bloqueado por outro
vendedor.
5. Status 12 - Caso o campo vendedor SalesmanCode no seja informado, o sistema
apresenta a mensagem : Falta identificao do vendedor 'salesman'.
6. Status 13 - Caso o vendedor SalesmanCode informado no seja vlido para o grupo do
DN, o sistema apresenta a mensagem : Vendedor invlido.
7. Status 14 - Caso o veculo possua um pedido em aberto, ou seja, em status 'Em
Negociao', o sistema apresenta a mensagem : Veculo est no status 'negociao'.
8. Status 15 - Caso o veculo possua um pedido confirmado, ou seja, em status 'Faturado',
o sistema apresenta a mensagem: Veculo est no status 'faturado'.
9. Status 16 - Caso o veculo possua CVVG processado, ou seja, em status 'CVVG', o
sistema apresenta a mensagem: Veculo est no status 'CVVG'.
10. Status 17 - Caso alguma data informada (LockStartDate, bbb ) seja menor que a data
corrente, o sistema apresenta a mensagem: Data informada menor que o presente.

Ford Fcil Pg. 54/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.10Desbloqueio de veculo

WSDL:
wsdl/UnlockVehicle.wsdl;

URL's:
qa (sem criptografia):
https://wwwqa.fordfacil.dealerconnection.com/CRMRetail/UnlockVehicleService
qa (com criptrografia): http://xgtwqa.ford.com/5015/UnlockVehicleService
produo ( somente criptografia): http://xgtw.ford.com/5015/UnlockVehicleService

Provedor de Servio:
Ford Fcil Interface;

Provedor de Dados:
DMS;

Frequncia:
Por demanda;

Horrio:
Esse servio estar disponivel de segunda domingo, 24 horas por dia;

Descrio:
Nesse servio o DMS ir informar ao Ford Fcil os veculos que sero desbloqueados no
Ford Fcil;

Processo:
Dentro do Ford Fcil o gerente pode desbloquear um veiculo que ele bloqueou, isso se
faz necessrio, para que esse veiculo volte para o estoque e possa ser negociado,
somente o gerente poder desbloquear, ou ser desbloqueado automticamente pelo
Ford Fcil repeitando a data para desbloqueio que o Gerente informou;

Observao:
Essa interface ser muito importante caso seja utilizado as duas arquiteturas, o Ford
Fcil e o Ford Fcil Interface, porque o risco existe se o DMS estiver negociando um
determinado veiculo e no tiver informado o Ford Fcil Interface e outro vendedor estiver
utilizando o Ford Fcil, poder negociar o mesmo veiculo pois o estoque no estar
sincronizado.
Caso o Distribuidor s utilize o Ford Fcil Interface essa interface no ser necessria,
pois o estoque estar somente no DMS;
S ser possivel efetuar um desbloqueio para veiculos que estejam em bloqueados (84);

Ford Fcil Pg. 55/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Pr-Condio:
Existir veiculos no estoque no DMS e no Ford Fcil bloqueados;

Gatilho:
O DMS dever informar on-line o Ford Fcil Interface quando o gerente desbloquear o
veiculo;

Ps-Condio:
O Ford Fcil Interface faz o recebimento da interface, efetua a validao do XML,
processa o desbloqueio do veiculo;

15.10.1 Dicionrio de Dados da Requisio:


Layout Desbloqueio de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)

15.10.2 Dicionrio de Dados da Resposta:


Layout - Desbloqueio de Veiculo
ID Dado Nome/Descrio Ind Uso Tipo Tamanho Nome/Descrio
Dado
1 DivisionCode (Cdigo M int 1 1 USA
da Diviso) 2 Brazil (default)
3 Argentina
4 Venezuela
2 VIN (Chassi) M String 23 Nmero do Chassi do Veculo.
3 DealerCode (Cdigo M String 10 Exemplo: para DN 1234 - SZBRA01234.
do Distribuidor Ford)
4 Status M int 1 Resultado do Processamento do desbloqueio.
1 - OK
2 - Error
5 Message O String 400 Mensagem informativa sobre o status.

Ford Fcil Pg. 56/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

15.10.3 Validaes de Negcio

1. Status 4 - Status Caso o veculo informado no esteja bloqueado ou reservado, o


sistema apresenta a mensagem: Veculo no se encontra reservado ou bloqueado.
2. Status 10 - Caso o chassi VIN informado no exista na base Ford, o sistema apresenta
a mensagem: Veculo no encontrado na base de dados.

16 Status dos Veiculos

68 (Transito)
o Veiculo foi faturado pela Ford e est em transito, j est no
distribuidor aguardando o recebimento.
80 (Estoque)
o Veiculo foi recebido pelo distribuidor.
82 (Reservado)
o Veiculo reservado pelo vendedor por duas horas o desbloqueio
automtico.
84 (Bloqueado)
o Veiculo bloqueado pelo gerente por uma data determinada, caso
no ocorra um desbloqueio manual, o mesmo ir ocorrer
automticamente na data determinada.
90 (Negociao)
o Veiculo negociado pelo vendedor, o mesmo emitiu um pedido mas
no foi concretizada a venda, ou no foi emitida a nota fiscal. Para o
Ford Fcil esse veiculo est em negociao at a emisso da nota
fiscal, o veiculo fica bloqueado at a concretizao da venda ou por
um cancelamento de pedido.

100 (Venda)
o Veiculo negociado pelo vendedor, o mesmo emitiu um pedido foi
concretizada a venda, e emitida a nota fiscal.
110 (CVVG)
o Veiculo consolidado no Ford Fcil com as demais reas da Ford
(garantia, bonus, etc), essa consolidao efetuada de segunda
sabado das 21:00 as 23:00.

Ford Fcil Pg. 57/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

17 Importar certificado com chave pblica - .p7b ( entidade


externa).

-entrar no Internet Explorer -> tools -> internet options :

- aba content -> certificates :

Ford Fcil Pg. 58/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- aba " Other People"-> Import :

Ford Fcil Pg. 59/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- next :

Ford Fcil Pg. 60/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

browse, no combo de tipos escolher PKCS #7 ( .p7b) e selecionar o certificado :

Ford Fcil Pg. 61/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

next :

Ford Fcil Pg. 62/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

Automatically... :

Ford Fcil Pg. 63/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- finish :

Ford Fcil Pg. 64/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

-successfull :

Ford Fcil Pg. 65/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

18 Importar certificado com chave privada - .pfx ( pessoal).

- duplo clique no arquivo .pfx, next :

Ford Fcil Pg. 66/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- confirmar o arquivo, next :

Ford Fcil Pg. 67/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- digite a senha e marque a opo "...exportable." :

Ford Fcil Pg. 68/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- selectione a opo "Automatically..." :

Ford Fcil Pg. 69/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- finish, successfull :

Ford Fcil Pg. 70/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- Verifique o certificado. Entre no Internet Explorer -> tools -> internet options :

- aba content -> certificates :

Ford Fcil Pg. 71/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- aba "Personal" :

Ford Fcil Pg. 72/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- clique no boto view -> aba Details -> Subject e verifique as propriedades do certificado :

Ford Fcil Pg. 73/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

19 Exportar certificado com chave privada

-entrar no Internet Explorer -> tools -> internet options :

- aba content -> certificates :

- aba Personal -> Export :


Ford Fcil Pg. 74/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

Ford Fcil Pg. 75/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- ao abrir o wizard -> next :

Ford Fcil Pg. 76/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- export private key :

Ford Fcil Pg. 77/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- checar "include all certificates" :

Ford Fcil Pg. 78/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- crie uma senha ( ex.: webservice) :

Ford Fcil Pg. 79/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- d o nome ( ex.: <nome dealer>_priv_cert ) :

Ford Fcil Pg. 80/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- finish :

Ford Fcil Pg. 81/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

20 Exportar somente chave publica

-entrar no Internet Explorer -> tools -> internet options :

- aba content -> certificates :

- aba Personal -> Export :


Ford Fcil Pg. 82/89 Data verso 03/05/2017
Ford Fcil Interface
______________________________________________________________________________________________

Ford Fcil Pg. 83/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- ao abrir o wizard -> next :

Ford Fcil Pg. 84/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- do not export private key :

Ford Fcil Pg. 85/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- PKCS #7 Certificate. Checar "include all certificates" :

Ford Fcil Pg. 86/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- d o nome ( ex.: <nome dealer>_publ_cert ) :

Ford Fcil Pg. 87/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

- finish:

Ford Fcil Pg. 88/89 Data verso 03/05/2017


Ford Fcil Interface
______________________________________________________________________________________________

21 Sobre a documentao

parte desta documentao o arquivo FFInterface.zip, que contm os arquivos XML de


requisio e resposta.

Ford Fcil Pg. 89/89 Data verso 03/05/2017