# Agendor

<span data-contrast="auto">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é.</span><span data-ccp-props="{}"> </span>

<span data-contrast="auto">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.</span><span data-ccp-props="{}"> </span>

#### **<span data-contrast="none">Pré requisitos  
</span>**

<span data-contrast="none">Para realizar a integração com o Agendor, é preciso:  
</span>

- <span data-contrast="none"><span data-contrast="none">Um token de integração no Agendor  
    O token de integração deve ser obtido na interface do Agendor:  
      
    </span></span>[![image-1737337263866.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337263866.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337263866.png)
    
    [![image-1737337352310.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337352310.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337352310.png)
- <span data-contrast="none">Uma assinatura paga do Agendor, para poder utilizar os campos customizados</span>
- <span data-contrast="none">A contratação do módulo no sistema V2Saúde</span>

#### **<span data-contrast="none">Configurações  
</span>**

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.

[![image-1737337326911.png](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/scaled-1680-/image-1737337326911.png)](https://wiki.v2saude.com.br/uploads/images/gallery/2025-01/image-1737337326911.png)

#### **<span data-contrast="none">Fluxo de integração  
</span>**

<span data-contrast="auto">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.</span><span data-ccp-props="{}"> </span>

- <span data-contrast="auto">A API do Agendor é executada no endpoint: /deals/stream?dealStatus=2&amp;since=\[DATA\]T00:00:00Z&amp;withCustomFields=true</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Este endpoint retorna os negócios ganhos recentemente desde a data especificada.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Por padrão, a aplicação irá fornecer a data do dia anterior para filtrar os negócios</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Para cada negócio retornado pela, API, a aplicação irá executar as seguintes ações:</span>   
    <span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

1. <span data-contrast="auto">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.</span>
2. Integração do cliente  
    <span data-contrast="auto">O negócio do Agendor pode ter uma Organization ou uma Person, para pessoas jurídicas e físicas respectivamente.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">Se o cliente não for encontrado, ele é cadastrado no V2.  
      
    </span>
3. <span data-contrast="auto">Integração dos produtos</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">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.  
    </span><span data-contrast="auto">Se o produto não for encontrado, uma observação é gravada no orçamento informando que o produto não foi localizado</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">. </span><span data-contrast="auto">Importante: Não são cadastrados produtos no V2</span>
4. <span data-contrast="auto">Integração da cirurgia</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">O negócio do Agendor é integrado no V2 como cirurgia.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span><span data-contrast="auto">Alguns campos customizados do Agendor são utilizados no V2 para preencher as informações da cirurgia.  
    Os seguintes campos são integrados:  
    </span>

1. <span data-contrast="auto">Cliente</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>
2. <span data-contrast="auto">Hospital</span>   
    <span data-contrast="auto">Campo customizado hospital</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
3. <span data-contrast="auto">Convênio</span>   
    <span data-contrast="auto">Campo customizado convenio</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
4. <span data-contrast="auto">Paciente</span>   
    <span data-contrast="auto">Campo customizado paciente</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
5. <span data-contrast="auto">Data da cirurgia</span>   
    <span data-contrast="auto">Campo wonAt do negócio</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
6. <span data-contrast="auto">Médico</span>   
    <span data-contrast="auto">Campo customizado medico</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
7. <span data-contrast="auto">Observação</span>   
    <span data-contrast="auto">Observações da integração do deal.</span>   
    <span data-contrast="auto">Este campo é formado pelo campo description do negócio e pelo sufixo “Criada a partir do Agendor: \[url do deal no agendor\]”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
8. <span data-contrast="auto">Data de cadastro</span>   
    <span data-contrast="auto">Data atual</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
9. <span data-contrast="auto">Código legado</span>   
    <span data-contrast="auto">Formado pelo prefixo “agendor-” + id do negócio no Agendor</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
10. <span data-contrast="auto">Observações do agendamento</span>   
    <span data-contrast="auto">Campo personalizado “grade\_da\_cirurgia”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
      
    </span>
11. <span data-contrast="auto">Procedimento</span>   
    <span data-contrast="auto">Campo personalizado “procedimento\_cirurgico”</span>   
    <span data-contrast="auto">Caso o procedimento não exista no V2, é automaticamente criado.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}">   
    </span>
12. <span data-contrast="auto">Vendedor</span>   
    <span data-contrast="auto">Campo personalizado “vendedor”</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

#### **<span data-contrast="none">Integração dos clientes</span>**<span data-ccp-props="{"134233117":false,"134233118":false,"134245418":true,"134245529":true,"335559738":281,"335559739":281}"> </span>

<span data-contrast="auto">Durante o processo de integração das cirurgias, a aplicação irá verificar se o cliente existe pelo CNPJ ou CPF.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

<span data-contrast="auto">Caso o cliente não exista, ele é cadastrado no V2 utilizando os campos do Agendor.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

<span data-contrast="auto">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.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

***<span data-contrast="none">Campos obrigatórios no cadastro do cliente:</span>***<span data-ccp-props="{"134233117":false,"134233118":false,"134245418":true,"134245529":true,"335559738":319,"335559739":319}"> </span>

- <span data-contrast="auto">Nome</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Razão Social (Para clientes PJ)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">CPF (Para clientes PF)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">CNPJ (Para clientes PJ)</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Inscrição Estadual (Para clientes PJ)</span>   
    <span data-contrast="auto">Neste caso, o campo customizado de inscrição estadual é utilizado. Caso não seja informado no Agendor, o sistema irá preencher automaticamente “ISENTO”.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">E-mail</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Telefone</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Endereço completo</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>

- <span data-contrast="auto">Cidade / Estado</span>   
    <span data-contrast="auto">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.</span>   
    <span data-contrast="auto">Caso a cidade não exista no V2, haverá erro de integração da cirurgia.</span><span data-ccp-props="{"134233117":false,"134233118":false,"335559738":240,"335559739":240}"> </span>