Polling Cotizacion

Obtiene el resumen operativo de una cotizacion y su estado actual dentro del flujo publico.

Esta ruta es la fuente principal para polling. Devuelve un resumen normalizado de la cotizacion con campos de negocio, avances del proceso, checkpoints y conteo de webhooks registrados.

Que recibe

Parametro de ruta:

id: ObjectId de la cotizacion.

No recibe query params.

No recibe body.

Que devuelve

cotizacion.id

cotizacion.status

cotizacion.rating y cotizacion.score

cotizacion.referencias

cotizacion.producto, pricing y plan, si ya existen

cotizacion.process con state, next_action, pause_reason, can_continue y checkpoints

cotizacion.notifications.webhooks_registrados

Cuando usarla

Usala cuando la integracion haga polling para saber si ya puede avanzar al siguiente paso del flujo.

Reglas y consideraciones

Es la mejor ruta para decidir el siguiente paso del integrador.

next_action debe usarse como señal principal de control.

La cotizacion debe pertenecer a la empresa de la API key.

Errores frecuentes

404 si la cotizacion no existe o no pertenece a la empresa.

401 o 403 por problemas de autenticacion o permisos.

curl --location 'https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/69fa7b48e65c5ec021a8aeb0' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Signature;' \ --header 'X-Api-Key: <api-key>'

{ "cotizacion": { "id": "69fa7b48e65c5ec021a8aeb0", "status": "Iniciando Verificacion", "rating": null, "score": 0, "venta_con_inventario": false, "referencias": { "total": 0, "aceptadas": 0, "rechazadas": 0, "pendientes": 0, "minimo_cumplido": false }, "producto": null, "pricing": null, "plan": null, "process": { "state": "waiting", "next_action": "wait_identity_validation", "pause_reason": "identity_validation_pending", "can_continue": false, "checkpoints": { "referencias_validadas": false, "oferta_seleccionada": false, "contrato_firmado": false, "imei_validado": false } }, "notifications": { "webhooks_registrados": 1 }, "updated_at": "2026-05-05T23:29:31.959Z" } }

Solicitud

Respuestas