API de DeCA

Dos maneras de dejar un documento electrónico de control administrativo en el repositorio de deca.infonetconsultores.com. Las dos acaban igual: un PDF con su URL de descarga directa y su QR, tal como pide la Resolución de 5 de junio de 2026. Elige según lo que ya tengas hecho.

Cuál de las dos usar

Si tu programa ya imprime un albarán o un documento de control y puedes pintarle un código QR, usa el modo A: sigues con tu plantilla y solo añades el QR y una llamada para subir el fichero. Es lo que hacen Arigest, Agrocom, GAP, Gesthorm, Facturacom y Recodat.

Si prefieres no tocar tu generador de PDF, o no tienes uno, usa el modo C: nos mandas los datos del documento y te devolvemos el PDF terminado, el QR como imagen y la URL. Es una sola llamada y no hay que preocuparse del formato del documento, del tamaño, de los metadatos ni del QR.

Alta y credenciales

Cada empresa se identifica por su cliente aplicación: un nombre corto que decide la carpeta donde quedan sus documentos. Es el mismo texto que tu aplicación manda en el campo cliente de /subir, y se normaliza a minúsculas y guiones: HORMIGONES EJEMPLO pasa a ser hormigones-ejemplo. Una empresa solo puede tener un cliente aplicación y dos empresas no pueden compartirlo.

El alta se hace de dos maneras, y las dos llevan al mismo sitio:

• Por API, desde las aplicaciones de Infonet, con /alta: mandas el cliente aplicación y recibes su token del modo C. Si ya existe, te devuelve el que hay; nunca se crean duplicados.
• En nuestro panel, cuando la empresa va a entrar además en la plataforma web: ahí se completan el nombre, el contacto, la cuota y los usuarios.

El token del modo C es siempre el mismo: /alta te lo devuelve igual cada vez que lo pidas. Solo cambia si lo renovamos desde el panel, por ejemplo si se ha filtrado. El token del modo A (el de tu aplicación para /subir) es otro distinto.

En el modo A necesitas el cliente aplicación para construir la URL del QR. En el modo C no hace falta, la URL viene en la respuesta.

Repositorio, URL y QR

Todo documento acaba en https://deca.infonetconsultores.com/documentos/<slug>/<fichero>.pdf. Esa dirección es la que va dentro del QR y la que quien inspecciona descarga en un control. Cumple lo que exige la Resolución de 5 de junio de 2026:

• Empieza por https:// y el servidor sirve TLS 1.2 o superior.
• Descarga directa: al abrirla se obtiene el PDF, sin página intermedia, sin usuario ni contraseña, sin botones.
• No caduca. La norma permite desactivarla a los siete días del servicio, pero no lo exige, y así queda cubierto el año de conservación sin más.
• No hay listado de carpetas: quien no tenga la URL exacta no puede ver qué hay.

En el modo C el QR contiene exactamente esa URL y nada más. En el modo A el QR lo pintas tú: pon la URL completa, sin parámetros ni texto añadido.

Autenticación

Las dos llamadas se autentican igual: cabecera Authorization con el token del cliente. Los endpoints de gestión usan el mismo token que /deca. /alta usa en cambio el token maestro de las aplicaciones de Infonet, que no pertenece a ningún cliente; guárdalo solo en el servidor de la aplicación. Los tokens no caducan; si sospechas que uno se ha filtrado, llámanos y lo cambiamos en el momento. Nunca lo pongas en una URL ni en un formulario web visible.

Authorization: Bearer <TU_TOKEN>

Modo A: POST /subir

Crea la carpeta del cliente si no existe y guarda el PDF con el nombre indicado. Nunca queda un PDF a medias: si algo falla, no se guarda nada.

Cabeceras

Cuerpo de la petición

Se acepta application/json (recomendado) o application/x-www-form-urlencoded / multipart/form-data con los mismos nombres de campo.

Esquema

{
  "cliente":        "Transportes Perez SL",
  "nombre_fichero": "ALB-2026-0001.pdf",
  "pdf_base64":     "JVBERi0xLjQKMSAwIG9iajw8L1R5cGUv..."
}

Ejemplos de petición

