Il Mio Viaggio a New York es un operador turístico y revendedor en lengua italiana con sede en Midtown Manhattan, que organiza sus propios tours guiados por Manhattan, Brooklyn y Harlem y revende entradas para atracciones, localidades de Broadway, pases urbanos y excursiones de un día. Para los operadores, aporta viajeros italianos que visitan Nueva York y planifican en su propio idioma antes de salir, comprando entradas, pases y excursiones en torno a su estancia en la ciudad.

Conectar Il Mio Viaggio a New York con Ventrata sincronizará su disponibilidad y sus precios, y le hará llegar las reservas, modificaciones y cancelaciones con las entradas emitidas automáticamente.

Para obtener más información sobre cómo asociarse con Il Mio Viaggio a New York, visite ilmioviaggioanewyork.com.

Sitio web principal	ilmioviaggioanewyork.com
Etiquetas	Operator Reselling Others
Mercados de destino	🌎 Global
Mercados emisores	🌎 Global
Especialidades	Viajeros italohablantes que visitan Nueva York
Funciones de la conexión	Availability Sync · Pricing Sync · Bookings Sync
GMV reservado a través de Ventrata (últimos 12 meses)	US$10k+
Desarrollado por	Il Mio Viaggio a New York (mediante la API OCTO de Ventrata)

Esta conexión de revendedor le permite vender sus productos a través de Il Mio Viaggio a New York sin gestionar a mano la disponibilidad, los precios y las reservas. Las funciones de esta conexión incluyen:

Availability Sync: Il Mio Viaggio a New York consulta su disponibilidad en tiempo real en Ventrata.
Pricing Sync: Il Mio Viaggio a New York obtiene sus precios a partir de los precios de su revendedor en Ventrata.
Bookings Sync: las reservas, modificaciones y cancelaciones de Il Mio Viaggio a New York se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata.

Crear la conexión con Il Mio Viaggio a New York

🔐 Permisos de rol necesarios: See Connections, Modify Connections, See Connection Key

Antes de empezar:

Debe tener un acuerdo comercial con Il Mio Viaggio a New York para que el partner pueda vender sus productos. Para informarse sobre cómo asociarse con ellos, póngase en contacto a través de ilmioviaggioanewyork.com.
Debe tener Il Mio Viaggio a New York creado como revendedor en Ventrata, con sus precios (de venta al público y mayoristas o de comisión) correctamente definidos. Tenga en cuenta que esta conexión API requiere que el revendedor tenga configurado el método de liquidación «Facturar a mi cuenta (Bill to my account)».

En el Ventrata Dashboard, vaya a Conexiones → Conexiones (Connections → Connections), haga clic en + Nueva conexión (+ New Connection) y seleccione Il Mio Viaggio a New York en la lista de partners.
Seleccione el revendedor Il Mio Viaggio a New York en la lista de sus revendedores (debe crearse antes de crear la conexión). La conexión heredará la configuración del revendedor, como los precios, los destinos permitidos, los productos, etc.
(Opcional) También puede asignar a la conexión el Nombre (Name) que prefiera, lo cual puede resultar útil si tiene previsto tener varias conexiones con Il Mio Viaggio a New York y desea distinguirlas más fácilmente en el futuro.
Pulse el botón Crear Conexión Octo (Create Octo Connection).

📗 CONSEJO

Si lo necesita, también puede permitir o excluir productos o destinos a nivel de conexión, además de lo que haya configurado en el revendedor.

Mapear productos con Il Mio Viaggio a New York

Comparta de forma segura la clave API de OCTO que aparece en la conexión que ha creado con su contacto en Il Mio Viaggio a New York y pídale que mapee sus productos mediante la API OCTO de Ventrata, con los precios (octo/pricing) activados. Normalmente, el equipo de Il Mio Viaggio a New York tarda solo unos pocos días hábiles en completarlo.

Su configuración en Ventrata está completa. No necesita realizar ningún otro paso.

📗 CONSEJO

Il Mio Viaggio a New York puede acceder a todos los productos habilitados en la conexión, pero usted también puede facilitarle los ID de producto y de opción que aparecen en la página de la conexión cuando se ponga en contacto con su equipo, para indicar qué debe mapear.

Gestionar la conexión con Il Mio Viaggio a New York

Permitir o excluir productos: limite a qué destinos, productos y opciones puede acceder Il Mio Viaggio a New York. Consulte cómo permitir o excluir productos.
Cambie el nombre de la conexión para distinguir varias conexiones con Il Mio Viaggio a New York.

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Il Mio Viaggio a New York: qué llamadas a la API OCTO de Ventrata realiza Il Mio Viaggio a New York, cuándo las realiza y qué significa eso para usted. Cada llamada enlaza con la documentación de la API de Ventrata.

