Saltar al contenido
Facturador

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).
  • 401 sin 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.