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

Listar partes de trabajo

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

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.

fecha_iniciodate
opcional
Partes con fecha a partir de esta. Formato YYYY-MM-DD.
fecha_findate
opcional
Partes con fecha hasta esta.
clienteIdstring
opcional
Solo los partes de este cliente.
estadoIdstring
opcional
Solo los partes en este estado. Los ids salen de consultarEstados.
usuarioIdstring
opcional
Solo los partes que lleva esta persona.
busquedastring
opcional
Texto a buscar en el título, la descripción, el número o el cliente.
incluir_importesbool
opcional
Con true, añade base_imponible a cada parte. Por defecto no se devuelve.
paginaint
opcional
Página a devolver. Por defecto 1.
por_paginaint
opcional
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

200 · application/json
{
    "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"
                    }
                ]
            }
        ]
    }
}
Notas