# El PDF se codifica al vuelo y se inserta en el JSON
curl -X POST https://deca.infonetconsultores.com/subir \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"cliente\":\"Transportes Perez SL\",
       \"nombre_fichero\":\"ALB-2026-0001.pdf\",
       \"pdf_base64\":\"$(base64 -w0 albaran.pdf)\"}"

$b64 = [Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\ruta\albaran.pdf"))

$cuerpo = @{
    cliente        = "Transportes Perez SL"
    nombre_fichero = "ALB-2026-0001.pdf"
    pdf_base64     = $b64
} | ConvertTo-Json

Invoke-RestMethod -Method Post `
  -Uri "https://deca.infonetconsultores.com/subir" `
  -Headers @{ Authorization = "Bearer TU_TOKEN" } `
  -ContentType "application/json" `
  -Body $cuerpo

$cuerpo = json_encode([
    'cliente'        => 'Transportes Perez SL',
    'nombre_fichero' => 'ALB-2026-0001.pdf',
    'pdf_base64'     => base64_encode(file_get_contents('albaran.pdf')),
]);

$ch = curl_init('https://deca.infonetconsultores.com/subir');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $cuerpo,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$respuesta = curl_exec($ch);
$codigo    = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 201 = subido correctamente
var_dump($codigo, json_decode($respuesta, true));

const aBase64 = f => new Promise(r => {
  const fr = new FileReader();
  // result viene como data URI; el endpoint también lo acepta entero
  fr.onload = () => r(fr.result.split(',')[1]);
  fr.readAsDataURL(f);
});

const res = await fetch('/subir', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type':  'application/json'
  },
  body: JSON.stringify({
    cliente:        'Transportes Perez SL',
    nombre_fichero: 'ALB-2026-0001.pdf',
    pdf_base64:     await aBase64(input.files[0])
  })
});

const datos = await res.json();
if (!datos.ok) throw new Error(datos.error);

Respuesta correcta

{
  "ok":      true,
  "cliente": "transportes-perez-sl",
  "fichero": "ALB-2026-0001.pdf",
  "ruta":    "documentos/transportes-perez-sl/ALB-2026-0001.pdf",
  "bytes":   152340
}

Errores

Todos los errores devuelven {"ok": false, "error": "<mensaje>"} con el código HTTP correspondiente.

{
  "ok":    false,
  "error": "El contenido decodificado no es un PDF."
}

Catálogo completo

Saneado de nombres

Ningún dato del cliente llega en crudo al sistema de ficheros. Estas son las transformaciones exactas:

Carpeta de cliente

Nombre de fichero

Límites y validación

Orden de validación

El endpoint corta en el primer fallo, en este orden:

1.  Método POST ................... 405
2.  Cabecera Authorization ........ 401
3.  Token válido .................. 403
4.  JSON parseable ................ 400
5.  Los tres campos presentes ..... 400
6.  Base64 decodificable .......... 400
7.  Tamaño <= 20 MB ............... 413
8.  Empieza por %PDF- ............. 415
9.  Nombres saneables ............. 400
10. No existe ya el fichero ....... 409
11. Guardado ...................... 500 si falla
     201 Created

Conversor PDF → Base64

El fichero no sale de tu navegador: la conversión es local con FileReader. Útil para preparar el cuerpo JSON de Postman.

Probar el endpoint del modo A

Lanza una petición real contra /subir con tu token. El token no se guarda en ningún sitio: vive solo en este campo mientras la pestaña esté abierta.

Modo C: POST /deca

Mandas los datos del documento en JSON. Comprobamos que estén todos los del artículo 6 de la Orden FOM/2861/2012, generamos el PDF con el QR, lo guardamos en la carpeta del cliente, lo apuntamos en la base de datos y te devolvemos la URL, el PDF y el QR en la misma respuesta. Todo o nada: si algo falla no queda ningún fichero a medias.

Cabeceras

Cuerpo

