Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/facturacion/{espacio}/review-queue/{comprobante}/reject

Rechaza un comprobante

El pago no es válido. La orden pasa a rejected y el cliente puede mandar otro comprobante.

  • 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.
comprobantestringSÍEl id del comprobante: el evidence_id que devolvió subirlo, o el id de la cola (32 caracteres hexadecimales).

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
revisorstringSÍQuién lo rechaza. Queda en la historia de la orden.
motivostringnoPor qué. Queda en el comprobante y en la historia.

RESPUESTA 200

CAMPOTIPOQUÉ ES
evidenceobjectEl comprobante, en rejected, con revisor, motivo y revisado_at.
estado_ordenstringrejected si la orden estaba en revisión; si no, su estado actual.

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.
404No hay un comprobante con ese id en el espacioevidencia no encontrada.
422Falta un campo obligatorio o uno no es de su tipo (detail es una lista)—

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

  • No libera el stock: la orden espera otro comprobante. Si el cliente ya no va a pagar, cancélala.
  • Un comprobante ya decidido no cambia: rechazarlo otra vez lo devuelve tal cual.