Operaciones de packs

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

Consulta, crea, edita y borra packs con sus opciones, alojamiento y tarifas por API v1 o MCP.

Un pack combina actividades, alojamiento y extras en un solo producto con un precio conjunto, para vender experiencias completas como un surf camp de una semana o una escapada de fin de semana. Cada pack tiene una o varias opciones (el manual las llama «variaciones»): por ejemplo «3 noches», «5 noches» y «7 noches», cada una con su propia duración y sus propias actividades. Si el pack incluye alojamiento, puedes marcar que los acompañantes que solo se alojan, sin hacer actividades, entren gratis hasta llenar la capacidad de la habitación. Más contexto y capturas en Qué es un pack y cuándo usarlo.

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 todas las operaciones de esta página, customer_id se toma del token: solo hace falta indicarlo con tokens multicuenta.

list-packs: enumera los packs de la cuenta

Es una operación de solo lectura: vale con cualquier token. Devuelve todos los packs de la cuenta sin tener que adivinar nombres ni provocar un error de get-pack para ver qué existe. Los packs borrados nunca aparecen.

Cómo llamarla

curl "https://api.bukyapp.com/v1/ops/list-packs?detail=descriptive&disabled=false" \
  -H "Authorization: Bearer bk_TU_TOKEN"

Por MCP: «Enséñame los packs que tengo» o «¿Qué packs están desactivados?».

Parámetros

Qué devuelve

Ejecución real con la cuenta demo, vista compacta (por defecto):

{
  "success": true,
  "operation": "list-packs",
  "detail": "compact",
  "count": 1,
  "total": 1,
  "items": [
    {
      "_id": "5dc98fae75a5229e7c921c1e",
      "title": "Pack1",
      "internalName": null,
      "categories": [],
      "is_disabled": false,
      "variations": ["Opción test"]
    }
  ]
}

Consejos

• Úsala primero para saber qué packs existen y con qué nombre exacto, y luego pasa ese nombre o el _id a get-pack o update-pack.
• detail: "descriptive" te da la ficha a texto plano (opciones, alojamientos, condiciones) sin tener que pedir el documento completo de cada pack.

get-pack: obtiene el doc completo y al día de un pack

Es una operación de solo lectura: vale con cualquier token. Es la forma de comprobar cómo quedó un pack tras crearlo o editarlo, y de conseguir su identificador exacto.

Cómo llamarla

curl "https://api.bukyapp.com/v1/ops/get-pack?pack=Pack1" \
  -H "Authorization: Bearer bk_TU_TOKEN"

Por MCP: «Enséñame el pack Pack1» o «¿Qué opciones tiene el pack Surf Camp?».

Parámetros

Qué devuelve

Ejemplo real con la cuenta demo:

{
  "success": true,
  "operation": "get-pack",
  "_id": "5dc98fae75a5229e7c921c1e",
  "resolved": { "id": "5dc98fae75a5229e7c921c1e", "reason": "match exacto 'Pack1'" },
  "item": {
    "_id": "5dc98fae75a5229e7c921c1e",
    "title": { "es": "Pack1", "en": "New", "...": "..." },
    "variations": [
      { "_id": "61a9d9ae1728d00000d0aaf1", "title": { "es": "Opción test" }, "nights": 6, "activities": [] }
    ],
    "accommodations": [],
    "rates": [
      { "_id": "61a9d9c61728d00000d0aaf2", "variation": "61a9d9ae1728d00000d0aaf1", "price": 0, "accommodation": null }
    ],
    "priceMode": "pricePerFullPack",
    "paymentMode": "full"
  }
}

Errores propios

create-pack: crea el contenedor del pack

Es una operación de escritura. Crea el pack vacío —título, descripción e impuestos—; las opciones, los alojamientos y la matriz de precio se añaden después con update-pack. Es el mismo orden en dos pasos que sigue el panel: primero guardas el pack, luego se habilitan las pestañas para configurarlo.

Cómo llamarla

curl -X POST https://api.bukyapp.com/v1/ops/create-pack \
  -H "Authorization: Bearer bk_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Semana de Surf Ficticia", "taxes": "IVA", "dry_run": true}'

Por MCP: «Crea un pack llamado Surf Camp 7 noches».

Parámetros

Qué devuelve