{
  "cargador":      { "nombre": "Hormigones Ejemplo SL", "nif": "B12345678", "domicilio": "Pol. Ind. Norte 4, 21007 Huelva" },
  "transportista": { "nombre": "Transportes Pérez SL", "nif": "B87654321" },
  "fecha_transporte":      "2026-10-06",
  "matricula_tractor":     "1234ABC",
  "matricula_remolque":    "R1234BCD",
  "autorizacion_especial": null,
  "numero_documento":      "ALB-2026-0001",
  "nif_vehiculo":          "12345678Z",
  "envios": [
    {
      "origen":            "Planta Norte",
      "origen_localidad":  "Huelva (Huelva)",
      "destino":           "Obra Avda. Andalucía 12",
      "destino_localidad": "Aljaraque (Huelva)",
      "mercancia":         "Hormigón HA-25",
      "peso":              "24.000 kg"
    }
  ],
  "observaciones": ""
}

Localidades de origen y destino · GET /municipios

El origen y el destino se pueden mandar de dos formas. Las dos son válidas; la segunda es la recomendada porque garantiza que la localidad está bien escrita y es la misma que usa la plataforma web.

1. Solo texto libre en origen y destino, como hasta ahora. Se imprime tal cual, sin comprobar nada: "Planta Norte, Huelva".
2. Con localidad: además (o en lugar) del texto, mandas origen_localidad y/o destino_localidad con un municipio de la lista oficial del INE. Lo comprobamos y en el documento sale «lugar - Localidad (Provincia)».

Se puede usar en un campo y no en el otro, y cada envío va por su cuenta. Así queda en el PDF:

GET /municipios

La lista de localidades válidas: los 8.132 municipios de España según el INE, cada uno como "Localidad (Provincia)". Es pública: no lleva token. Úsala para rellenar un desplegable o un buscador en tu programa y manda en origen_localidad / destino_localidad el texto exacto que devuelve.

curl "https://deca.infonetconsultores.com/municipios?q=aljaraque"

{
  "ok":         true,
  "total":      1,
  "municipios": [ "Aljaraque (Huelva)" ]
}

Si no hay coincidencias, "total": 0 y "municipios": [] (sigue siendo 200). Cualquier método que no sea GET devuelve 405. La respuesta se puede cachear una semana (Cache-Control y ETag).

Ejemplo

curl -X POST https://deca.infonetconsultores.com/deca \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @deca.json

# PowerShell
$cuerpo = Get-Content deca.json -Raw
Invoke-RestMethod -Method Post -Uri "https://deca.infonetconsultores.com/deca" `
  -Headers @{ Authorization = "Bearer TU_TOKEN" } `
  -ContentType "application/json; charset=utf-8" -Body $cuerpo

// PHP
$ch = curl_init('https://deca.infonetconsultores.com/deca');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer TU_TOKEN', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($datos, JSON_UNESCAPED_UNICODE),
]);
$r = json_decode(curl_exec($ch), true);
file_put_contents('deca.pdf', base64_decode($r['pdf_base64']));

Respuesta 201 (o 200)

{
  "ok":            true,
  "accion":        "creado",
  "id":            123,
  "estado":        "activo",
  "sustituye_a":   null,
  "fichero":       "DECA_3f9a1c0d8b2e4f6a9c1d3e5f7a9b0c2e.pdf",
  "url":           "https://deca.infonetconsultores.com/documentos/hormigones-ejemplo-sl/DECA_3f9a1c0d8b2e4f6a9c1d3e5f7a9b0c2e.pdf",
  "creado":        "2026-10-06T07:30:00+02:00",
  "conductor":     null,
  "pdf_base64":    "JVBERi0xLjcK…",
  "qr_png_base64": "iVBORw0KGgo…"
}

Errores

Todos los errores devuelven JSON con "ok": false y un "error" legible. El 422 añade además la lista "errores" con un texto por campo.

Mensajes posibles en errores (422)

Cada texto empieza por el campo al que se refiere, con la misma ruta que en el JSON. Puedes mostrarlos tal cual al usuario o mapearlos a tus propios campos.

{
  "ok":      false,
  "error":   "Datos incompletos o inválidos.",
  "errores": [
    "cargador.domicilio: obligatorio",
    "fecha_transporte: formato AAAA-MM-DD",
    "envios[1].peso: obligatorio"
  ]
}

Modificar un DeCA: mismo número de documento

