Listar órdenes de compra de la empresa
GET/orders
Devuelve las órdenes de la empresa del usuario autenticado, de todos los tipos y estados, de la más reciente a la más antigua, paginadas de a 15 registros (tamaño fijo, no configurable). Se pagina con el parámetro estándar page. Cada orden incluye su última transacción de pago en latest_transaction (null si aún no se ha intentado pagar). Tipos (order_type): QUOTA_PURCHASE = compra de cupos PREPAID creada con POST /orders; CERTIFICATE_RENEWAL = renovación por 1 año de un certificado Viafirma emitido, creada con POST /certificate-request/{id}/issuance/renew, con certificate_request_id, quantity = 1 y vigencia = 1, sin ítems PREPAID (al pagarse extiende la vigencia del certificado). Una orden CERTIFICATE_RENEWAL en PENDING pasa a FAILED cuando el certificado deja de ser renovable, en tres momentos: cuando el cliente intenta pagarla o reintentarla (POST /orders/{uuid}/pay o /retry responden 422 con reason) y, sin intervención del cliente, cuando la revocación automática revoca el certificado al terminar el periodo de gracia o cuando el certificado se marca como vencido. Pagar una renovación no cancela las demás renovaciones PENDING del mismo certificado: siguen en PENDING hasta que se intente pagarlas o reintentarlas (422 con reason = MAX_TERM) o hasta que el certificado se marque como vencido.
Request
Responses
- 200
- 401
- 403
- 429
- 500
Lista paginada de órdenes
No autenticado
La empresa del usuario está inactiva. Cuerpo: {message: 'La empresa se encuentra inactiva.'}, sin campo success
Límite general de 60 peticiones por minuto excedido.
Error interno (incluye usuario sin empresa asociada). Cuerpo genérico {message: 'Server Error'}, sin campo success y sin el detalle del error (a diferencia de POST /orders, que en el caso de usuario sin empresa responde 404). Envíe la cabecera Accept: application/json para recibirlo en JSON.