Listar partes de trabajo
https://api.afer.pro/api/v1/work-orders
GET https://api.afer.pro/api/v1/work-orders
El papel del día de quien está en la calle: qué hay que hacer, para quién y quién lo lleva.
Un parte de trabajo —u orden de trabajo— es lo que se le da a quien sale a hacer el trabajo. Este listado devuelve los del periodo con su número, el título (qué hay que hacer), el cliente, el estado y las personas asignadas.
Los importes no vienen de serie. Un parte puede tener líneas valoradas, pero quien lo consulta normalmente quiere saber qué hay que hacer, no lo que vale. Se piden a propósito con incluir_importes, y entonces cada parte añade base_imponible (la suma de sus líneas, sin IVA).
La fecha que se filtra y se devuelve es la del parte; los partes creados sobre la marcha a los que nadie les puso fecha usan la de alta.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación con API key: sin credenciales responde 401.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
fecha_iniciodateopcional | Partes con fecha a partir de esta. Formato YYYY-MM-DD. |
fecha_findateopcional | Partes con fecha hasta esta. |
clienteIdstringopcional | Solo los partes de este cliente. |
estadoIdstringopcional | Solo los partes en este estado. Los ids salen de consultarEstados. |
usuarioIdstringopcional | Solo los partes que lleva esta persona. |
busquedastringopcional | Texto a buscar en el título, la descripción, el número o el cliente. |
incluir_importesboolopcional | Con true, añade base_imponible a cada parte. Por defecto no se devuelve. |
paginaintopcional | Página a devolver. Por defecto 1. |
por_paginaintopcional | Resultados por página. Por defecto 100, máximo 500. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/work-orders?fecha_inicio=2026-10-01&fecha_fin=2026-10-31' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php
$ch = curl_init('https://api.afer.pro/api/v1/work-orders?fecha_inicio=2026-10-01&fecha_fin=2026-10-31');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/work-orders?fecha_inicio=2026-10-01&fecha_fin=2026-10-31', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"total_partes": 1,
"pagina": 1,
"por_pagina": 100,
"num_paginas": 1,
"partes": [
{
"parteId": "aBc123XyZ…",
"numero": "PT-2026-00412",
"titulo": "Revisión de la climatización del local",
"fecha": "2026-10-14",
"estado": "En curso",
"estadoId": 17,
"cliente": {
"clienteId": "dEf456…",
"nombre_fiscal": "Talleres del Norte SL",
"nombre_comercial": "Talleres del Norte"
},
"asignados": [
{
"usuarioId": "gHi789…",
"nombre": "Marta Riera",
"email": "marta@ejemplo.com"
}
]
}
]
}
}
- La ficha entera de un parte, con sus líneas, la da obtenerParteTrabajo.
- Para crear uno, crearParteTrabajo.