No hay endpoint de edición ni de borrado. Para modificar, vuelve a llamar a POST /deca con el mismo numero_documento y el DeCA completo ya corregido (todos los campos, no solo lo que cambia). Es lo mismo que hace el botón «Modificar» de la plataforma web, y cumple la segunda opción de la Resolución para cambios una vez empezado el servicio:

• Se genera un documento nuevo, con nueva URL y nuevo QR ("accion": "sustituido").
• El anterior queda marcado como sustituido y se sigue pudiendo descargar. No se borra nunca: la Orden pide conservarlos al menos un año.
• Al principio de las observaciones del nuevo se escribe la nota, que también sale en el PDF: Sustituye al documento DECA_….pdf. Motivo: …. El motivo es el campo motivo, o Cambiado desde API si no lo mandas. No la añadas tú; si la reenvías copiada del documento anterior, se quita y no se repite.
• Haz llegar el nuevo PDF o la nueva URL a quien conduce. El QR antiguo ya no es el válido. Lo que no vale es corregir a mano una copia impresa.

// 1.ª llamada                                  → 201, "accion": "creado", "id": 123
{ "numero_documento": "ALB-2026-0001", "matricula_remolque": "R1234BCD", … }

// Cambia el remolque: mismo número, todo el DeCA → 201, "accion": "sustituido", "id": 124, "sustituye_a": 123
{ "numero_documento": "ALB-2026-0001", "matricula_remolque": "R5678FGH", "motivo": "cambio de remolque", … }

Borrador sin transportista: lo completa quien lee el QR

Para cuando aún no sabes qué transportista ni qué camión harán el viaje. Manda el DeCA sin transportista, matricula_tractor, matricula_remolque ni autorizacion_especial y con "transportista_pendiente": true:

• Se crea un borrador ("estado": "pendiente") con su url y su QR definitivos, pero sin PDF ("pdf_base64": null). Imprime o manda el QR ya: no cambia.
• La primera persona que abre la URL (o lee el QR) escribe el NIF completo del transportista y la matrícula. Sin desplegables: tienen que coincidir con los transportistas y vehículos de la empresa (/maestros). Si la empresa tiene activados los datos escritos a mano, lo que no esté se puede escribir solo para ese DeCA; si no, no se puede cerrar. Con remolques separados, también el remolque.
• Al confirmar se genera el PDF en esa misma URL y el DeCA queda cerrado ("estado": "activo"): desde entonces el QR abre el PDF y funciona como cualquier otro DeCA (mismo número = sustituir, etc.).
• El borrador reserva su número: otra llamada con el mismo numero_documento lo sustituye, como a un activo. Un borrador sustituido queda muerto para siempre: su QR dice que ya no vale.
• Si pasa la fecha_transporte sin completarse, caduca ("estado": "caducado") y libera el número. La oficina también puede anularlo desde la plataforma web.
• Para saber si ya se cerró y recoger el PDF: GET /deca/{id}, o descarga la url.

{
  "cargador":         { "nombre": "Hormigones Ejemplo SL", "nif": "B12345678", "domicilio": "Pol. Ind. Norte 4, 21007 Huelva" },
  "fecha_transporte": "2026-10-06",
  "numero_documento": "ALB-2026-0002",
  "envios": [{ "origen_localidad": "Huelva (Huelva)", "destino_localidad": "Aljaraque (Huelva)", "mercancia": "Hormigón HA-25", "peso": "24.000 kg" }],
  "transportista_pendiente": true
}
// → 201, "estado": "pendiente", "pdf_base64": null, "url" y "qr_png_base64" ya válidos

GET /deca/{id}: estado y PDF de un DeCA

Con el mismo Authorization: Bearer. También vale GET /deca?id=123. Solo ves los documentos de tu empresa (si no, 404).

curl https://deca.infonetconsultores.com/deca/123 -H "Authorization: Bearer TU_TOKEN"

