1. Proceso de Venta
Payday Public API
  • Proceso de Venta
  • Autenticacion y Firma HMAC
  • Proceso de Venta
    • Cotizacion - crear
      POST
    • Referencias - solicitar
      POST
    • Ofertas - previsualizar
      POST
    • Ofertas - seleccionar
      POST
    • Contrato - renderizar
      POST
    • Contrato - firma
      POST
    • Validar ICCID + IMEI
      POST
    • Finalizar venta
      POST
  • Productos
    • Marcas
      GET
    • Modelos y Prefijos por marca
      GET
  • Medios de Notificacion
    • Registrar Webhook para cotizacion
      POST
    • Polling Cotizacion
      GET
    • Historial de Eventos
      GET
  • Eventos Webhook
    • Evento quote.updated
    • reference.requested
    • reference.accepted
    • imei.validated
    • contract.signed
    • offer.selected
    • offer.previewed
  1. Proceso de Venta

Ofertas - previsualizar

POST
https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/{COTIZACION_ID}/ofertas/previsualizar
Calcula y devuelve las ofertas disponibles para una cotizacion con base en marca, modelo, prefijo y condiciones comerciales.
Esta ruta toma la seleccion de equipo y genera las ofertas financieras disponibles para la cotizacion actual. Ademas devuelve el resumen de producto, pricing y plan de enganche aplicable. Es el endpoint previo a la seleccion de la oferta final.
Que recibe
Parametro de ruta:
1.
id: ObjectId de la cotizacion.
No recibe query params.
Body:
1.
marcaId: ObjectId requerido.
2.
modeloId: ObjectId requerido.
3.
prefijoId: ObjectId requerido.
4.
precio: numero opcional.
5.
enganche: numero opcional.
Que devuelve
1.
cotizacion con process actualizado.
2.
producto con marca, modelo, prefijo, imagen y datos del equipo.
3.
pricing con precio, enganche, porcentaje aplicado y topes comerciales.
4.
ofertas: arreglo de planes posibles con offer_id y montos calculados.
Cuando usarla
Usala cuando la cotizacion ya cumpla referencias y el proceso indique next_action = select_offer.
Reglas y consideraciones
1.
Solo puede usarse cuando la cotizacion esta en etapa ofertas.
2.
El schema exige precio o enganche, pero la regla de negocio cambia segun el flujo:
3.
En flujo se espera enganche y el backend calcula el precio.
4.
El backend valida topes por precio_maximo, price_boost y/o rating, segun la configuracion.
Errores frecuentes
1.
409 si la cotizacion no esta en etapa ofertas.
2.
422 si el precio excede el limite permitido.
3.
400 si el body no cumple la combinacion de campos esperada para el flujo real.

Solicitud

Autorización
Agregar parámetro en header
X-Api-Key
Ejemplo:
X-Api-Key: ********************
Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/69fa7b48e65c5ec021a8aeb0/ofertas/previsualizar' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "marcaId": "679bac63b89e07f69ef1483f",
    "modeloId": "684c861dcbecf4f039911e74",
    "prefijoId": "687ae26e0e1de9a1f0d74336",
    "precio": 2000, // No debe de exceder el precio autorizado por esquema
    "enganche": 500 // Obligatorio
}'
Respuesta Ejemplo de Respuesta
{}
Modificado en 2026-05-08 18:15:45
Anterior
Referencias - solicitar
Siguiente
Ofertas - seleccionar
Built with