Integrações da API V2Saúde

O V2Saúde possui uma API que permite a integração de sistemas externos.
Esta página descreve as funções disponíveis da API.

Convenções deste documento

URL Base
Sempre que os termos URL Base ou URL_BASE forem utilizados, estamos nos referindo ao endereço de acesso do V2Saúde utilizado pela empresa. Por exemplo: https://minhaempresa.v2saude.com.br

Autenticação

A autenticação de nossa API é realizada através de Token JWT, que deve ser gerado antes da chamadas subsequentes.

Chamada de autenticação
Método HTTP: POST
URL: URL_BASE/auth/login

Exemplo de requisição:

{
  "username": "machado.de.assis@minhaempresa.v2saude.com.br",
  "password": "capitu"
}

Exemplo de resposta:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c3VhcmlvSWQiO...",
  "usuario": { ... }
}

O campo accessToken deve ser utilizado como token de autenticação nas chamadas da API.
O valor de accessToken deve ser enviado no Header "Authorization" junto à palavra Bearer.
Exemplo:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ

Clientes e fornecedores

Consultar pelo CPF
Método HTTP: GET
URL: URL_BASE/v2-api/clientefornecedor/cpf/{cpf}
Descrição: Retorna os dados do cliente ou fornecedor pelo CPF informado. O documento deve ser enviado sem formatação.

Consultar pelo CNPJ
Método HTTP: GET
URL: URL_BASE/v2-api/clientefornecedor/cnpj/{cnpj}
Descrição: Retorna os dados do cliente ou fornecedor pelo CNPJ informado.O documento deve ser enviado sem formatação.

Cirurgias

Cadastro
Método HTTP: POST
URL: URL_BASE/v2-api/cirurgia/

Exemplo de requisição:

{
    "cliente": 80733,
    "responsavel": null,
    "paciente": "TESTE 1",
    "matriculaPaciente": null,
    "medico": null,
    "medicoCRM": null,
    "instrumentadoresAvulsos": null,
    "cirurgia": "TESTE",
    "data": "2022-04-15",
    "hospital": "TESTE HOSPITAL",
    "observacao": null,
    "horaCirurgia": "18:00",
    "convenio": "AMIL"
}