Requisitos y permisos
- Solicita a Provet la activación de la integración OAuth con Client ID y Client secret, flujo client_credentials y alcance restapi. Los permisos del usuario virtual asociado determinan qué puede consultar.
- El equipo de ImaCash necesita salida HTTPS al servicio Provet Cloud. Confirma el dominio de tu instancia con Provet y su compatibilidad con la versión instalada; no cambies el dominio ni los certificados para eludir errores.
- Autoriza la lectura de department, invoice, invoicepayment, unallocatedpayment y user para el departamento correspondiente. Un token válido no garantiza permiso sobre cada recurso. No se necesitan permisos de escritura para estas consultas.
- Solicita también acceso de lectura al catálogo paymentmethod para identificar métodos personalizados, incluidas tarjetas personalizadas. Provet debe asignar los permisos de catálogo adecuados; no concedas administración general como solución.
Configuración en ImaCash
- Abre Configuración > Integración y selecciona Provet Cloud. El nombre anterior Provet Cloud V2 se conserva únicamente como alias compatible, no como una segunda integración.
- Provet ID (tenantId): identificador numérico de la instancia o clínica facilitado por Provet. No es el nombre de usuario, el correo ni el ID del departamento; introduce solo el identificador, no una URL.
- Client ID: identificador OAuth de la integración habilitada para esa instancia.
- Client secret: Dato privado facilitado por el administrador. Introdúcelo únicamente en ImaCash.
- Guarda la configuración y selecciona el departamento que corresponda a esta caja cuando se solicite. Revisa también los filtros de usuarios y la moneda activa antes de la prueba.
Captura y formas de pago
- ImaCash consulta facturas finalizadas del departamento, sus pagos y pagos no asignados. Contrasta siempre el importe, la moneda y la forma de pago en ambos sistemas; una lectura de la API no confirma un movimiento físico.
- Los tipos estándar documentados son payment_type=1 para efectivo y payment_type=0 para tarjeta. Su identificación no depende de que la consulta auxiliar paymentmethod responda correctamente.