Especificação técnica para integração com o Easyvet X SGV
Manual ilustrativo para sistemas terceiros se comunicarem com o Easyvet via JSON.
Versão | Proprietário | Nota | Data |
|---|---|---|---|
1.0 | @Renan Mitsuo Oka | Criação de documento | 10/12/2020 |
1.1 | @Renan Mitsuo Oka | Inclusão do campo ficha e alteração do desenho fluxo de trabalho | 11/12/2020 |
1.2 | @Renan Mitsuo Oka | Inclusão de URL API e alteração de ex. Json | 26/01/2021 |
1.3 | @Renan Mitsuo Oka | Inclusão dos testes via postman | 27/01/2021 |
1.4 | @Renan Mitsuo Oka | Inclusão de URL de visualização de laudo | 28/01/2021 |
1.5 | @Renan Mitsuo Oka | Inclusão de requisitos | 01/02/2021 |
1.6 | @Renan Mitsuo Oka | Alteração de URL | 03/02/2021 |
1.7 | @Renan Mitsuo Oka | Inclusão do retorno de cod. barras no json retorno. | 09/02/2021 |
1.8 | @Renan Mitsuo Oka | Inclusão de campo na rotina de retorno da etiqueta de cod. de barras, alteração do desenho de fluxo de trabalho | 10/02/2021 |
1.9 | @Renan Mitsuo Oka | Correção do json de envio inclusão e alteração incluido campo ficha | 24/02/2021 |
2.0 | @Renan Mitsuo Oka | Inclusao da regra de ficha + convenio | 26/02/2021 |
2.1 | @Renan Mitsuo Oka | Inclusão do campo nomevet | 08/03/2021 |
2.2 | @Renan Mitsuo Oka | Inclusão de novos tubos | 09/03/2021 |
2.3 | @Renan Mitsuo Oka | Inclusão de campo obs_grupo1, campo deverá conter o material a ser enviado ao selecionar OUTROS. | 11/03/2021 |
2.4 | @Renan Mitsuo Oka | Inclusão de mensagens de retorno | 17/05/2021 |
2.5 | @Renan Mitsuo Oka | Inclusão de URL envia SGV | 09/11/2022 |
2.6 | @Renan Mitsuo Oka | Inclusão de campo empresa_id | 07/06/2023 |
3.0 | @Renan Mitsuo Oka | Inclusão de campo sistema | 02/12/2024 |
URL DE API Produção e Homologação
Produção
https://portal4.softeasy.com.br/api/recebeRequisicaoVet
Homologação
http://portal4.softeasy.com.br/api/recebeRequisicaoVet
Requisitos de integração
Deverá ser mapeado o De/para de cad. clinica no SGV (Cada unidade terá seu código de cadastro de clinica).
Deverá ser mapeado o De/para de raça e especie.
Deverá ser mapeado o De/para de exames.
TERMO DE CONFIDENCIALIDADE
Este documento é de propriedade da SOFTEASY. As informações aqui contidas são confidenciais e têm caráter técnico e informativo.
O mesmo não poderão ser copiadas ou reproduzidas sem a autorização da Softeasy.
Instrução
O uso da tecnologia json permite a comunicação indireta entre o sistema de gestão veterinária e os diversos sistemas utilizados pelos laboratórios de apoio ou terceirizados, tornando o processo de envio de exames e recebimento de resultados mais ágil, rápido e seguro.
Pré-requisitos do sistema de laboratório para integração
O sistema o laboratório de apoio ou terceiro deverá disponibilizar um json que fará a comunicação com o Easyvet.
Para criação deste json, foi disponibilizado o manual Processo de envio, alteração e exclusão de solicitação de exames.
O sistema do laboratório de apoio ou terceiro deverá ser capaz de enviar e receber os dados do tutor, exames, materiais, conforme cadastrados no sistema de gestão veterinária Easyvet.
Desenho de fluxo de dados
Dados a serem trafegados no processo
Os dados a serem integrados, envolvem dados de solicitação de exames, conforme modelos abaixo:
Requisição de solicitação
O método a ser criado no json do sistema do laboratório terceiro deverá ser capaz de enviar os seguintes dados:
Solicitação de inclusão | |||
Parâmetros | Formato | Obrigatório | Descrição |
nome | String(50) | SIM | Nome do animal |
proprietario | String(50) | SIM | Nome do proprietário(Tutor) |
anos | string(3) | SIM | Idade de vida do animal |
meses | string(2) | NÃO | Meses de vida do animal |
dias | string(2) | NÃO | Dias de vida do animal |
crmvet | string(10) | SIM | CRMV do médico veterinário |
ufcrmvet | string(2) | SIM | UF do CRMV |
obs | string(200) | NÃO | Observação do animal |
dataenvio | Date | SIM | Data de envio |
horaenvio | String(5) | SIM | Hora de envio |
sexo | numeric(1) | SIM | Sexo do animal(1- Macho e 2- Fêmea) |
tampaverde | numeric(1) | SIM | Recipiente\Material de envio |
medulaossea | numeric(1) | SIM | Recipiente\Material de envio |
sanguetotal | numeric(1) | SIM | Recipiente\Material de envio |
soro | numeric(1) | SIM | Recipiente\Material de envio |
sangueedta | numeric(1) | SIM | Recipiente\Material de envio |
swabnasa | numeric(1) | SIM | Recipiente\Material de envio |
swaborofaringeo | numeric(1) | SIM | Recipiente\Material de envio |
swabocular | numeric(1) | SIM | Recipiente\Material de envio |
swabouvido | numeric(1) | SIM | Recipiente\Material de envio |
swabpele | numeric(1) | SIM | Recipiente\Material de envio |
liquidocavitario | numeric(1) | SIM | Recipiente\Material de envio |
liquor | numeric(1) | SIM | Recipiente\Material de envio |
urina | numeric(1) | SIM | Recipiente\Material de envio |
fezes | numeric(1) | SIM | Recipiente\Material de envio |
liquidoascitico | numeric(1) | SIM | Recipiente\Material de envio |
outros | numeric(1) | SIM | Recipiente\Material de envio |
emailvet | string(100) | NÃO | E-mail do medico veterinário |
foneprop | String(15) | NÃO | Telefone do proprietário(Tutor) |
emailprop | String(100) | NÂO | E-mail do proprietário(Tutor) |
clinica_id | INT | SIM | ID da clinica no easyvet |
solicitante_id | INT | SIM | ID da clinica solicitante no easyvet. Quando não for convenio enviar solicitante_id com o mesmo id da clinica_id. |
urgente | Numeric(1) | NÃO | Informa se o exame é urgente |
historico | Text | NÃO | Envia histórico do animal |
suspeitaclinica | string(30) | NÂO | Suspeita de doença do animal |
cpf | string(19) | NÃO | CPF do proprietário(Tutor) |
dtcoleta | date | SIM | Data de coleta do material |
exameid | INT | SIM | ID do exame no easyvet |
descexa | string(100) | SIM | Descrição do exame |
urgente | Numeric(1) | SIM | Informa se o exame é urgente |
ficha | string(20) | SIM | Cod. atendimento SVG |
nomevet | string(100) | SIM | Nome Veterinario |
tamparoxa | numeric(1) | SIM | Recipiente\Material de envio |
frascoformol | numeric(1) | SIM | Recipiente\Material de envio |
tampavermelha | numeric(1) | SIM | Recipiente\Material de envio |
laminas | numeric(1) | SIM | Recipiente\Material de envio |
tampacinza | numeric(1) | SIM | Recipiente\Material de envio |
parasitologico | numeric(1) | SIM | Recipiente\Material de envio |
SWAB | numeric(1) | SIM | Recipiente\Material de envio |
obs_grupo1 | string(600) | NÃO | Outros Materiais |