Onebox é um sistema de distribuição de bilhetes sediado em Barcelona para eventos ao vivo e lazer, utilizado por promotores, recintos, festivais, teatros, museus, estádios e parques temáticos para gerir vendas, preços dinâmicos, mapas de lugares, lotação e controlo de acessos. Entre os clientes contam-se o Atlético de Madrid e o Teatro Apolo, a empresa indica mais de 65 milhões de bilhetes vendidos, e a sua rede de distribuição chega a operadores de bilhética, agências de viagens, hotéis e centros comerciais em toda a Espanha.
Ligar Onebox à Ventrata permite-lhe revender produtos de operadores que utilizam Onebox como sistema de reservas. A Ventrata lê a disponibilidade e os preços em tempo real a partir de Onebox, e cada reserva que recebe é criada diretamente na conta do operador em Onebox.
Para saber mais sobre Onebox, visite oneboxtds.com.
📒 NOTA
Esta conexão estará disponível brevemente. Está em desenvolvimento. Se a quiser utilizar, contacte o nosso Suporte técnico ou o seu Customer Success Manager da Ventrata.
‼️ IMPORTANTE
O mapeamento indica à Ventrata para que produto deve consultar a disponibilidade em Onebox. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto significa que o produto não está corretamente mapeado.
📒 NOTA
Recrie os produtos de Onebox na Ventrata, respeitando exatamente a configuração de Onebox.
📗 DICA
Ao criar o operador, apenas os campos assinalados com asterisco (*) são obrigatórios.
Website principal | |
Etiquetas | Booking / Ticketing System |
Funcionalidades da conexão | Availability Sync · Pricing Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da Onebox Distribution API) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Onebox como sistema de reservas principal, com cada reserva criada diretamente em Onebox. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Onebox.
Pricing Sync – os preços vêm de Onebox, ou são definidos por si na Ventrata.
Bookings Sync – as reservas são enviadas da Ventrata para Onebox, e Onebox emite os bilhetes ou vouchers.
A API externa de Onebox utilizada nesta conexão é uma API personalizada que não segue o padrão OCTO API, o que pode limitar certas funcionalidades e capacidades.
Criar a conexão com Onebox
🔐 Permissões de função necessárias: See Operators, Modify Operators, See Products, Modify Products
Antes de começar:
Tem de ter um acordo comercial com o operador relativo às respetivas tarifas e condições.
Tem de ter o Channel ID e o Client Secret do operador. Consulte os passos abaixo.
Recrie os produtos de Onebox na Ventrata, respeitando exatamente a configuração de Onebox.
Tem de recriar os produtos do operador na Ventrata. Veja como criar produtos. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos na Ventrata.
Passo 1: Assinar um acordo comercial e pedir as credenciais
Assine um acordo comercial com o operador cujos produtos pretende revender através de Onebox.
Contacte Onebox e peça as credenciais abaixo.
Channel ID
Client Secret
Passo 2: configurar o operador na Ventrata
Contacte Onebox e peça o Channel ID e o Client Secret.
No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.
Na secção Backend Partner, selecione Onebox e introduza o Channel ID e o Client Secret.
Press Update Operator.
Passo 3: conecte cada produto
Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.
Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Onebox e Backend Pricing para utilizar os preços de Onebox.
Press Update Product.
📒 NOTA
Onebox envia apenas preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço líquido como o seu preço de custo e calcula o preço de venda ao público com base na percentagem de custo definida no operador no Ventrata Dashboard.
Marque Backend Connected e mantenha Backend Availability marcado.
Marque Backend Pricing se quiser herdar os preços do parceiro de backend.
Mapear produtos para Onebox
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Onebox cuja disponibilidade deve consultar e que deve reservar. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto indica um produto mal mapeado.
No Ventrata Dashboard, aceda a Products → Products e abra o produto.
Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.
Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de Onebox nas listas pendentes, que a Ventrata carrega a partir de Onebox. Não deixe nenhum campo vazio.
Press Save Changes.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em Onebox.
Gerir a conexão com Onebox
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Onebox.
Substitua a chave no operador se Onebox ou o operador emitirem uma nova.
Desative Backend Availability ou Backend Pricing num produto para utilizar a disponibilidade ou os preços da própria Ventrata. As reservas continuam a ser enviadas para Onebox.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Onebox. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Onebox, através da Onebox Distribution API. Para cada funcionalidade, explica que chamadas a Ventrata faz, quando as faz e o que isso significa para si.
Em resumo: a Ventrata pede a Onebox a disponibilidade e os preços sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Onebox. Onebox não envia alterações de volta para a Ventrata.
Os prazos são os habituais para Onebox, estão arredondados e podem mudar.
Product Mapping | ✅ |
No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para o produto do operador em Onebox. Funciona da seguinte forma:
O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Onebox. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Onebox. A Ventrata não importa o conteúdo dos produtos de Onebox. É o próprio utilizador que cria e descreve os produtos na Ventrata. |
Availability Sync | ✅ |
Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em Onebox. Funciona da seguinte forma:
Normalmente, com Onebox:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Onebox, pelo que não pode vender em excesso um horário que o operador já vendeu noutro lado. |
Pricing Sync | ✅ |
Com Backend Pricing ativado, a Ventrata obtém os preços a partir de Onebox. Funciona da seguinte forma:
Onebox envia apenas preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço líquido como o seu preço de custo e calcula o preço de venda ao público com base na percentagem de custo definida no operador no Ventrata Dashboard. |
Promotions Sync | ❌ |
As promoções não são enviadas para Onebox. As promoções não são enviadas para Onebox. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata. |
Bookings Sync | ✅ |
As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em Onebox. Funciona da seguinte forma:
Envia reservas da Ventrata para Onebox. As atualizações e os cancelamentos de reservas da Ventrata para Onebox não são suportados.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Onebox. Se o operador alterar ou cancelar uma reserva em Onebox, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça. |
Pickups/Dropoff Sync | ❌ |
Os dados de recolha e largada não são transmitidos a Onebox. Os dados de recolha e largada não são transmitidos a Onebox. Partilhe-os com o operador por outra via se um produto precisar deles. |
Custom Questions Sync | ❌ |
As respostas às suas perguntas de reserva não são transmitidas a Onebox. As respostas às suas perguntas de reserva não são transmitidas a Onebox. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Onebox. Os extras e complementos não são reservados em Onebox. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Onebox não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Os resgates e outras alterações de estado em Onebox não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. |
Pass Walkup Scanning Sync | ❌ |
A digitalização de passes sem reserva (walk-up) não está disponível com Onebox. A digitalização de passes sem reserva (walk-up) não está disponível com Onebox. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Onebox. Os cartões-oferta Ventrata não são transmitidos a Onebox. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Onebox
Bom saber: limites e detalhes da conexão com Onebox
Disponibilidade em tempo real: a disponibilidade vem de Onebox à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Onebox não chegam à Ventrata.
API personalizada: a API de Onebox não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.
Onebox é um sistema centralizado de distribuição de bilhetes (TDS) que dá acesso ao inventário, aos preços e aos mapas de lugares marcados de eventos ao vivo de vários recintos através de um único gateway de API.
Perguntas frequentes
Recebo um erro quando guardo a configuração do backend do operador.
Recebo um erro quando guardo a configuração do backend do operador.
Muito provavelmente, o Channel ID e o Client Secret ou o endpoint estão incorretos. Verifique-os com o seu operador. Se o problema persistir, contacte o nosso Suporte técnico.
Não existe a caixa Backend Connected nas definições do produto.
Não existe a caixa Backend Connected nas definições do produto.
O mais provável é que o operador definido no produto não tenha um backend configurado. Verifique as definições de Backend Partner do operador e tente novamente. Se o problema persistir, contacte o nosso Suporte técnico.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
As listas pendentes mostram o que o operador disponibilizou para si em Onebox. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.
As reservas de um produto ligado ao backend falham.
As reservas de um produto ligado ao backend falham.
Verifique primeiro o mapeamento do produto: todas as opções e unidades têm de estar mapeadas. Depois, verifique se o horário ainda está disponível em Onebox. Se o problema persistir, contacte o nosso Suporte técnico.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
ONEBOX IBERICA, S.L.
Via Augusta 21 - 23
08006 Barcelona, Spain
ID de parceiro Ventrata: 4b72f238-0436-4b6a-ae39-5849d1f7740c