Prueba en seco real, sin pasar impuesto (toma el de la cuenta por defecto):

{
  "success": true,
  "dry_run": true,
  "resolved_taxes": [{ "id": "69a181ce5d6272575493bcfd", "reason": "default (primer tax del customer)" }],
  "payload_preview": {
    "title": { "es": "Pack de prueba sin impuestos", "en": "New", "...": "..." },
    "description": { "es": "", "en": "", "...": "..." },
    "taxes": ["69a181ce5d6272575493bcfd"]
  }
}

Errores propios

Consejos

• Después de crear el pack, llama a update-pack con accommodations, variations y rates para convertirlo en una estancia o un surfcamp de verdad; sin eso el pack queda como un contenedor vacío.

update-pack: añade opciones, alojamientos y la matriz de precio

Es una operación de escritura. Reescribe el pack entero: obtiene el documento actual, le aplica los cambios que le pases y lo guarda completo. Por eso accommodations, variations, rates, taxes, extras y categories reemplazan el conjunto anterior entero — pasa siempre la lista completa que quieres que quede, no solo lo nuevo. Los identificadores de las opciones y alojamientos que ya existían se conservan si el título o el alojamiento coinciden.

Cómo llamarla

curl -X POST https://api.bukyapp.com/v1/ops/update-pack \
  -H "Authorization: Bearer bk_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pack": "Surf Camp", "title": "Surf Camp Pro", "dry_run": true}'

Por MCP: «Cambia el título del pack Surf Camp a Surf Camp Pro» o «Añade la opción de 7 noches al pack Surf Camp con alojamiento en Bungalow 1 a 590€».

Parámetros — identidad y catálogo

Parámetros — opciones, alojamientos y precio

Parámetros — programación, fechas y pago

Qué devuelve

Prueba en seco real: añade una opción de 7 noches con el alojamiento «bungalow 1» a 590 €.

{
  "success": true,
  "dry_run": true,
  "_id": "5dc98fae75a5229e7c921c1e",
  "changes": {
    "accommodations": [{ "_id": "a9145bff...", "resource": "6a37ee3830e0c1f575f79611", "haveConditions": true, "haveCompanions": true }],
    "variations": [{ "_id": "f66f048a...", "title": { "es": "7 NOCHES" }, "nights": 7, "activities": [] }],
    "priceMode": "pricePerFullPack",
    "rates": [{ "_id": "f1f2455c...", "price": 59000, "variation": "f66f048a...", "accommodation": "6a37ee3830e0c1f575f79611" }]
  },
  "warnings": [
    "se REEMPLAZAN 1 variación(es) por 1 (los _id casados por título se preservan)",
    "se REEMPLAZAN 1 rate(s) por 1 (pasa el conjunto completo de la matriz)"
  ]
}

Errores propios

Consejos

• Pasa siempre el conjunto completo de variations, accommodations o rates que quieres que quede: un patch parcial borra las que no incluyas.
• Prueba primero en seco (sin dry_run:false en tu propio backend, o simplemente confiando en este script) para ver el aviso de warnings antes de aplicar el cambio de verdad.
• Para saber qué días puede reservar un pack con una opción y unos acompañantes concretos, usa get-calendar con pack, option (la opción o variación) y only_stay (acompañantes que solo se alojan) — ver Operaciones de disponibilidad, calendario y precios.

delete-pack: borra un pack

El pack deja de verse en el panel y en la tienda. No puedes deshacerlo desde la API ni desde el asistente, pero el soporte de Buky puede recuperarlo si lo necesitas. No afecta a las reservas ya confirmadas de ese pack. Es una operación de escritura.

Cómo llamarla

curl -X POST https://api.bukyapp.com/v1/ops/delete-pack \
  -H "Authorization: Bearer bk_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pack": "Pack Fin de Semana Inventado", "confirm": true, "dry_run": true}'

Por MCP: «Borra el pack Fin de Semana Inventado».

Parámetros

Qué devuelve

Prueba en seco real sobre «Pack1»:

{
  "success": true,
  "dry_run": true,
  "would_delete": { "_id": "5dc98fae75a5229e7c921c1e", "name": "Pack1" },
  "soft_deleted": false,
  "reversible": true,
  "warnings": []
}

Errores propios