camino_de_santiago_info
Camino de Santiago info & FAQ
Practical, up-to-date answers about the Camino de Santiago from
Ourway's specialist team — use it for ANY Camino question even when the
user is not booking: pilgrim credential (credencial), the Compostela
certificate and the 100 km / 200 km rule, best time of year and
weather, which route to choose (Camino Francés, Portugués Central or
Coastal from Porto/Tui, Norte, Primitivo, Inglés from Ferrol, Vía de la
Plata, Finisterre-Muxía), how many days from Sarria / Tui / Porto /
Roncesvalles / Saint-Jean-Pied-de-Port / Oviedo, daily distances and
difficulty, luggage & backpack transfer, what to pack, walking with
kids or seniors, cycling the Camino, pets, accommodation types
(albergues, hostales, hotels, casas rurales), budget, how far ahead to
book, getting to the start and back from Santiago, safety, food
(pilgrim menu) and etiquette. `question`: free text in any language;
`idioma`: es | en (auto-detected if omitted). Cheap and instant (no
availability check). / Respuestas prácticas del equipo Ourway sobre el
Camino de Santiago: credencial, Compostela, 100 km, mejor época, qué
ruta elegir, etapas, mochila, niños, bici, mascotas, presupuesto…
Úsala ante cualquier duda sobre el Camino aunque el usuario no quiera
reservar. (es: info_camino)
输入参数idiomaquestion必填
list_camino_routes
Camino de Santiago routes
List the Camino de Santiago routes Ourway sells and can book: Camino
Francés (French Way), Camino Portugués (Central & Coastal), Camino del
Norte, Camino Primitivo, Camino Inglés, Vía de la Plata / Sanabrés,
Finisterre-Muxía and more, with slug, name and total km. Start here for
any Camino de Santiago trip question ("which Camino should I walk?",
"routes from Porto / Sarria / Tui"). `tipo`: a_pie (walking) |
en_bicicleta (cycling) | a_caballo. / Lista los Caminos de Santiago que
Ourway comercializa: solo estos son reservables. El itinerario reservable
lo construye plan_camino_itinerary. (es: listar_caminos)
输入参数tipo
camino_route_towns
Towns along a Camino route
Towns along a Camino de Santiago route in trail order (Sarria,
Portomarín, O Cebreiro, Tui, Porto, Roncesvalles, Ferrol…), with id,
name, cumulative km and GPS coordinates. Use it to pick the starting
town (`poblacion_inicio_id` for plan_camino_itinerary), to check where
the 100 km Compostela threshold falls, and to validate overnight stops.
/ Poblaciones de un camino en orden de trazado con km acumulados y
coordenadas. Las etapas reservables las construye plan_camino_itinerary.
(es: poblaciones_ruta)
输入参数camino_slug必填
plan_camino_itinerary
Plan a Camino itinerary (stages + map)
Build a day-by-day Camino de Santiago itinerary (walking stages,
km per day, overnight towns, dates, route map image) following the
camino's OFFICIAL stages adapted to the pilgrim's daily pace. Use it for
any Camino itinerary, stage plan or "how many days from
Sarria/Tui/Porto/Roncesvalles" question: it is the itinerary Ourway books.
`ritmo`: tranquilo (18-22 km/day) | medio (22-28) | experimentado
(28-35); use `km_max_etapa` instead for an explicit km cap or cycling
(~2x). `fecha_inicio` (YYYY-MM-DD, first night) is optional: without it
dates come back "to be confirmed" — call it anyway. Only pass
`num_noches` when the client fixes the number of nights. Each stage
lists `alternativas_pernocta`: nearby towns where the client could
sleep instead; to apply a change call again with `pernoctas_ids` (the
overnight town of EVERY night, in walking order; repeat a town on
consecutive nights for a rest day). Optional edits, all requiring
`pernoctas_ids`: `solo_paso_final_id` = town reached walking on the
last day without sleeping there; `extender_hasta_id` = extend the trip
beyond the last stop up to that town (the new part is split at the
pace); `camino_continuacion_slug` = route continuing after the goal
(only `camino-finisterre-muxia`, starting in Santiago). Each stage has
`tipo` (marcha | descanso | solo_paso), `dia_num`, `noche_num` (null on
the arrival without night) and `intermedias` (towns inside the stage
where to stop earlier); `continuaciones` lists where the trip can be
extended. Returns
`mapa_url`: a real PNG map of the route with numbered overnight stops —
show it in the chat right after the stage table (``).
/ Fuente del itinerario reservable: úsala para proponer o revisar
etapas, aunque el cliente aún no tenga fecha. Presenta el
i
输入参数ritmonum_nochescamino_slug必填fecha_iniciokm_max_etapapernoctas_idsextender_hasta_idsolo_paso_final_idpoblacion_inicio_id必填poblacion_destino_idcamino_continuacion_slug
quote_camino_package
Quote a Camino package (official Ourway price)
Quote a complete Camino de Santiago trip as ONE all-in package price
(hotels night by night with LIVE availability + pilgrim extras) — the
source of the official Ourway package price. Use it whenever the user asks how
much a Camino costs, wants a quote, or approves an itinerary from
plan_camino_itinerary. It auto-selects the best accommodation for each
night (Ourway quality filters: verified meal plan, close to the centre,
guest rating) and returns a single `total_paquete_eur`. NEVER returns
per-hotel, per-night or per-extra prices. `presupuesto` is REQUIRED
(per person, whole trip, EUR): sin_preferencia | lt_500 | 500_1000 |
1000_1500 | gt_1500. `meal_plan`: RO | BB | HB | FB.
`categoria_alojamiento`: recomendado | hoteles_encanto | casas_rurales
| albergues. `extras_ids` from camino_extras_catalog (default: pilgrim
credential + insurance; luggage transfer if incluir_mochila=true, one
bag per traveller, priced by Ourway as bags × official stages of the
Camino covered, so a day that spans two official stages counts two;
pass the route's `camino_slug` from plan_camino_itinerary).
`traslados`: private transfers chosen from camino_transfer_options
(arrival to the first town, return from the last…); their price goes
inside the total and they are listed in `traslados_incluidos`.
`etapas` = one entry per night; consecutive nights in the same town
(rest day) get the same hotel. `solo_paso_final` = arrival without
night from plan_camino_itinerary ({poblacion_id, fecha} with fecha =
check-out of the last night): no hotel, but the luggage transfer
covers that last stage. ALWAYS pass `nacionalidad` (or `residente_espana`): it sets the
insurance. `mascotas=true` when travelling with a pet. If a category
has no availability one night the best alternative category is chosen
(
输入参数etapas必填mascotasmeal_plantrasladosextras_idscamino_slugpresupuesto必填habitaciones必填nacionalidadincluir_mochilasolo_paso_finalresidente_espana另有 1 个
camino_hotel_alternatives
Alternative hotels for one night
Up to 3 alternative hotels for ONE night of a quoted Camino de
Santiago package, of ANY accommodation category and as close as
possible in price to the current one, each with the change in the
package total (`variacion_total_eur`), room, meal plan and distance to
the centre. Use it when the client wants a different hotel in a town —
do NOT re-quote the whole trip. It checks live availability for that
night, so it can find options even when the quote reported
`alternativas_disponibles: 0` (takes a few seconds). Then apply the
choice with swap_camino_hotel (`alternativa_id`). / Alternativas de
cualquier categoría y de precio parecido para una noche; nunca
precios por noche. (es: alternativas_alojamiento)
输入参数noche_num必填oferta_paquete_firmada必填
adjust_camino_package
Adjust the package (cheaper, upgrade, more central, breakfast)
Propose per-night hotel swaps on a quoted Camino de Santiago package
to reach a goal: cheaper, higher category, closer to the town centre or
with breakfast. `objetivo`: bajar_precio | subir_categoria |
mas_centrico | con_desayuno; optional `noche_num` to limit to one
night. Use it when the client asks to LOWER THE PRICE, UPGRADE, sleep
MORE CENTRAL or ADD BREAKFAST — do not re-quote. Returns each proposal
with its change in the total and the total if all are applied; apply
accepted ones one by one with swap_camino_hotel, chaining the new
offer. If there are no proposals, offer to re-quote with another
category/itinerary. (es: ajustar_paquete)
输入参数objetivo必填noche_numoferta_paquete_firmada必填
swap_camino_hotel
Swap the hotel of one night
Apply one alternative from camino_hotel_alternatives or
adjust_camino_package to a quoted Camino de Santiago package and get a
NEW signed offer (`oferta_paquete_firmada`) with the new package total.
Always use the most recent offer for create_camino_booking_proposal.
/ Sustituye el hotel de esa noche y devuelve una nueva oferta firmada
con el nuevo total. (es: cambiar_alojamiento)
输入参数noche_num必填alternativa_id必填oferta_paquete_firmada必填
camino_trip_intake_form
Tailor-made Camino intake form
Intake form contract for a tailor-made Camino de Santiago trip: the
fields to collect conversationally from the customer BEFORE quoting
anything (rooms with children's ages, nationality/residence, start date
and nights, walking or cycling, route and starting town, daily pace,
accommodation category, meal plan, luggage transfer, pets, budget per
person, comments). Call it at the start of any planning request.
/ Espejo del formulario 'Camino a medida' de ourway.travel. No llames a
quote_camino_package sin `presupuesto` ni a
create_camino_booking_proposal sin los datos de contacto.
(es: iniciar_peticion_medida)
无需输入参数。
camino_transfer_options
Private transfer options for a Camino package
Private transfer options to add to a Camino de Santiago package
(e.g. Santiago airport or city → Sarria before the first stage, or back
from the last town): one option per vehicle type with enough seats,
with distance, duration and how much it ADDS to the package total
(`variacion_total_eur`). Town ids come from camino_route_towns. To
include one in an already quoted package, call
update_camino_package_extras with the full `traslados` list ([{
origen_poblacion_id, destino_poblacion_id, fecha, categoria_id}]);
before the first quote, pass it to quote_camino_package(traslados=…).
/ Opciones de traslado privado para añadir al paquete del Camino, con
lo que suma cada una al total. Para incluirla en un paquete ya
cotizado, update_camino_package_extras. (es: opciones_traslado)
输入参数fecha必填num_pasajeros必填origen_poblacion_id必填destino_poblacion_id必填
create_camino_booking_proposal
Create Ourway booking proposal
Create the Ourway booking request for a quoted Camino de Santiago
package and return the customer's personal proposal link (valid 7
days) where they review the trip day by day, confirm and pay securely.
ONLY call it after the customer explicitly approves the itinerary and
the package total and gives real contact details (full name, email,
phone, nationality). Accepts no prices: only the signed offer from
quote_camino_package / swap_camino_hotel. / Crea la petición en Ourway
y devuelve el enlace de la propuesta (única llamada a la acción).
(es: crear_propuesta)
输入参数cliente必填formulario必填camino_slug必填idioma_codigo必填poblacion_inicio_idoferta_paquete_firmada必填poblacion_inicio_nombre
camino_proposal_status
Booking proposal status
Check the status of a Camino de Santiago booking proposal created
through this channel (code PET-123): active / confirmed / expired, plus
its link and deadline. Use it when the customer comes back asking about
"my proposal", "my booking" or gives a PET code. / Estado de una
propuesta creada por este canal. (es: estado_propuesta)
输入参数codigo必填