En resumen: Il Mio Viaggio a New York obtiene de Ventrata todo lo que necesita. Lee sus productos, consulta su disponibilidad y sus precios, y envía reservas y cancelaciones. Ventrata no envía cambios a Il Mio Viaggio a New York, por lo que todo lo que cambie en Ventrata llega a Il Mio Viaggio a New York la próxima vez que realice una consulta.

Los tiempos son los habituales en Il Mio Viaggio a New York y están redondeados; pueden cambiar si Il Mio Viaggio a New York modifica su forma de sincronizar.

Product Mapping	❌	No puede mapear productos desde Ventrata. Il Mio Viaggio a New York los mapea por su parte, a través de su gestor de cuenta o del portal de Il Mio Viaggio a New York. Funciona así: Get Products (`GET /products`): cuando Il Mio Viaggio a New York configura su conexión, y cada vez que actualiza sus anuncios, lee todos los productos habilitados en la conexión, con sus opciones y unidades (tipos de entrada, como Adulto o Niño). Get Product (`GET /products/{productId}`): Il Mio Viaggio a New York vuelve a leer un producto concreto para recoger los cambios en sus opciones, unidades, plazos límite de reserva y ajustes. Mapeo por parte de Il Mio Viaggio a New York: Il Mio Viaggio a New York vincula cada opción y unidad de Ventrata con su propio anuncio y sus tipos de entrada. Su gestor de cuenta en Il Mio Viaggio a New York lo hace por usted, o lo hace usted mismo en el portal de Il Mio Viaggio a New York, si Il Mio Viaggio a New York ofrece uno. Usted solo comparte la clave API de la conexión. Lo habitual con Il Mio Viaggio a New York: Vuelve a leer cada producto aproximadamente cada 8 horas. Qué significa esto para usted: Il Mio Viaggio a New York solo puede vender lo que ha mapeado. Cuando añade un producto, una opción o una unidad en Ventrata, es posible que Il Mio Viaggio a New York lo vea en su siguiente actualización, pero no lo venderá hasta que esté mapeado. Por eso, avise a su gestor de cuenta en Il Mio Viaggio a New York cada vez que añada uno.
Content Sync	✅ / ❌	Il Mio Viaggio a New York puede leer el contenido de sus productos, como descripciones e imágenes, desde Ventrata. Funciona así: Capability `octo/content`: cuando Il Mio Viaggio a New York la añade a la cabecera `Octo-Capabilities`, Get Products (`GET /products`) y Get Product (`GET /products/{productId}`) también devuelven el contenido de sus productos, como descripciones, puntos destacados, servicios incluidos e imágenes. Los cambios de contenido en Ventrata llegan a Il Mio Viaggio a New York en su siguiente actualización de productos. Lo habitual con Il Mio Viaggio a New York: Il Mio Viaggio a New York solicita `octo/content`.
Availability Sync	✅	Il Mio Viaggio a New York consulta su disponibilidad en tiempo real en Ventrata. Ventrata no envía los cambios de disponibilidad a Il Mio Viaggio a New York. Funciona así: Availability Check (`POST /availability`): Il Mio Viaggio a New York envía un producto, una opción y una fecha o un intervalo de fechas. Ventrata responde con cada día o franja horaria reservable, su estado (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, `CLOSED` o `FREESALE`), las plazas restantes, el plazo límite de reserva y un `availabilityId`, que Il Mio Viaggio a New York necesita para reservar esa franja. Availability Calendar (`POST /availability/calendar`): devuelve un resumen por día en lugar de cada franja horaria, normalmente para mostrar qué fechas están abiertas en un selector de fechas. Comprobación al reservar: cuando un cliente reserva, Ventrata vuelve a comprobar el aforo antes de crear la reserva, de modo que Il Mio Viaggio a New York no puede sobrevender una franja que acaba de agotarse, aunque la disponibilidad que tiene almacenada esté ligeramente desactualizada. Lo habitual con Il Mio Viaggio a New York: Availability Check: Il Mio Viaggio a New York consulta sus productos a lo largo del día, normalmente a partir de 16 días vista y cubriendo 31 días por solicitud; consulta hasta unos 9 meses vista y vuelve a consultar el mismo producto y las mismas fechas aproximadamente cada hora. Availability Calendar: Il Mio Viaggio a New York consulta sus productos las 24 horas del día, normalmente a partir de hoy y cubriendo aproximadamente un año por solicitud; consulta hasta aproximadamente un año vista y vuelve a consultar el mismo producto y las mismas fechas cada pocos minutos. Las consultas se reparten de forma uniforme a lo largo del día, lo que apunta a una sincronización programada en segundo plano más que a búsquedas de clientes en tiempo real. Qué significa esto para usted: cuando cierra una fecha, cambia el aforo o agota plazas en Ventrata, Il Mio Viaggio a New York lo muestra después de su siguiente consulta. Para las fechas que consulta con regularidad, eso ocurre en pocos minutos. Las fechas más lejanas suelen consultarse con menos frecuencia.
Pricing Sync	✅	Sus precios se devuelven con cada consulta de disponibilidad, una vez que Il Mio Viaggio a New York los solicita con la capability octo/pricing. Funciona así: Capability `octo/pricing`: Il Mio Viaggio a New York solicita los precios añadiendo `octo/pricing` a la cabecera `Octo-Capabilities` de sus solicitudes. Sin ella, Ventrata envía la disponibilidad sin ningún precio. Availability Check (`POST /availability`): con los precios activados, cada día o franja horaria se devuelve con su precio por unidad (tipo de entrada): el precio de venta al público que paga el cliente y el precio neto que usted factura a Il Mio Viaggio a New York, ambos a partir de los precios del revendedor en Ventrata (de venta al público y mayoristas o de comisión). Precios para grupos: cuando Il Mio Viaggio a New York también envía cuántas personas de cada tipo de unidad reservan, Ventrata calcula el precio de ese grupo exacto. Esto es importante para las tarifas por tamaño de la reserva (Booking Size) y otros precios para grupos. Booking Reservation (`POST /bookings`) y Booking Confirmation (`POST /bookings/{uuid}/confirm`): la reserva se devuelve con su precio final de venta al público y neto, de modo que la reserva en Ventrata siempre registra el precio al que se vendió. Lo habitual con Il Mio Viaggio a New York: Il Mio Viaggio a New York solicita `octo/pricing` en todas sus consultas de disponibilidad, por lo que vende con sus precios de Ventrata. Il Mio Viaggio a New York envía el número de personas por tipo de unidad, de modo que los precios de grupo se calculan según la reserva real. ‼️ IMPORTANTE – Pida que se activen los precios. Cuando pida a Il Mio Viaggio a New York que mapee sus productos, pídale también que active los precios (`octo/pricing`), o actívelos usted mismo si mapea en el portal de Il Mio Viaggio a New York. De lo contrario, podrían estar desactivados y Il Mio Viaggio a New York no recibiría sus precios de Ventrata. 📗 CONSEJO – Si los precios en Il Mio Viaggio a New York parecen incorrectos, revise primero los precios del revendedor Il Mio Viaggio a New York en Ventrata: es lo que lee Il Mio Viaggio a New York.
Promotions Sync	❌	Sus promociones de Ventrata no se aplican en Il Mio Viaggio a New York. Los precios en Il Mio Viaggio a New York no incluyen las promociones que cree en Ventrata. Configure las promociones directamente con Il Mio Viaggio a New York.
Bookings Sync	✅	Las reservas y cancelaciones realizadas en Il Mio Viaggio a New York se crean al instante en Ventrata, y los clientes reciben entradas de Ventrata. Funciona así: Retención: Booking Reservation (`POST /bookings`): cuando un cliente inicia el proceso de pago en Il Mio Viaggio a New York, Il Mio Viaggio a New York envía el producto, la opción, la franja elegida (`availabilityId`) y un elemento de unidad por persona. Ventrata vuelve a comprobar el aforo y crea una reserva `ON_HOLD`, que retiene las plazas mientras el cliente paga. Si ya no queda sitio, Ventrata rechaza la retención. Confirmación: Booking Confirmation (`POST /bookings/{uuid}/confirm`): una vez realizado el pago, Il Mio Viaggio a New York confirma la retención, con su propia referencia de reserva y los datos de contacto del cliente. La reserva pasa a `CONFIRMED` en Ventrata, y Ventrata devuelve su referencia de reserva y las entradas (una por persona) o un voucher (uno por reserva), según cómo esté configurado su producto, cada uno con un código QR y un enlace al PDF. Il Mio Viaggio a New York se los entrega al cliente, que los muestra en su entrada como cualquier entrada de Ventrata. Caducidad: si el cliente no termina de pagar, Il Mio Viaggio a New York nunca confirma, y la retención caduca por sí sola y libera las plazas. Cancelación: Booking Cancellation (`POST /bookings/{uuid}/cancel`): cuando un cliente cancela en Il Mio Viaggio a New York, Il Mio Viaggio a New York cancela la reserva en Ventrata. Ventrata solo lo acepta si la reserva todavía puede cancelarse y no ha pasado el plazo límite de cancelación de la opción. De lo contrario, rechaza la solicitud y Il Mio Viaggio a New York tiene que ponerse en contacto con usted. Modificación: Il Mio Viaggio a New York no utiliza Booking Update (`PATCH /bookings/{uuid}`), por lo que lo más probable es que un cambio llegue a Ventrata como una cancelación más una nueva reserva. Lo habitual con Il Mio Viaggio a New York: Il Mio Viaggio a New York no establece un tiempo de retención, por lo que se aplica el tiempo de retención predeterminado. Una reserva típica de Il Mio Viaggio a New York es para unas 5 personas. Il Mio Viaggio a New York también comprueba las reservas que ha realizado, con Get Booking (`GET /bookings/{uuid}`) aproximadamente cada 12 horas, por ejemplo para conciliar sus registros. ‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Il Mio Viaggio a New York a Ventrata. Si cancela, modifica o vuelve a reservar en Ventrata una reserva procedente de Il Mio Viaggio a New York, por ejemplo en el Dashboard, Il Mio Viaggio a New York no recibe ningún aviso. Póngase en contacto con Il Mio Viaggio a New York para que la reserva también se cancele o modifique por su parte, o pida al cliente que cancele a través de Il Mio Viaggio a New York.
Pickups/Dropoff Sync	❌	Il Mio Viaggio a New York no envía datos de recogida ni de regreso con sus reservas. Si sus productos incluyen recogidas, consulte con Il Mio Viaggio a New York cómo recopila los datos de recogida, o acuérdelos con el cliente.
Custom Questions Sync	❌	Il Mio Viaggio a New York no envía las respuestas a sus preguntas de reserva. Si depende de las preguntas de reserva, por ejemplo nombres o necesidades alimentarias, consulte con Il Mio Viaggio a New York cómo recopila esa información.
Extras Sync	❌	Los extras y complementos no se pueden reservar a través de Il Mio Viaggio a New York. En Il Mio Viaggio a New York, los clientes solo pueden reservar sus productos y opciones principales. Venda los extras por separado, por ejemplo a la llegada.
Redemption Sync	❌	Los canjes no se notifican a Il Mio Viaggio a New York. Ventrata no avisa a Il Mio Viaggio a New York cuando se escanea o se canjea una entrada. Il Mio Viaggio a New York solo ve un canje si vuelve a leer la reserva desde Ventrata.
Pass Walkup Scanning Sync	❌	Los titulares de pases de Il Mio Viaggio a New York no pueden acceder escaneando su pase en su entrada sin una reserva. Los clientes de Il Mio Viaggio a New York necesitan una reserva hecha a través de Il Mio Viaggio a New York antes de su visita.
Gift Card Sync	❌	Las tarjetas regalo de Ventrata no se pueden vender ni canjear a través de Il Mio Viaggio a New York. Las tarjetas regalo compradas en Ventrata no se pueden usar en Il Mio Viaggio a New York, y Il Mio Viaggio a New York no puede vender tarjetas regalo de Ventrata.

