Carga Cartas de Resguardo · UC Christus → EspoCRM

⚙ Configuración de conexión, entidades y reglas de negocio (abrir/cerrar)

Antes de usar: revisa el método exacto de autenticación de tu API Key (en Administración › API Users, confirma si dice "API Key" o "HMAC" — esta versión solo soporta el primero).

Conexión API EspoCRM (vía Backend Proxy)

URL de tu Backend Proxy (termina en /qa o /prod)

Ej: http://automatizacion.farma-erp.cl/vouchers/api-proxy/proxy.php/qa

Token del Proxy

El PROXY_TOKEN definido en espo-config.php de tu servidor — NO tu API Key real de EspoCRM.

ID de usuario interno (id_usuario del INSERT)

Nombres técnicos de entidades (API)

Carta de Resguardo (batch)

Paciente

Voucher

Prestación (Producto)

Historial Precios (Prestador vigente)

Proveedor

Programa (Team)

Nombres técnicos de campos (API)

Paciente · RUT (número)

Paciente · Dígito verificador

Paciente · Código Paciente

Paciente · Equipos genéricos a ignorar en Programas (coma)

Voucher · Número (folio)

Prestación · Código Fonasa

Prestación · Enlace Prestador

Proveedor · Razón Social

Proveedor · RUT (número)

Proveedor · Dígito verificador

Proveedor · Campo relación Prestaciones (múltiple, respaldo)

Historial Precios · campo Prestación (link)

Historial Precios · campo Vigente (SI/NO)

CartaResguardo · campo archivo

Método 2 · Crear Voucher directo por API (basado en skill inyectar-vouchers-espo)

⚠️ Recuerda usar el segmento correcto en la URL del proxy (/qa o /prod) — ahí está la seguridad real de a qué ambiente escribes, ya que la conexión siempre pasa por tu Backend Proxy.

URL de tu Backend Proxy — Método 2 (termina en /qa o /prod)

Ej: http://automatizacion.farma-erp.cl/vouchers/api-proxy/proxy.php/qa

Token del Proxy — Método 2

El mismo PROXY_TOKEN de espo-config.php.

Campo Voucher · Enlace Prestador

Status EspoCRM (workflow)

Entidad Factura

Entidad Prestación↔Factura (CPF)

Campo Voucher · Estado (para validar antes de inyectar)

Reglas: ORDEN COMPRA → Código Paciente / Programa (administrable)

Se evalúa de arriba hacia abajo; la primera regla cuyo prefijo calce con el valor de ORDEN COMPRA (o "vacío") se aplica. Si ninguna calza, la fila queda marcada como "Revisar manualmente" y no bloquea el resto del archivo.

Prefijo ORDEN COMPRA (vacío = sin orden de compra)	Tipo	Código Paciente fijo	Programa fijo

1 Cargar planilla UC Christus

Sube el archivo Excel tal como lo entrega UC Christus (columnas: FOLIO CARTA, RUT PACIENTE, CODIGO PRESTACION, ORDEN COMPRA, etc.).

Haz clic aquí o arrastra el archivo .xlsx de UC Christus

2 Procesar y validar

Agrupa por FOLIO CARTA, resuelve Código Paciente / Programa según las reglas, busca prestador/RUT de cada prestación en EspoCRM, y revisa duplicados (Voucher ya cargado con ese folio).

Método de carga a EspoCRM

Elige cómo quieres pasar las filas aprobadas del Paso 2 a EspoCRM.

Excel + CCartaResguardo (proceso interno automático) Crear Voucher directo por API (skill inyectar-vouchers-espo)

3 Crear Voucher directo por API

Para cada fila aprobada del Paso 2, crea el SalesOrder (voucher) directamente vía API y liga sus prestaciones (Product ya existentes). El folio queda guardado en el campo número, y el Código Paciente en cCodigo. Basado en crear_voucher.py del skill inyectar-vouchers-espo.

Idempotencia: antes de crear, se verifica si ya existe un Voucher con ese folio para el mismo prestador — si existe, se omite (no se duplica). Si falta el Programa (Team) del paciente, esa fila se salta y se reporta.

Dry-run (solo mostrar el plan, no escribir nada)

Inyectar Voucher a Factura (asociar y liquidar)

Etapa posterior e independiente del método usado para crear el voucher: asocia un SalesOrder ya Validado a su Invoice y crea las líneas CPrestacionFactura con montos (neto/IVA/exento). Basado en inyectar_voucher.py del skill inyectar-vouchers-espo. Usa el mismo ambiente (QA/Producción) configurado arriba en "Método 2".

Reglas de UC Christus: si un monto viene con IVA incluido, se desglosa neto = bruto / 1.19 antes de guardar. Si una prestación de la lista ligada al voucher no calza por nombre, el CPF se crea igual pero sin prestacionId (puede generar un "espejo" en el workflow de Espo — la limpieza automática es best-effort y requiere permiso Eliminar en el rol de la API).

Cargar datos desde una fila ya procesada en el Paso 2 (opcional)

Rellena automáticamente folio, RUT del prestador y las prestaciones. El "Folio de Factura" sigue siendo manual (no viene en la planilla de UC Christus).

N° de Voucher (folio)

Folio de Factura

RUT Prestador (opcional, para desempatar colisión de folio)

Prestaciones a facturar

Nombre	Valor unitario	Cantidad	Exento	IVA incluido	Precio lista (opc.)

Dry-run (solo mostrar el plan, no escribir nada) Forzar aunque el voucher NO esté "Validado" (evitar — solo si el usuario lo pide explícitamente)

Registro de actividad

Listo para comenzar. Abre "Configuración" y confirma tu API Key antes de procesar.

Carga Cartas de Resguardo — UC Christus → EspoCRM

1 Cargar planilla UC Christus

2 Procesar y validar

Método de carga a EspoCRM

3 Generar Excel de carga

4 Subir a EspoCRM

3 Crear Voucher directo por API

Inyectar Voucher a Factura (asociar y liquidar)

Registro de actividad