Integración CRM / ERP
Cómo funciona el flujo
El CRM/ERP crea el contrato
El CRM/ERP registra la venta y envía valor, beneficiarios, número de cuotas y vencimientos.
Play2sell emite el boleto
Play2sell PAY origina la venta y emite un boleto BOLEPIX por cuota al consumidor.
Play2sell devuelve el boleto al CRM/ERP
El boleto emitido (línea digitable) se escribe de vuelta en la reserva en su CRM/ERP.
El consumidor paga → Play2sell informa al CRM/ERP
Al confirmarse el pago, Play2sell escribe el estado pagado de vuelta en su CRM/ERP.
El CRM/ERP registra la escritura → liberación
Cuando la venta se escritura, la comisión se libera y se divide entre los beneficiarios.
Configuración (por tenant)
Configure las credenciales
Agregue las credenciales de su CRM/ERP (
domain, email, token) en Integraciones → CRM/ERP. Se almacenan por tenant y nunca se comparten.Mapee los estados a acciones
Configure el mapa de estados para que Play2sell sepa qué estado del CRM/ERP significa vendida, escriturada o distratada. Esto varía por instancia de CRM/ERP, por lo que debe definirse explícitamente.
| Acción | Significado | Dispara |
|---|---|---|
| Vendida | Reserva vendida | Originación de la venta + boleto |
| Escriturada | Escritura registrada | Liberación de la comisión + split |
| Distratada | Contrato deshecho | Reembolso al consumidor |
Cómo funciona la sincronización
Los webhooks del CRM/ERP suelen ser ligeros (solo llevan un identificador). Play2sell clasifica el evento por el estado, lo encola y trae el registro completo desde la API del CRM/ERP antes de actuar — así un webhook falsificado no inyecta datos.| Propiedad | Comportamiento |
|---|---|
| Idempotencia | Cada contrato mapea a una clave estable derivada del id de la reserva en el CRM/ERP; la reentrega nunca duplica la venta. |
| Orden | Si la escritura llega antes de que la originación termine, se difiere y se reprocesa automáticamente. |
| Identidad | Compradores y beneficiarios se resuelven por CPF/CNPJ (documento), nunca por email. |
| Write-backs | Boleto creado y boleto pagado se entregan al CRM/ERP con reintentos hasta confirmarse. |
Contrato de error
Las respuestas no-2xx siguen{ code, message, hint? }. Un 4xx es un rechazo (p. ej., configuración incorrecta — corrija y reintente); un 5xx es un error transitorio (se reprocesa automáticamente).