Outbox é uma plataforma de bilhética na nuvem sediada em Montreal para eventos ao vivo e recintos, vendida em white label com bilhetes digitais e carteira, entrada geral e lugares marcados, mapas de lugares 3D, controlo de inventário e de distribuição e uma API completa, em várias línguas e moedas. A empresa indica mais de 500 milhões de bilhetes vendidos para clientes como o Bell Centre, o Cirque du Soleil, o Osheaga, The O2 e recintos no Canadá, nos Estados Unidos, no Reino Unido e no México.
Ligar Outbox à Ventrata permite-lhe revender produtos de operadores que utilizam Outbox como sistema de reservas. A Ventrata lê a disponibilidade e os preços em tempo real a partir de Outbox, e cada reserva que recebe é criada diretamente na conta do operador em Outbox.
Para saber mais sobre Outbox, visite outbox.com.
‼️ IMPORTANTE
A API externa de Outbox utilizada nesta conexão é uma API XML-RPC personalizada que não segue a norma OCTO API, o que pode limitar algumas funcionalidades e capacidades.
‼️ IMPORTANTE
Como Outbox vende lugares com hora de entrada marcada, utilize sempre Backend Availability. Sem esta opção, podem ser efetuadas reservas para horários que não existem ou estão esgotados em Outbox, e essas reservas falharão.
📗 DICA
Efetue uma reserva de teste após o mapeamento e peça ao operador que confirme que esta chegou a Outbox com o horário e os tipos de bilhete corretos.
Website principal | |
Etiquetas | Booking / Ticketing System |
Funcionalidades da conexão | Availability Sync · Pricing Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da Outbox Partner Sell API) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Outbox como sistema de reservas principal, com cada reserva criada diretamente em Outbox. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Outbox.
Pricing Sync – os preços vêm de Outbox, ou são definidos por si na Ventrata.
Bookings Sync – as reservas são enviadas da Ventrata para Outbox, e Outbox emite os bilhetes ou vouchers.
A API externa de Outbox 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 Outbox
🔐 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 a API Key e o API URL do operador. Consulte os passos abaixo.
Certifique-se de que recebe credenciais de produção: o ambiente de testes (staging) e o de produção utilizam URL e chaves diferentes, e o inventário de produção é configurado separadamente do de testes.
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: configurar o operador na Ventrata
O seu operador pede um novo canal API para si ao respetivo gestor de conta em Outbox, que também configura as onsales e o inventário que pode vender. Outbox emite as credenciais.
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 Outbox e introduza a API Key e o API URL.
Introduza a API Key: esta identifica-o como canal de venda (revendedor) no sistema Outbox do operador e controla que onsales (produtos) e que moeda estão disponíveis para si. Cada revendedor precisa da sua própria chave; as chaves não podem ser partilhadas entre empresas.
Introduza o API URL: o endereço da API de Outbox do operador, normalmente no domínio de bilhética do operador e terminado em /extapi/ (por exemplo, https://tickets.onetimessquare.com/extapi/). Tem de começar por https://.
Clique em Update Operator.
Passo 2: 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 Outbox e Backend Pricing para utilizar os preços de Outbox.
Clique em Update Product.
📒 NOTA
Outbox envia apenas preços de venda ao público. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público e calcula o seu preço líquido (de custo) com a percentagem de custo definida no operador no Ventrata Dashboard.
Assinale Backend Connected e, em seguida, Backend Availability para obter os horários e a disponibilidade e Backend Pricing para obter os preços.
Mapear produtos para Outbox
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Outbox 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 Outbox nas listas pendentes, que a Ventrata carrega a partir de Outbox. Não deixe nenhum campo vazio.
Clique em 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 Outbox.
Gerir a conexão com Outbox
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Outbox.
Substitua a chave no operador se Outbox 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 Outbox.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Outbox. Aqui, o sentido é o oposto de uma conexão de revendedor: a Ventrata chama Outbox, utilizando a Partner Sell API de Outbox. Para cada funcionalidade, explica que chamadas a Ventrata efetua, quando e o que isso significa para si.
Em resumo: a Ventrata pede a Outbox 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 Outbox. Outbox não envia alterações de volta para a Ventrata.
Os prazos são os habituais para Outbox, 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 Outbox. 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 Outbox. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Outbox. A Ventrata não importa o conteúdo dos produtos de Outbox. É 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 Outbox. Funciona da seguinte forma:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Outbox, 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 Outbox. Funciona da seguinte forma:
Outbox envia apenas preços de venda ao público. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público e calcula o seu preço líquido (de custo) com a percentagem de custo definida no operador no Ventrata Dashboard. |
Promotions Sync | ❌ |
As promoções não são enviadas para Outbox. As promoções não são enviadas para Outbox. 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 Outbox. Funciona da seguinte forma:
Reserva: os lugares ficam bloqueados em Outbox durante o período de retenção que Outbox devolve quando um produto é adicionado ao carrinho; cada encomenda de Outbox abrange um único horário. Confirmação: após o pagamento, com os contactos do cliente; nome próprio, apelido, email e país são obrigatórios, o telefone e o código postal são enviados quando disponíveis, e a língua do cliente é definida como francês ou inglês a partir da sua configuração regional. O número de encomenda de Outbox é registado como Supplier Reference. Bilhetes: é emitido um código de barras por lugar, como código QR em cada bilhete Ventrata, além de um PDF com todos os bilhetes da encomenda; os valores QR correspondem ao PDF de Outbox. Atualização: Outbox não permite alterar uma encomenda existente através da API, pelo que atualizar uma reserva confirmada apenas reemite os respetivos bilhetes; para alterar a data, o horário ou o número de bilhetes, cancele e volte a reservar. Cancelamento: cancelar uma reserva confirmada cancela a encomenda de Outbox; cancelar uma reserva não confirmada (em retenção) liberta os lugares bloqueados.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Outbox. Se o operador alterar ou cancelar uma reserva em Outbox, 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 Outbox. Os dados de recolha e largada não são transmitidos a Outbox. 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 Outbox. As respostas às suas perguntas de reserva não são transmitidas a Outbox. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Outbox. Os extras e complementos não são reservados em Outbox. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Outbox 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 Outbox não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Não suportado. O estado da reserva em Outbox (por exemplo, um bilhete lido) não é comunicado de volta à Ventrata. |
Pass Walkup Scanning Sync | ❌ |
A digitalização de passes sem reserva (walk-up) não está disponível com Outbox. A digitalização de passes sem reserva (walk-up) não está disponível com Outbox. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Outbox. Os cartões-oferta Ventrata não são transmitidos a Outbox. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Outbox
Bom saber: limites e detalhes da conexão com Outbox
Disponibilidade em tempo real: a disponibilidade vem de Outbox à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Outbox não chegam à Ventrata.
API personalizada: a API de Outbox não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.
Bilhetes: os códigos QR e os bilhetes em PDF de Outbox são emitidos para os seus clientes.
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.
A API Key e o API URL ou endpoint estão provavelmente 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 Outbox. 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 Outbox. Se o problema persistir, contacte o nosso Suporte técnico.
Erro ao atualizar o operador para guardar a configuração do backend.
Erro ao atualizar o operador para guardar a configuração do backend.
A API Key ou o API URL estão provavelmente incorretos, ou foram utilizadas credenciais de teste com um URL de produção (ou vice-versa). Confirme com o seu operador. Se o problema persistir, contacte o suporte.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente, ou a lista pendente está vazia.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente, ou a lista pendente está vazia.
A lista pendente é obtida de Outbox com base nas onsales atribuídas à sua API Key. Peça ao seu operador que confirme com Outbox que o inventário está configurado para o seu canal API no ambiente que está a utilizar (testes e produção são configurados separadamente). Se o problema persistir, contacte o suporte.
Os produtos, opções ou unidades aparecem como "Undefined" nas listas pendentes de mapeamento.
Os produtos, opções ou unidades aparecem como "Undefined" nas listas pendentes de mapeamento.
Os nomes provêm da configuração das onsales do operador em Outbox. Peça ao seu operador que adicione títulos e descrições dos tipos de preço em Outbox.
A confirmação da reserva falha com "Country code is required".
A confirmação da reserva falha com "Country code is required".
Outbox exige um país em todas as encomendas. Certifique-se de que o checkout, o formulário de reserva ou a conexão de revendedor que vende este produto recolhe o país do cliente e tente novamente.
Os preços diferem do que o operador espera.
Os preços diferem do que o operador espera.
Outbox devolve preços com impostos incluídos, que incluem as taxas de serviço do seu canal. Verifique com o seu operador as tabelas de preços e as taxas de serviço do seu canal API.
Não são apresentados horários para uma data.
Não são apresentados horários para uma data.
O operador não tem nenhum evento nem lugares disponibilizados para essa data em Outbox. Confirme com o seu operador.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Outbox Technology Inc.
3575 Boulevard Saint-Laurent, Suite 705
Montreal, QC H2X 2T7, Canada
ID de parceiro Ventrata: 01a06240-f33b-7362-b04f-35ed782cee0e