Crear parte de trabajo
https://api.afer.pro/api/v1/work-orders
POST https://api.afer.pro/api/v1/work-orders
Abre una orden de trabajo para un cliente y, si quieres, se la asigna a alguien.
Crea el parte con lo mínimo para que alguien lo recoja: qué hay que hacer (titulo), para quién (clienteId) y quién lo lleva (asignados). Nace en el estado de salida de la empresa salvo que se diga otro.
No crea líneas ni adjuntos: eso se trabaja en la pantalla del parte, que es donde están el catálogo, el stock y la firma.
El parte queda a nombre de la persona de la API key, que es quien figura como propietario.
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. Admite X-IDEMPOTENCY-KEY.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
titulostringobligatorio | Qué hay que hacer, en una línea. |
descripcionstringopcional | El detalle del trabajo. |
clienteIdstringopcional | Cliente al que se le hace el trabajo. Tiene que ser de la cuenta. |
fechadateopcional | Fecha del parte. Formato YYYY-MM-DD. |
estadoIdstringopcional | Estado con el que nace. Por defecto, el de salida. |
asignadosarrayopcional | Quién lo lleva: ids cifrados de usuario o sus correos. Tienen que ser de la cuenta. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/work-orders' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"titulo": "Revisión de la climatización del local",
"clienteId": "dEf456…",
"fecha": "2026-10-16",
"asignados": [
"marta@ejemplo.com"
]
}'
<?php
$data = [
'titulo' => 'Revisión de la climatización del local',
'clienteId' => 'dEf456…',
'fecha' => '2026-10-16',
'asignados' => [
0 => 'marta@ejemplo.com',
],
];
$ch = curl_init('https://api.afer.pro/api/v1/work-orders');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
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',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/work-orders', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"titulo": "Revisión de la climatización del local",
"clienteId": "dEf456…",
"fecha": "2026-10-16",
"asignados": [
"marta@ejemplo.com"
]
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"parteId": "aBc123XyZ…",
"numero": "PT-2026-00413",
"titulo": "Revisión de la climatización del local",
"fecha": "2026-10-16",
"estadoId": 16,
"estado": "Pendiente",
"clienteId": "dEf456…",
"asignados": [
{
"usuarioId": "gHi789…",
"nombre": "Marta Riera",
"email": "marta@ejemplo.com"
}
]
}
}
- Un asignado que no esté en la cuenta devuelve
404y no se crea nada. - La numeración es la misma que la de la pantalla: el contador de partes de la empresa.