{
  "ok":                 true,
  "id":                 123,
  "estado":             "activo",
  "numero_documento":   "ALB-2026-0002",
  "fecha_transporte":   "2026-10-06",
  "sustituye_a":        null,
  "sustituido_por":     null,
  "fichero":            "DECA_3f9a….pdf",
  "url":                "https://deca.infonetconsultores.com/documentos/…/DECA_3f9a….pdf",
  "creado":             "2026-10-05T18:02:00+02:00",
  "cerrado":            "2026-10-06T06:41:00+02:00",
  "transportista":      { "nombre": "Transportes Pérez SL", "nif": "B87654321" },
  "matricula_tractor":  "1234ABC",
  "matricula_remolque": "R1234BCD",
  "pdf_base64":         "JVBERi0xLjcK…",
  "qr_png_base64":      "iVBORw0KGgo…"
}

Gestión: POST /administrador

Los endpoints de gestión se llaman con el token de la empresa, el mismo de POST /deca (el que devuelve /alta), en la cabecera Authorization: Bearer <token>. Todo lo que hacen queda dentro de esa empresa: no se ve ni se toca nada de otra. Responden JSON con "ok": true o "ok": false y "error".

Pone contraseña nueva al acceso web <cliente>.administrador que crea /alta. Sin cuerpo se genera una aleatoria de 16 caracteres; con {"password": "..."} se pone esa (de 8 a 72 caracteres, sin espacios al principio ni al final). Si el acceso estaba desactivado, se reactiva; si no existe, se crea como acceso de oficina (HTTP 201). La contraseña anterior deja de valer en el momento.

# Aleatoria
curl -X POST https://deca.infonetconsultores.com/administrador \
  -H "Authorization: Bearer TOKEN_EMPRESA"

# Elegida
curl -X POST https://deca.infonetconsultores.com/administrador \
  -H "Authorization: Bearer TOKEN_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"password":"MiClaveSegura1"}'

{
  "ok":       true,
  "creado":   false,
  "usuario":  "hormigonesejemplo.administrador",
  "password": "Xk7mPq2RtW9vHn4c",
  "acceso":   "https://deca.infonetconsultores.com/app/"
}

200 si el acceso ya existía, 201 si se ha creado. 409 si la empresa no tiene matriz de usuarios (empresas antiguas dadas de alta a mano): no tiene <cliente>.administrador; pídenoslo.

Gestión: /maestros

Los maestros son las listas de la plataforma web con las que se rellena un DeCA: cargadores, transportistas (empresas de transporte), vehículos y mercancías. Por API se consultan y se mantienen igual que desde la web. POST /deca no los necesita: sigue recibiendo los datos en texto.

El tipo va en la URL (o en el JSON en POST y PUT). NIF y matrículas se normalizan como en el modo C: "b-12.345 678" se guarda "B12345678", "1234 abc" se guarda "1234ABC".

• GET sin id ni clave devuelve la lista de activos; con &todos=1, también los desactivados. En vehículos, &transportista_id=5 filtra por transportista.
• POST no crea duplicados: si ya hay uno con la misma clave devuelve ese con HTTP 200 y "creado": false, sin modificarlo (para cambiarlo, PUT). Si estaba desactivado, lo reactiva ("reactivado": true). Si lo crea, HTTP 201.
• PUT cambia solo los campos que mandes; el resto queda como estaba. Con "activo": true|false lo activa o desactiva.
• DELETE no borra: desactiva. Deja de salir en los formularios, pero los documentos ya hechos con él no cambian. Un POST con la misma clave lo reactiva.

Transportista con sus vehículos

En POST y PUT de tipo=transportistas (y en el transportista de /conductores) puedes mandar "vehiculos": una lista de objetos con matricula (obligatoria), matricula_remolque y autorizacion. Para cada uno:

• Matrícula nueva: se crea como vehículo de ese transportista.
• Matrícula que ya existe: pasa a ser de ese transportista (aunque fuera de otro), se actualizan los campos que mandes (los que no, se quedan) y se reactiva si estaba desactivada.
• Los vehículos que ya tenía el transportista y no vienen en la lista no se tocan: para quitar uno, DELETE /maestros?tipo=vehiculos&id=....
• Va todo junto: si un vehículo no vale (error 422 con "vehiculos[1]: ..."), no se guarda nada, ni el transportista ni los demás vehículos.

