Requisitos e permissões
- Solicite à Provet a ativação da integração OAuth com Client ID e Client secret, o fluxo client_credentials e o âmbito restapi. As permissões do utilizador virtual associado determinam os recursos acessíveis.
- O computador ImaCash necessita de acesso HTTPS de saída ao Provet Cloud. Confirme com a Provet o domínio da instância e a compatibilidade com a versão instalada; não altere o domínio nem os certificados para contornar erros.
- Autorize a leitura de department, invoice, invoicepayment, unallocatedpayment e user para o departamento correspondente. Um token válido não garante acesso a todos os recursos. Estas consultas não exigem permissões de escrita.
- Solicite também acesso de leitura ao catálogo paymentmethod para identificar métodos personalizados, incluindo cartões personalizados. A Provet deve atribuir as permissões de catálogo adequadas; não conceda administração geral como solução.
Configuração no ImaCash
- Abra Configuração > Integração e selecione Provet Cloud. O nome anterior Provet Cloud V2 mantém-se apenas como alias de compatibilidade, não como uma segunda integração.
- Provet ID (tenantId): identificador numérico da instância ou clínica fornecido pela Provet. Não é o nome de utilizador, o email nem o ID do departamento; introduza apenas o identificador, não uma URL.
- Client ID: identificador OAuth da integração ativada para essa instância.
- Client secret: Dado privado fornecido pelo administrador. Introduza-o apenas no ImaCash.
- Guarde a configuração e selecione o departamento desta caixa quando solicitado. Reveja também os filtros de utilizadores e a moeda ativa antes do teste.
Captura e formas de pagamento
- O ImaCash consulta faturas finalizadas do departamento, os seus pagamentos e pagamentos não alocados. Compare sempre os montantes, a moeda e a forma de pagamento nos dois sistemas; uma leitura da API não confirma um movimento físico de numerário.
- Os tipos padrão documentados são payment_type=1 para numerário e payment_type=0 para cartão. A sua identificação não depende do sucesso da consulta auxiliar paymentmethod.