Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/facturacion/{espacio}/orders/expire-due

Vence las órdenes sin pagar

Pasa a expired las órdenes en pending_payment cuyo expira_at ya pasó, y libera su stock en Productos. Dice cuántas venció.

  • PERMISOescribe
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Facturación.

RESPUESTA 200

CAMPOTIPOQUÉ ES
expiredintegerCuántas órdenes venció.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Facturaciónmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

  • Una orden no vence sola: sigue en pending_payment (y admite comprobantes) hasta que llamas a esta ruta. Llámala con la frecuencia que quieras, por ejemplo antes de listar las órdenes.
  • Puedes repetirla sin miedo: lo ya vencido no se toca. Las órdenes en under_review o rejected no vencen.