Estás en: Documentación › Taller › Listar órdenes de trabajo
Listar órdenes de trabajo
Parámetros que acepta este endpoint y campos que devuelve.
GET
/v1/work-ordersPermiso necesario en la clave: workorders:read (o *).
Parámetros de ruta
Este endpoint no tiene parámetros de ruta.
Parámetros de consulta
Van en la dirección, detrás de ? y separados por &. Todos son opcionales.
| Nombre | Tipo | Obligatorio | Qué hace | Ejemplo |
|---|---|---|---|---|
status | texto (lista) | No | Estado del registro. Solo se admiten los valores de la lista. Valores: draft (borrador), validated (validado), closed (cerrada), cancelled (anulado).draftvalidatedclosedcancelled | draft |
customer_id | número entero | No | Identificador del cliente (campo «id» de /customers). | 341 |
vehicle_id | número entero | No | Identificador del vehículo (campo «id» de /vehicles). | 12 |
updated_since | fecha y hora ISO 8601 | No | Solo registros creados o modificados desde ese momento (ISO 8601 UTC). Sirve para sincronizar solo cambios. | 2026-11-01T00:00:00Z |
limit | número entero | No | Cuántos registros devuelve cada página (1 a 100). Por defecto 25. | 50 |
page | número entero | No | Número de página, empezando en 1. Con meta.has_more = true hay más páginas. | 1 |
Campos de la respuesta
| Campo | Tipo | Qué contiene |
|---|---|---|
id | número entero | Identificador interno de la orden. |
ref | texto | Referencia de la orden. |
customer_id | número entero | Cliente. |
vehicle_id | número entero | Vehículo. |
category | texto | Categoría del trabajo. |
status | texto (lista) | draft, validated, closed o cancelled. |
description | texto | Descripción del trabajo. |
entry_date | fecha AAAA-MM-DD | Fecha de entrada. |
expected_exit_date | fecha AAAA-MM-DD | Salida prevista. |
actual_exit_date | fecha AAAA-MM-DD | Salida real. |
mileage_in_km | número entero | Kilómetros a la entrada. |
fuel_level | texto | Nivel de combustible. |
currency | texto | Moneda. |
tax_type | texto | Impuesto del taller: IVA, IGIC o IPSI. |
total_net | número | Base imponible. |
total_tax | número | Importe del impuesto (IVA, IGIC o IPSI según tax_type). |
total_gross | número | Total con impuestos. |
discount_percent | número | Descuento en %. |
quote_id | número entero | Presupuesto de origen. |
proforma_id | número entero | Proforma generada. |
invoice_id | número entero | Factura generada. |
created_at | fecha y hora ISO 8601 | Alta. Fecha y hora ISO 8601 en UTC. |
validated_at | fecha y hora ISO 8601 | Validación. Fecha y hora ISO 8601 en UTC. |
closed_at | fecha y hora ISO 8601 | Cierre. Fecha y hora ISO 8601 en UTC. |
updated_at | fecha y hora ISO 8601 | Última modificación. Fecha y hora ISO 8601 en UTC. |