✅ compatible · ✅ / ❌ limitado · ❌ no compatible

Conviene saber: límites y detalles de la conexión con Il Mio Viaggio a New York

Retrasos: la disponibilidad y los precios llegan a Il Mio Viaggio a New York solo cuando realiza una consulta, por lo que siempre hay un breve retraso después de que cambie algo en Ventrata.
Plazo límite de cancelación: Il Mio Viaggio a New York solo puede cancelar mediante la API antes del plazo límite de cancelación de su opción. Las cancelaciones posteriores deben acordarse con usted.
Qué puede ver Il Mio Viaggio a New York: solo los destinos, productos y opciones permitidos en el revendedor y en la conexión, y habilitados para la venta en la fuente API directa (Direct API). Consulte cómo permitir o excluir productos.
Entradas: Il Mio Viaggio a New York emite las entradas o el voucher de Ventrata que recibe con la confirmación, por lo que el escaneo y el canje habituales funcionan con normalidad.
Reservas de prueba: Il Mio Viaggio a New York puede enviar reservas de prueba mientras configura la conexión. Las reservas de prueba no consumen su disponibilidad y no se facturan.

Preguntas frecuentes

No se muestra ningún producto en la página de la conexión.

Compruebe qué destinos, productos y opciones están permitidos en su revendedor y en su conexión. Después, confirme que sus productos y opciones están habilitados para la venta en la fuente API directa (Direct API). Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Mis productos de Ventrata usan tarifas por tamaño de la reserva (Booking Size) y los precios no funcionan correctamente en Il Mio Viaggio a New York.

Después de cada cambio de tarifa, actualice el mapeo de productos para que los tramos del partner se sincronicen con Ventrata. Asegúrese de que la tarifa esté habilitada para la venta en la API directa (Direct API).

📚 Más sobre las conexiones de Ventrata

Información del partner

Ilmioviaggio Inc.

235 W 56 St, Suite 21D, New York, NY 10019

United States

ilmioviaggioanewyork.com

ID de partner de Ventrata: 73dcb6e4-7e58-445f-9ec1-1f811049af94

Il Mio Viaggio a New York: conexión de revendedor