Agendor

A integração do V2Saúde com o Agendor, realiza a integração dos deals ganhos do Agendor como cirurgias aprovadas no estágio de orçamento pré. 

Durante a integração do deal do Agendor com a cirurgia no V2Saúde, o sistema irá criar a cirurgia com os dados do Agendor, registrar os itens do orçamento e, se necessário, cadastrar o cliente caso não seja encontrado no sistema. 

Pré requisitos

Para realizar a integração com o Agendor, é preciso:

• Um token de integração no Agendor
  O token de integração deve ser obtido na interface do Agendor:
  
  

  
  
  
  
  

  

• Uma assinatura paga do Agendor, para poder utilizar os campos customizados
• A contratação do módulo no sistema V2Saúde

Configurações

Após a geração do token no Agendor e contratação do mõdulo no sistema, basta configurar a integração.
As configurações da integração são definidas no cadastro da empresa, aba Integrações.

 

Fluxo de integração

Para a integração de orçamentos, é importante mencionar que os produtos informados no Agendor precisam ter exatamente a mesma referência que o V2Saúde. A integração não cadastra novos produtos no V2. 

• A API do Agendor é executada no endpoint: /deals/stream?dealStatus=2&since=[DATA]T00:00:00Z&withCustomFields=true 

• Este endpoint retorna os negócios ganhos recentemente desde a data especificada. 

• Por padrão, a aplicação irá fornecer a data do dia anterior para filtrar os negócios 

• Para cada negócio retornado pela, API, a aplicação irá executar as seguintes ações: 
   

1. Verifica se o deal do Agendor já foi cadastrado como cirurgia através de seu código legado. O código legado é composto pelo prefixo “agendor-” e o id do negócio no Agendor. Se uma cirurgia com o código legado já existir, ela não é integrada novamente e o processo segue para o próximo negócio da lista. 
   
   
2. Integração do cliente
   O negócio do Agendor pode ter uma Organization ou uma Person, para pessoas jurídicas e físicas respectivamente. 
   Se o cliente não for encontrado, ele é cadastrado no V2.
   
   
3. Integração dos produtos 
   Para cada produto informado no deal, a aplicação verifica se o produto existe no V2 com a referência do fabricante informada no campo  “code” do produto no Agendor.
   Se o produto não for encontrado, uma observação é gravada no orçamento informando que o produto não foi localizado. Importante: Não são cadastrados produtos no V2 
   
   
4. Integração da cirurgia 
   O negócio do Agendor é integrado no V2 como cirurgia.
   Alguns campos customizados do Agendor são utilizados no V2 para preencher as informações da cirurgia.
   Os seguintes campos são integrados:
   

1. Cliente 
2. Hospital 
   Campo customizado hospital 
   
   
3. Convênio 
   Campo customizado convenio 
   
   
4. Paciente 
   Campo customizado paciente 
   
   
5. Data da cirurgia 
   Campo wonAt do negócio 
   
   
6. Médico 
   Campo customizado medico 
   
   
7. Observação 
   Observações da integração do deal. 
   Este campo é formado pelo campo description do negócio e pelo sufixo “Criada a partir do Agendor: [url do deal no agendor]” 
   
   
8. Data de cadastro 
   Data atual 
   
   
9. Código legado 
   Formado pelo prefixo “agendor-” + id do negócio no Agendor 
   
   
10. Observações do agendamento 
    Campo personalizado “grade_da_cirurgia” 
    
    
11. Procedimento 
    Campo personalizado “procedimento_cirurgico” 
    Caso o procedimento não exista no V2, é automaticamente criado. 
    
12. Vendedor 
    Campo personalizado “vendedor” 

Integração dos clientes 

Durante o processo de integração das cirurgias, a aplicação irá verificar se o cliente existe pelo CNPJ ou CPF. 

Caso o cliente não exista, ele é cadastrado no V2 utilizando os campos do Agendor. 

No Agendor, o cadastro do cliente deve conter os campos obrigatórios no V2 para que o cadastrado possa ser completado. Do contrário a cirurgia não será integrada. 

Campos obrigatórios no cadastro do cliente: 

• Nome 

• Razão Social (Para clientes PJ) 

• CPF (Para clientes PF) 

• CNPJ (Para clientes PJ) 

• Inscrição Estadual (Para clientes PJ) 
  Neste caso, o campo customizado de inscrição estadual é utilizado. Caso não seja informado no Agendor, o sistema irá preencher automaticamente “ISENTO”. 

• E-mail 

• Telefone 

• Endereço completo 

• Cidade / Estado 
  A cidade e estado no Agendor são campos texto. A cidade precisa ser informada exatamente como registrada no V2. Não serão aceitas cidades abreviadas, ex: S. Paulo, ou estados com UF inválida. 
  Caso a cidade não exista no V2, haverá erro de integração da cirurgia.