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 AgendorO 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:

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.

Integração do clienteO 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.

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

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:

Cliente

Hospital Campo customizado hospital

Convênio Campo customizado convenio

Paciente Campo customizado paciente

Data da cirurgia Campo wonAt do negócio

Médico Campo customizado medico

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]”

Data de cadastro Data atual

Código legado Formado pelo prefixo “agendor-” + id do negócio no Agendor

Observações do agendamento Campo personalizado “grade_da_cirurgia”

Procedimento Campo personalizado “procedimento_cirurgico” Caso o procedimento não exista no V2, é automaticamente criado.

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.