Esto vale también cuando el transportista ya existe (HTTP 200): no se cambian sus datos, pero sí se añaden o actualizan los vehículos. La respuesta trae "vehiculos_creados" (cuántos eran nuevos) y el transportista con todos sus vehículos activos en maestro.vehiculos. Un transportista siempre sale con su lista vehiculos, también en GET.

# Alta de una empresa de transporte con sus vehículos
curl -X POST "https://deca.infonetconsultores.com/maestros?tipo=transportistas" \
  -H "Authorization: Bearer TOKEN_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Transportes Pérez SL","nif":"B87654321",
       "vehiculos":[{"matricula":"1234ABC","matricula_remolque":"R1234BCD"},{"matricula":"5678DEF"}]}'

# Un vehículo suelto
curl -X POST "https://deca.infonetconsultores.com/maestros?tipo=vehiculos" \
  -H "Authorization: Bearer TOKEN_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"transportista_nif":"B87654321","matricula":"1234ABC","matricula_remolque":"R1234BCD"}'

# ¿Existe este NIF?
curl "https://deca.infonetconsultores.com/maestros?tipo=transportistas&clave=B87654321" \
  -H "Authorization: Bearer TOKEN_EMPRESA"

Respuesta de un elemento (POST, PUT, DELETE y GET con id o clave):

{
  "ok":                true,
  "tipo":              "transportistas",
  "creado":            true,   // solo en POST
  "reactivado":        false,  // solo en POST
  "vehiculos_creados": 2,      // solo si mandas "vehiculos"
  "maestro": {
    "id":     5,
    "nombre": "Transportes Pérez SL",
    "nif":    "B87654321",
    "activo": true,
    "creado": "2026-10-05T11:40:00+02:00",
    "vehiculos": [   // solo en transportistas
      {"id": 8, "matricula": "1234ABC", "matricula_remolque": "R1234BCD", "autorizacion": ""},
      {"id": 9, "matricula": "5678DEF", "matricula_remolque": "", "autorizacion": ""}
    ]
  }
}

La lista (GET sin id) devuelve {"ok": true, "tipo": "...", "total": 3, "maestros": [ ... ]} con elementos de la misma forma.

Remolques separados

Por defecto cada vehículo lleva su remolque y su autorización: todo lo de arriba. Para empresas cuyos tractores y remolques se van combinando, Infonet puede activar los remolques separados. Sin esa opción no cambia nada; con ella:

• Existe tipo=remolques, con el mismo GET/POST/PUT/DELETE que los demás maestros (&transportista_id=5 filtra la lista). Cada remolque es de un transportista y lleva su autorizacion especial.
• Un transportista admite "remolques": [{"matricula": "R1234BCD", "autorizacion": "..."}], igual que "vehiculos" (también en /conductores). La respuesta trae "remolques_creados" y el transportista sale con vehiculos y remolques.
• Los vehículos son solo el tractor: salen como {"id", "matricula"}, y si mandas matricula_remolque o autorizacion en un vehículo se rechaza con 422 ("matricula_remolque: esta empresa tiene los remolques separados…") en vez de perderse sin avisar.
• En la plataforma web, el DeCA se hace eligiendo vehículo y, aparte, remolque (o «Sin remolque»).
• POST /deca es igual en los dos casos: matricula_remolque y autorizacion_especial siguen yendo en texto.

En una empresa sin la opción, tipo=remolques o "remolques" en un transportista devuelven 422 explicando que hay que pedirla a Infonet.

# Empresa con remolques separados: tractores y remolques por separado
curl -X POST "https://deca.infonetconsultores.com/maestros?tipo=transportistas" \
  -H "Authorization: Bearer TOKEN_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Transportes Pérez SL","nif":"B87654321",
       "vehiculos":[{"matricula":"1234ABC"},{"matricula":"5678DEF"}],
       "remolques":[{"matricula":"R1234BCD","autorizacion":"AE-2026-15"},{"matricula":"R5678FGH"}]}'

Gestión: GET · POST /conductores

Un conductor es un acceso a la plataforma web ligado a una empresa de transporte: solo puede usar ese transportista y sus vehículos y solo ve los documentos que crea él. Con una llamada se crea el acceso y, si hace falta, la empresa de transporte.

