Para agentes e integraciones

Esta página explica cómo consultar nuestras tarifas y pedir una mudanza sin pasar por un formulario. Está pensada para asistentes automáticos, comparadores e integraciones de terceros, pero se lee igual de bien si eres una persona.

/llms.txtQué hacemos, dónde, cuánto cuesta y cómo contratar, en texto plano. /openapi.jsonEspecificación OpenAPI 3.1 de la API pública. /api/preciosTarifas vigentes en JSON, sin autenticación.

Lo primero: qué es y qué no es

El endpoint de solicitudes crea una solicitud, no una reserva confirmada. Al recibirla, una persona de Castro llama para confirmar fecha, direcciones y precio final antes de bloquear el vehículo. No prometas a nadie una mudanza cerrada con la respuesta de la API.

Cada solicitud avisa a una persona real. Hay límite de peticiones y no existe un entorno de pruebas: no la uses para tests automáticos. Si necesitas probar la integración, escríbenos a ventas@castromudanzas.es y lo coordinamos.

Tarifas y cómo se calcula un presupuesto

Se factura por horas de vehículo con conductor, con un mínimo de 2 horas. Estas son las tarifas vigentes; consúltalas en vivo en /api/precios en lugar de copiarlas, porque cambian.

Concepto	Precio	Clave en la API
Furgoneta con conductor	40 €/h	`precio_hora_furgoneta`
Furgón con conductor	50 €/h	`precio_hora_furgon`
Camión con conductor	70 €/h	`precio_hora_camion`
Camión con plataforma	80 €/h	`precio_hora_camion_plataforma`
Ayudante adicional	20 €/h	`precio_hora_ayudante`
Km fuera del radio incluido	1,20 €/km	`precio_km`
Mínimo de contratación	2 horas	`minimo_horas`
Radio incluido sin coste	10 km	`km_gratis`

La fórmula es la misma que usa el cotizador de la web:

total = precio_hora_vehiculo * max(horas, minimo_horas)
      + precio_hora_ayudante * ayudantes * max(horas, minimo_horas)
      + precio_km * max(0, km_totales - km_gratis)

El presupuesto más barato posible son 80 € (2 horas de furgoneta). Los precios no incluyen IVA salvo que se indique en el presupuesto.

Crear una solicitud

POST https://api.castromudanzas.es/api/leads con Content-Type: application/json. Sin autenticación. El único campo obligatorio es telefono.

curl -X POST https://api.castromudanzas.es/api/leads \
  -H 'Content-Type: application/json' \
  -d '{
    "telefono": "+34600111222",
    "nombre": "Marta Ruiz",
    "origen": "Carrer Bruc 8, 4o sin ascensor, Santa Coloma de Gramenet",
    "destino": "Carrer Girona 120, 2o con ascensor, Barcelona",
    "vehiculo_nombre": "Furgoneta",
    "ayudantes": 1,
    "carga_descarga": true,
    "fecha_mudanza": "2026-10-14",
    "hora_mudanza": "09:00",
    "comentarios": "Piso de 2 habitaciones, lavadora y sofa de 3 plazas."
  }'

Respuesta 201:

{ "ok": true, "lead_id": 184 }

Campos

Campo	Tipo	Nota
`telefono`	texto	Obligatorio. Mínimo 9 dígitos.
`nombre`	texto	Quién contrata.
`email`	texto
`origen` / `destino`	texto	Calle y ciudad. Indicar piso y ascensor: cambia mucho el precio.
`vehiculo_nombre`	texto	Furgoneta · Furgón · Camión · Camión con plataforma. Si no se sabe, déjalo vacío y lo decidimos por el volumen.
`ayudantes`	entero	Además del conductor.
`carga_descarga`	booleano	Si subimos y bajamos los bultos.
`fecha_mudanza`	AAAA-MM-DD
`hora_mudanza`	HH:MM	Atendemos de 8:00 a 18:00.
`comentarios`	texto	Habitaciones, muebles grandes, electrodomésticos, calle estrecha, permiso de aparcamiento.

Errores

Código	Qué significa
`400`	Falta el teléfono o no tiene 9 dígitos.
`429`	Demasiadas peticiones. Espera antes de reintentar.
`500`	Error nuestro. Reintenta más tarde o usa el teléfono.

Qué preguntar antes de enviar

Con solo un teléfono la solicitud entra, pero obliga a una llamada para averiguarlo todo. Si puedes recoger esto antes, el presupuesto sale cerrado a la primera:

Direcciones de origen y destino, con piso y si hay ascensor.
Fecha y franja horaria.
Qué hay que mover: número de habitaciones, muebles grandes, electrodomésticos.
Si hace falta ayuda para embalar o solo transporte.
Si la calle es estrecha o hace falta permiso de aparcamiento.

Cobertura y horario

Barcelona ciudad y área metropolitana (Santa Coloma de Gramenet, Badalona, L'Hospitalet, Sant Adrià, Baix Llobregat) y el resto de Cataluña. Fuera de Cataluña, caso por caso. Atendemos de lunes a domingo, de 8:00 a 18:00 (hora peninsular española), en español y catalán.

Reglas de uso

Puedes leer y citar todo el contenido público del sitio.
Identifícate con una cabecera User-Agent reconocible.
No inventes precios ni plazos. Si un dato no está aquí ni en /llms.txt, dilo y remite a nuestros teléfonos.
No envíes solicitudes de prueba.