Avisar varias órdenes por correo
POST /api/subscriptions/orders/notify
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Envía el aviso de cobro a varias órdenes a la vez. Envía las que se pueden y devuelve las omitidas con el motivo.
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 {sent: [ids], skipped: [{id, reason}]}.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
ids |
array de integer (1 a 100) | Sí | Ids de las órdenes, sin repetir. |
Reglas:
- Se omiten las órdenes inexistentes, pagadas o canceladas y las de clientes sin correo.
Errores:
422{success: false, message: {campo: [errores]}}si falla la validación de campos. (lista vacía, más de 100 o ids repetidos).401sin token o con un token inválido.
Cuerpo
Content-Type: application/json
{
"ids": [
311,
312,
318
]
}
Respuestas
200 — Enviadas
{
"success": true,
"data": {
"sent": [
311,
318
],
"skipped": [
{
"id": 312,
"reason": "El cliente no tiene correo registrado."
}
]
},
"message": "2 notificación(es) enviada(s), 1 omitida(s)"
}
422 — Sin ids
{
"success": false,
"message": {
"ids": [
"El campo ids es obligatorio."
]
}
}
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.