Marcar orden como pagada
POST /api/subscriptions/orders/{subscription_order_id}/pay
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra el cobro de la orden y emite su comprobante electrónico por el monto de la suscripción.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Los registros de suscripciones son de toda la empresa: un vendedor ve y gestiona los mismos que el administrador.
Formato de respuesta: estándar {success, data, message?} (registro único). data es la orden ya pagada con su document; message incluye la respuesta del envío a SUNAT.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
subscription_order_id |
integer | Sí | Id de la orden de cobro. |
Reglas:
- Comprobante: boleta si el cliente tiene DNI (u otro documento), factura si tiene RUC; con la serie del establecimiento del usuario y los productos del plan.
- El cobro se registra en efectivo (método
01) en la caja abierta del usuario que marca el pago: abre la caja antes (sección Caja). - Todo o nada: si el comprobante no se puede emitir (sin caja abierta, sin serie, límite del plan de la empresa...), la orden queda como estaba y responde
409con el motivo. - Se pueden cobrar órdenes
pending,rejectedyexpired.
Errores:
404si el registro no existe.409si la orden ya está pagada o cancelada, o si no se pudo emitir el comprobante (elmessagedice por qué).401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
subscription_order_id |
ruta | sí | 311 |
Respuestas
200 — Pagada
{
"success": true,
"data": {
"id": 311,
"number": "SO-0311",
"status": "paid",
"status_description": "Pagado",
"amount": 118.0,
"currency_type_id": "PEN",
"date_of_issue": "2026-12-14",
"date_of_due": "2026-12-14",
"date_of_payment": "2026-12-14 16:42:10",
"subscription_id": 48,
"plan_id": 3,
"plan_name": "Plan Mensual Gold",
"customer_id": 1520,
"customer_name": "MARÍA FERNANDA QUISPE ROJAS",
"customer_number": "45879632",
"count_notification": 1,
"date_notification": "2026-12-14 09:00:04",
"count_rejected_payments": 0,
"payment_url": "https://empresa.dominio/full-suscription/pending-payments/order/482913",
"document": {
"id": 90211,
"document_type_id": "03",
"number_full": "B001-4581",
"date_of_issue": "2026-12-14",
"total": 118.0,
"state_type_id": "05",
"download_pdf": "https://empresa.dominio/downloads/document/pdf/9b1c3f2e-0f7a-4c11-9a9d-7e2b61c2d0aa"
}
},
"message": "Orden pagada. Comprobante: La Boleta numero B001-4581, ha sido aceptada"
}
409 — Ya pagada
{
"success": false,
"message": "La orden ya está pagada."
}
409 — Sin caja abierta
{
"success": false,
"message": "Ocurrió un error: Caja seleccionada en métodos de pago se encuentra cerrada"
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.