curl -X POST https://deca.infonetconsultores.com/conductores \
  -H "Authorization: Bearer TOKEN_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Luis Pérez",
    "usuario": "luis",
    "password": "LuisClave2026",
    "nif_vehiculo": "12345678Z",
    "transportista": {
      "nombre": "Transportes Pérez SL",
      "nif": "B87654321",
      "vehiculos": [{"matricula": "1234ABC", "matricula_remolque": "R1234BCD"}]
    }
  }'

{
  "ok":                   true,
  "creado":               true,
  "transportista_creado": false,
  "vehiculos_creados":    1,
  "id":                   31,
  "usuario":              "hormigonesejemplo.luis",
  "nombre":               "Luis Pérez",
  "nif_vehiculo":         "12345678Z",
  "activo":               true,
  "ultimo_acceso":        null,
  "transportista": {
    "id": 5, "nombre": "Transportes Pérez SL", "nif": "B87654321", "activo": true,
    "vehiculos": [{"id": 8, "matricula": "1234ABC", "matricula_remolque": "R1234BCD", "autorizacion": ""}]
  },
  "acceso":               "https://deca.infonetconsultores.com/app/"
}

• 201: conductor nuevo. 200: el usuario ya era conductor de la empresa; se le ponen el nombre, la contraseña y el transportista enviados, y se reactiva si estaba desactivado. Sirve, por tanto, para cambiarle la contraseña o pasarlo a otra empresa de transporte.
• 409: el usuario es un acceso de oficina (por ejemplo administrador): no se convierte en conductor. Elige otro usuario.
• Si algo falla no se guarda nada a medias: ni el transportista, ni sus vehículos, ni el acceso.
• GET /conductores devuelve {"ok": true, "total": 2, "conductores": [ ... ]} con elementos como el de arriba (sin creado ni acceso). GET /conductores?usuario=luis o GET /conductores?nif_vehiculo=12345678Z devuelve {"ok": true, "conductor": { ... }} o 404.

Errores de gestión

Clientes: GET · POST /alta

Para las aplicaciones de Infonet. Con el cliente aplicación averiguas si la empresa ya está dada de alta y obtienes su token del modo C, o la das de alta en el momento. Nunca se crean duplicados: un POST con un cliente aplicación que ya existe no crea otro, devuelve el existente. Por eso puedes llamar a POST /alta siempre que tu aplicación necesite el token, sin comprobar antes.

El token devuelto es siempre el mismo para cada empresa. Guárdalo y úsalo en POST /deca; si lo pierdes, vuelve a pedirlo. Solo cambia si lo renovamos desde nuestro panel.

Una empresa nueva se crea con un año de cuota, con el cliente aplicación como nombre provisional y con un acceso a la plataforma web: el usuario <cliente>.administrador (por ejemplo hormigonesejemplo.administrador) con una contraseña aleatoria. Usuario y contraseña vienen en la respuesta 201 y solo en esa: guárdalos o pásaselos a la empresa en ese momento. Su nombre, contacto y más accesos se completan en el panel.

Cabeceras

Parámetros

Ejemplos

# ¿Existe? Si existe, su token
curl https://deca.infonetconsultores.com/alta?cliente=hormigonesejemplo \
  -H "Authorization: Bearer TOKEN_MAESTRO"

# Alta si no existe (o el existente si ya está)
curl -X POST https://deca.infonetconsultores.com/alta \
  -H "Authorization: Bearer TOKEN_MAESTRO" \
  -H "Content-Type: application/json" \
  -d '{"cliente":"hormigonesejemplo"}'

Respuesta

{
  "ok":        true,
  "existe":    true,
  "creado":    false,
  "id":        12,
  "cliente":   "hormigonesejemplo",
  "nombre":    "Hormigones Ejemplo SL",
  "token":     "3f9a1c0d8b2e4f6a9c1d3e5f7a9b0c2e…",
  "caducidad": "2027-10-06"
}

Si el POST la acaba de crear (HTTP 201), además:

{
  "ok":        true,
  "existe":    true,
  "creado":    true,
  …
  "usuario":   "hormigonesejemplo.administrador",
  "password":  "Xk7mPq2RtW9vHn4c",
  "acceso":    "https://deca.infonetconsultores.com/app/"
}

Errores