Operaciones de la cuenta

Miguel Gómez Pérez · Equipo Bukyapp· 3 min de lectura·Actualizado 16 sept 2026

Consulta los datos de tu centro y edita su configuración por API v1 o MCP.

La «cuenta» es el propio centro en Buky: su ficha pública (nombre, contacto, idiomas, textos legales, logo) y su configuración de contenido (idiomas activos, textos de los emails automáticos, check-in online, colores del tema). Estas dos operaciones leen y editan esa ficha; nunca tocan pago, facturación, plan de suscripción ni datos fiscales. Más contexto en Configuración inicial de tu empresa.

Las bases comunes (autenticación, GET frente a POST, prueba en seco, errores HTTP, límites) están en API v1 — Introducción y primeros pasos. En las dos operaciones, customer_id se toma de tu token: solo hace falta pasarlo con tokens multicuenta.

get-customer: consulta la ficha pública del centro

Devuelve el nombre, el contacto, los idiomas, los textos legales (condiciones, política de cancelación), el enlace al motor de reservas y el logo del centro. Es una operación de solo lectura: vale con cualquier token.

Cómo llamarla

curl "https://api.bukyapp.com/v1/ops/get-customer" \
  -H "Authorization: Bearer bk_TU_TOKEN"

curl -X POST https://api.bukyapp.com/v1/ops/get-customer \
  -H "Authorization: Bearer bk_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"lang": "en"}'

Por MCP: «Enséñame la ficha pública del centro» o «¿En qué idiomas está activo el motor de reservas?».

Parámetros

Qué devuelve

Ejemplo real, recortado (nombre y email sustituidos por ficticios):

{
  "success": true,
  "operation": "get-customer",
  "customer_id": "5a55fff67e9fe0036a541d15",
  "source": "login",
  "customer": {
    "name": "Surf Center Demo",
    "website": null,
    "timezone": "Europe/Madrid",
    "langs": ["es", "en", "de"],
    "contact": {
      "email": "hola@example.com",
      "tel": null,
      "street": null,
      "city": null,
      "zip": null,
      "state": null,
      "country": "es"
    },
    "description": {},
    "conditions": {},
    "cancellation_policy": {},
    "booker_url": "https://app.bukyapp.com/front/5a55fff67e9fe0036a541d15",
    "front_domain": "flycustomtest.rockode.io",
    "front_domain_active": false,
    "thumb_url": "https://app.bukyapp.com/uploads/logo-example.png",
    "icon_url": null
  },
  "warnings": []
}

Errores propios

Consejos

• Usa lang cuando solo necesites un idioma: te ahorras filtrar el objeto completo.

update-customer: edita el contenido y la configuración del centro

Cambia solo los campos que le pasas dentro de fields; el resto de la ficha queda igual. Es una operación fail-closed: solo acepta los campos de una lista permitida de contenido y configuración; cualquier campo de pago, facturación, fiscal o dominio se rechaza aunque se lo pidas. Es una operación de escritura: en esta documentación siempre se ejecuta en modo prueba (dry_run).

Cómo llamarla

curl -X POST https://api.bukyapp.com/v1/ops/update-customer \
  -H "Authorization: Bearer bk_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"conditions": {"es": "<p>Nuevas condiciones de reserva.</p>"}}, "dry_run": true}'

Por MCP: «Cambia el color principal del tema a #0a7» o «Actualiza las condiciones de reserva en español». El asistente te enseña la prueba en seco antes de confirmar el cambio real.

Parámetros

Campos que admite fields:

• Identidad y contacto: name, email_contact, tel, tel_contact, website, timezone, haveDifferentContactAddress, street_address_contact, city_contact, zip_contact, state_contact, country_contact.
• Contenido legal: description, conditions, cancellationPolicy — objetos {idioma: texto}; solo envías los idiomas que cambias, los demás se conservan.
• Idiomas: langs (lista de códigos activos, sustituye el conjunto completo), default_booking_lang. Ver Configurar idiomas y traducciones.
• Emails automáticos: emails_text_accommodation, emails_text_activity, emails_text_pack, emails_text_rental, emails_active_orderEnd, emails_subject_orderEnd, emails_text_orderEnd.
• Check-in online: checkin_online, checkin_prefill, checkin_prefill_valid_days, checkin_until_start_hours. Ver Configurar y gestionar el check-in online.
• Tema visual: theme_template y, dentro de theme, colors (lista de tres colores en hexadecimal, en este orden: principal, secundario y destacado) y hide_catalog_prices. theme se combina con el valor actual: puedes enviar solo colors o solo hide_catalog_prices.
• Otros: calendarExportMode.

Qué devuelve

Prueba en seco real, cambiando las condiciones en español y el color principal del tema:

{
  "success": true,
  "dry_run": true,
  "applied": ["conditions", "theme"],
  "diff": {
    "conditions": {
      "type": "i18n",
      "langs_set": ["es"],
      "langs_preserved": ["de", "en", "fr", "it", "pt", "ca"]
    },
    "theme": {
      "old": { "colors": ["#00ADCA", "#003657", "#FF9B09"], "hide_catalog_prices": false },
      "new": { "colors": ["#0a7", "#003657", "#FF9B09"], "hide_catalog_prices": false }
    }
  },
  "warnings": [
    "conditions: se preservan los idiomas no tocados (de, en, fr, it, pt, ca); solo cambian es."
  ]
}

Errores propios

Consejos

• Corre siempre la prueba en seco primero (o dile a tu asistente «prueba en seco») y revisa el diff antes de confirmar el cambio real.
• Para textos por idioma, envía solo el idioma que cambias: los demás se conservan tal cual.
• Si necesitas tocar pago, pasarelas, facturación, datos fiscales o el dominio propio, hazlo desde el panel de Buky: esta operación los rechaza siempre.