--- url: https://developers.zarv.com/integrations/locavia.md description: >- Integração do SmartFlow com a Locavia: cadastro automático de cliente e condutor, contrato pendente, distribuição de filiais, estoque e a tela Contratos. --- # Locavia A integração com a Locavia, ERP de locação de veículos, transforma um lead **aprovado** no SmartFlow em cadastro e, se você quiser, em contrato pendente na sua conta Locavia. ## Antes de começar * Uma conta Locavia sua: **Organização** (CNPJ), **Usuário** e **Senha**. Cada campanha tem a sua conexão e a sua credencial. * **Integração ativa** ligada pelo administrador do workspace em Configurações › Marketplace. Veja [Conectar e ativar](/integrations/connect-and-activate). * O catálogo de filiais sincronizado: use **Sincronizar agora** na **Visão geral**. Sem isso, o painel mostra "Nenhuma filial sincronizada…". * Na campanha, um campo personalizado para a forma de pagamento e, se for usar planos, outro para o plano/tarifa. ## O que acontece A integração roda no evento `lead.approved`. Para cada lead aprovado: 1. **Cliente.** Busca pelo CPF. Se não existe, cria. Se existe sem contato, acrescenta o e-mail e o telefone do lead como contato principal. 2. **Condutor.** Cria o condutor com os dados da CNH (a cidade é resolvida por nome e estado). Se já existe, reaproveita. 3. **Foto da CNH.** Anexa ao condutor. Se já estava anexada, pula. 4. **Contrato.** Só se o **Registro de contrato (automático)** estiver ligado. Cria um contrato mestre de assinatura (CaaS) com um item da tarifa mapeada, a forma de pagamento, a filial e um **local de retirada provisório**. Se o cliente já tem contrato de assinatura, pula. O contrato nasce pendente. O local provisório existe porque a Locavia recusa contrato sem local de retirada. O local definitivo é ajustado na Locavia ao fechar o contrato. O cadastro (cliente, condutor e CNH) é automático e vale para todo o workspace; só o contrato espera uma filial. Contratos exigem o cadastro ligado: "Ative o cadastro automático para criar contratos." ## Configuração O painel da Locavia tem quatro abas: **Visão geral**, **Cadastro**, **Contrato** e **Status**. ### Cadastro A aba tem a chave **Registro de cadastro (automático)** ("Cada lead aprovado vira um cadastro em Locavia."), o bloco **Configurações** ("Padrões de cadastro desta conta Locavia, salvos junto com o fluxo"), a chave **Notificar por email** e o bloco **Mapeamento de dados**. | Campo | Onde | Obrigatório | O que é | | ---------------------------- | ------------------- | ----------- | --------------------------------------------------------------------------- | | Categorias do cliente | Configurações | Sim | Padrão da conta. | | Tipo de endereço | Configurações | Sim | **Residencial** ou **Comercial**. | | Modelo do veículo | Configurações | - | Padrão da conta. | | Forma de pagamento (cliente) | Mapeamento de dados | Sim | Campo da campanha mapeado para os códigos de forma de pagamento da Locavia. | O **Mapeamento de dados** diz como os campos do fluxo preenchem o cadastro em Locavia. ### Contrato A aba tem a chave **Registro de contrato (automático)** ("Além do cadastro, cria o contrato em Locavia."), o bloco **Configurações** (distribuição, filiais, tarifas e estoque), o aviso **Contratos pendentes**, a chave **Notificar por email** e o **Mapeamento de dados**. | Campo | Onde | O que é | | ----------------------------- | ------------------- | ------------------------------------------------------------------------------------------------ | | Filiais | Configurações | Quais filiais recebem os contratos desta campanha; cada uma mostra o selo "Recebe contratos". | | Local de retirada padrão | Configurações | Um por filial, escolhido ao lado da filial. O padrão é **Automático**: um local ativo da filial. | | Tarifas | Configurações | Cada tarifa mostra "Válida em: {filiais}" ou "Não atende nenhuma filial deste fluxo". | | Plano → Tarifa | Mapeamento de dados | Como o plano do lead vira uma tarifa. | | Forma de pagamento (contrato) | Mapeamento de dados | Forma de pagamento do contrato. | ### Distribuição de filiais | Modo | Comportamento | | ----------- | --------------------------------------------------------------------------------------------------------------- | | Filial fixa | Todos os contratos vão para uma filial. | | Rodízio | Alterna entre as filiais marcadas (mínimo 2): "Os contratos se revezam entre as filiais marcadas (mínimo 2)." | | Manual | Exige ao menos 1 filial. Cada cadastro aprovado espera na tela **Contratos** até um operador escolher a filial. | Com uma única filial, o seletor de modo some e a campanha é salva como fixa. Uma filial é elegível quando a tarifa está habilitada nela e ela tem ao menos um local de retirada ativo. ### Estoque Os dois ajustes ficam na aba **Contrato**. | Configuração | Quem | Detalhe | | ----------------------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Atualização do estoque das filiais | Conexão (só administrador) | 15 min, 30 min (padrão), 1 h, 2 h ou 6 h. "Com que frequência o estoque de cada filial é consultado na locadora." | | Segurar contratos quando a filial estiver sem estoque | Campanha | Desligado por padrão e oculto no modo manual. "Enquanto a filial escolhida não tiver veículo disponível, o contrato fica em Contratos como "Aguardando estoque"." | Um veículo conta como disponível só quando o status dele na Locavia é "Disponível" (código D). O estoque é por filial e modelo de veículo, e só as contagens são guardadas. * Se a sincronização falha, vale a última contagem. Se a última boa tem mais de 3 vezes o intervalo, o estoque fica "desconhecido" e nunca bloqueia. * **Atualizar agora**, na tela **Contratos** (ao lado de "Estoque atualizado às …"), força a sincronização (espera de 60 s entre cliques, qualquer membro). * Escolher uma filial com estoque zero conhecido é recusado: "Filial sem estoque para: {nomes}". Não há como forçar. Escolher mais leads do que veículos é permitido. ### E-mails | Campo | Quando é enviado | | -------------------------------------- | --------------------------------------------------------------------------------------- | | **Notificar por email** (aba Cadastro) | "Enviado quando o cadastro é aprovado e registrado na Locavia." Depois do cadastro. | | **Notificar por email** (aba Contrato) | "Enviado quando o contrato é registrado na Locavia." Há opção de **E-mail por filial**. | Em cada chave, informe os destinatários no campo abaixo e separe vários endereços por vírgula ("Separe vários e-mails por vírgula."). Com o cadastro automático desligado, nenhum e-mail é enviado. O e-mail de falha vai para os mesmos destinatários quando um envio esgota as tentativas. ## Operação do dia a dia * **Visão geral:** o bloco **Funcionalidades** (Cria cadastro, Cria contrato, Roteamento e Notificações, cada um com o selo **Ligado** ou **Desligado**) e o **Resumo de envios** com Cadastros criados, Contratos criados, Contratos pendentes e Com falha. A aba **Contrato** mostra o contador de contratos pendentes. * **Status:** **Envios deste fluxo**, cada um como **Falhou**, **Enviado** ou **Reenviando**, com as ações de reenvio. ### Tela Contratos A tela **Contratos** (item do menu) reúne os envios das campanhas. * Filtros: **Situação do envio** (**Não enviado** e **Enviado**), **Fluxos** e **Filial**; a busca ("Buscar por nome ou CPF completo") aceita nome ou CPF completo. Os CPFs aparecem mascarados. * A tabela tem as colunas **Nome**, **Fluxo**, **Plano / tarifa**, **Aprovado em** e **Filial**. Em cada linha, a lista **Escolha a filial** mostra o estoque por filial elegível (por exemplo, "Filial Centro · 4 disponíveis"). Acima da tabela, "Estoque atualizado às …" e **Atualizar agora**. | Ação | O que faz | | ----------------- | ---------------------------------------------------------------------------------------------- | | Gerar contrato | Escolha a filial e gere, em lote, os contratos selecionados (a barra mostra "N selecionados"). | | Reenviar cadastro | Idempotente. | | Reenviar contrato | Refaz o contrato. É idempotente. | Se os leads selecionados não compartilham filial: "Nenhuma filial atende a todos os selecionados." Ao trocar uma campanha de manual para fixa ou rodízio, o admin pergunta "Liberar contratos pendentes?". ### Retentativas Cada etapa guarda o resultado, então um reenvio continua de onde parou. Quando um envio esgota as tentativas, você recebe o e-mail de falha uma única vez. As regras de entrega do webhook estão em [Webhook da campanha](/sdk/webhooks). ## Limites * O contrato precisa de um local de retirada, por isso nasce com um provisório. * Uma CNH recapturada depois do primeiro anexo não é reenviada. * A sincronização de estoque lê até 5.000 veículos; uma frota maior faz a sincronização falhar. * A cidade é casada por nome e estado.