Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Crear parte de trabajo

POST https://api.afer.pro/api/v1/work-orders
Alias en castellano (v0, sigue operativo): 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.

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. Admite X-IDEMPOTENCY-KEY.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

titulostring
obligatorio
Qué hay que hacer, en una línea.
descripcionstring
opcional
El detalle del trabajo.
clienteIdstring
opcional
Cliente al que se le hace el trabajo. Tiene que ser de la cuenta.
fechadate
opcional
Fecha del parte. Formato YYYY-MM-DD.
estadoIdstring
opcional
Estado con el que nace. Por defecto, el de salida.
asignadosarray
opcional
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

200 · application/json
{
    "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"
            }
        ]
    }
}
Notas
  • Un asignado que no esté en la cuenta devuelve 404 y no se crea nada.
  • La numeración es la misma que la de la pantalla: el contador de partes de la empresa.