Integra operaciones y eventos
Relaciona tus datos con Pimia y prepara reintentos y sincronización.
Guía V1 en evolución
Recorrido basado en la guía de integradores V1 facilitada el 12 de septiembre de 2026. Se actualizará con Pimia; no constituye una verificación del despliegue actual.
Relaciona tus registros
La V1 describe external_ref para asociar identificadores propios a determinados recursos, como clientes, presupuestos y facturas. Comprueba su disponibilidad por operación: no presupongas que existe en todos los recursos. Conserva también el identificador que devuelve Pimia.
Un CRM puede asociar la oportunidad a un presupuesto y el pedido a la factura resultante. Los eventos posteriores permiten actualizar el estado en tu aplicación.
Evita escrituras duplicadas
En los POST compatibles, genera una Idempotency-Key por operación y conserva esa misma clave y cuerpo para los reintentos. No generes otra clave cada vez que hay un timeout.
La V1 limita la ventana a 24 horas y el aislamiento al token. Si el token cambia entre intentos o se supera la ventana, reconcilia el resultado antes de repetir una creación. Un 409 puede indicar que el intento original sigue ejecutándose; un 422 requiere revisar la validación.
Recibe eventos y reconcilia
La guía describe eventos de clientes, facturas, presupuestos, decisiones de aprobación y revocación de la aplicación. Los payloads son mínimos: consulta el recurso mediante la API con sus permisos cuando necesites más información.
Verifica la firma HMAC del webhook, tolera reentregas y conserva el estado de procesamiento. Combina eventos con consultas de reconciliación para recuperar una interrupción. La lista de eventos no garantiza sincronización completa de todos los módulos.
Respeta las reglas de negocio
- Los importes monetarios usan subunidades según la precisión de la moneda; la banca tiene campos expresados como decimales en unidades principales. Consulta el contrato de cada campo.
- Pimia recalcula los totales y valida las operaciones: no fuerces resultados incompatibles desde el cliente.
- Una aprobación no ejecuta la escritura ni concede scopes adicionales. Tu aplicación realiza la operación autorizada por la API normal.
Resultado: una operación enlazada a tus datos, con recuperación ante timeout y actualización mediante eventos cuando estén disponibles.
Los detalles de endpoints pertenecen a API Reference. El catálogo exacto de scopes y la gestión de webhooks se actualizarán al consolidarse el contrato de la V1.
Anterior: Implementa tu vertical · Siguiente: Incorpora clientes y pasa a producción