/
Faturamento Protheus 2.0

Faturamento Protheus 2.0

Versão

Proprietário

Nota

Data

Versão

Proprietário

Nota

Data

1.0

@Renan Mitsuo Oka

Criação de documento.

30/05/2024

1.1

@Renan Mitsuo Oka

Inclusão da API volta Status

07/06/2024

1.2

@Renan Mitsuo Oka

Inclusão de requisitos

31/07/2024

2.0

@Renan Mitsuo Oka

novo fluxo protheus e atualização de URL base teste Tecsa

25/09/2024

3.0

@Renan Mitsuo Oka

Inclusao de relatorio volta status

22/04/2025

4.0

@Renan Mitsuo Oka

Inclusão API alteração de clinica_id e solicitante_id

23/12/2025

No servidor onde está o atalho do interfacevet deverá ser instalado o chilkat.

Instruções

  1. Menu Especiais > parametros > Protheus > ativar integração com o protheus > informar os campos em amarelo.

    image-20240925-140919.png

  2. Cadastro de atendimento Fatura = NÂO, ao finalizar o cadastro será habilitado o botão abaixo.

    image-20240530-130430.png
    image-20240530-130513.png
    Esse botão só ficará visivel caso no atendimento existir ao menos 1 exame como fatura não.
    image-20240530-130553.png
    Ao clicar no botão será iniciado o processo de envio.

    image-20240530-130758.png
    Quando todos os exames forem enviados será alterado o campo Status Fat Protheus para A vista.

  3. Se ao menos 1 exame for faturado para o protheus o usuario nao poderá mais realizar alterações na tela de atendimento.

    image-20240530-131123.png
    Ao clicar no botão Log Protheus o usuario poderá observar o json enviado e o retorno da api.

    image-20240530-132036.png

  4. Atendimentos FATURA = SIM só será enviado para o protheus apos sua liberação no libexa e conforme informado os dias no item 1, o json será enviado pelo robo de interfacevet alterando o status do atendimento para Faturado.

    image-20240530-132220.png
    caso exame for 1 perfil ele só será enviado para o Protheus apos todos os exames do perfil forem liberados.

     

  5. Só será enviado para o protheus exames fatura sim mediamente a aberta do robo, esse robo será responsável para enviar diariamente os exames para o protheus.

    image-20240530-145540.png
    Parametro do interface “FATURA_PROTHEUS”
    image-20240530-145703.png

     

  6. Exames de TAXA para ir direto para o protheus deverá obedecer o criterio abaixo, Marcado o checkbox so cobrança e Cobrança de taxa protheus, ambas as condições devem ser verdadeiras para o interface enviar o exame para API.

    image-20240925-141058.png

     

  7. Para voltar o status do faturamento do exame o protheus deverá acionar as apis abaixo:

API Integração Protheus

Só será permitido a alteração dos dados no cad. atendimento do easyvet quando não existir nenhum exame com o status fat. proteus preenchido.

 

image-20240607-151916.png

Para API de produção entrar em contato com o suporte SOFTEASY as URL abaixo é meramente ilustrativa.

Metodo para retornar o token

Solicitação de geração de token

Parâmetros

Formato

Descrição

cliente_id

int

ID do cliente no portal

sacado_id

int

Numero do sacado do cliente no portal

senha

String

Senha do sacado do cliente no portal

Ambiente de teste: http://portal4.softeasy.com.br/api/athos/GetAccessTokenKey?cliente_id=5&sacado_id=74&senha=9823

 

Ambiente de produção: https://portal4.softeasy.com.br/api/athos/GetAccessTokenKey?cliente_id=5&sacado_id=74&senha=9823

image-20240607-151429.png

Metodo para voltar status dos exames Faturados

Solicitação de retorno de atendimento

Parâmetros

Formato

Descrição

Clinica_id

int

Codigo da clinica no easyvet

cliente_id

int

ID do cliente no portal

Posto

Int

Numero do posto do atendimento

Amostra

int

Numero da amostra do atendimento

exame_id

int

Numero do exame do atendimento

Token

String

Usar Bearer Token

Ambiente de teste: http://portal4.softeasy.com.br/api/recebeRequisicaoVet/UpdateStatusMovexa?cliente_id=5&clinica_id=1185&posto=031&amostra=231205&exame_id=197&tipo=STATUSFAT

 

Ambiente de produção: https://portal4.softeasy.com.br/api/recebeRequisicaoVet/UpdateStatusMovexa?cliente_id=5&clinica_id=1185&posto=031&amostra=231205&exame_id=197&tipo=STATUSFAT

image-20240607-151716.png

8- Para o relatorio de volta status acesse o menu Relatorios > Log de rastreabilidade > Relatorio de log volta status apos abertura da tela informe o periodo desejado e click em gerar.

image-20250422-150041.png
image-20250422-151426.png
Nesse relatório vai trazer todos os atendimentos que tiveram seu status alterado pelo protheus e seus respectivos status anterior ao volta status.

9- Metodo para alterar a clinica_id pelo solicitante_id

Solicitação de geração de token

Parâmetros

Formato

Descrição

cliente_id

int

ID do cliente no portal

sacado_id

int

Numero do sacado do cliente no portal

Ambiente de teste: http://portal4.softeasy.com.br/api/wsTecsa/cloneCliSol?cliente_id=5&sacado_id=74

 

Ambiente de produção: https://portal4.softeasy.com.br/api/wsTecsa/cloneCliSol?cliente_id=5&sacado_id=74

Metodo para alterar a clinica_id pelo solicitante_id

Solicitação de retorno de atendimento

Parâmetros

Formato

Descrição

Clinica_id

int

Codigo da clinica no easyvet

solicitante_id

int

Codigo do solicitante no easyvet

Esse processo só irá ser permitido caso o solicitante_id tenha dado informado na movpac.

image-20251223-115412.png