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

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.

parteIdstring
obligatorio
El identificador cifrado del parte, tal como lo devuelve consultarPartesTrabajo.
incluir_importesbool
opcional
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».