Ficha de un parte de trabajo
GET
https://api.afer.pro/api/v1/work-orders/{id}
Alias en castellano (v0, sigue operativo):
GET https://api.afer.pro/api/v1/work-orders/{id}
Un parte entero: cabecera, cliente, quién lo lleva y sus líneas.
La ficha completa del parte. Las líneas llegan en el orden en que están en el documento, con su descripción y su cantidad.
Los importes solo salen si se piden con incluir_importes: entonces cada línea añade importe_unitario, descuento y base_imponible, y el parte su total.
Autenticación
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.
parteIdstringobligatorio | El identificador cifrado del parte, tal como lo devuelve consultarPartesTrabajo. |
incluir_importesboolopcional | Con true, añade los importes de las líneas y el total del parte. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/work-orders/aBc123XyZ?parteId=aBc123XyZ%E2%80%A6' \
-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/aBc123XyZ?parteId=aBc123XyZ%E2%80%A6');
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/aBc123XyZ?parteId=aBc123XyZ%E2%80%A6', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
200 · application/json
{
"errorCode": 200,
"errorMsg": "",
"data": {
"parteId": "aBc123XyZ…",
"numero": "PT-2026-00412",
"titulo": "Revisión de la climatización del local",
"descripcion": "Revisar las dos unidades exteriores y cambiar filtros.",
"fecha": "2026-10-14",
"estado": "En curso",
"estadoId": 17,
"cliente": {
"clienteId": "dEf456…",
"nombre_fiscal": "Talleres del Norte SL",
"nombre_comercial": "Talleres del Norte",
"cif": "B07123456"
},
"asignados": [
{
"usuarioId": "gHi789…",
"nombre": "Marta Riera",
"email": "marta@ejemplo.com"
}
],
"lineas": [
{
"descripcion": "Mano de obra oficial 1ª",
"cantidad": 3
},
{
"descripcion": "Filtro G4",
"cantidad": 2
}
]
}
}
Notas
- Si el parte no es de la cuenta de la clave, responde
404: no se distingue entre «no existe» y «no es tuyo».