UiTPAS e tarifa social na sua bilheteira online e na caixa

Com o UiTPAS, uma pessoa com baixos rendimentos pode vir à sua atividade a um preço muito reduzido, e o município cobre uma parte. Este artigo explica o que é o UiTPAS, como a sua organização adere, como preparar a ligação na Passavo, e o que acontece exatamente quando um visitante escreve o número do seu passe.

O que é o UiTPAS

O UiTPAS é um cartão de pontos e vantagens para atividades de lazer nas cidades e municípios da Flandres (Bélgica). É gerido pela publiq vzw. Um habitante de um município UiTPAS pode obter o cartão gratuitamente ou por um preço baixo, e usa-o no centro cultural, no clube desportivo, na biblioteca ou no museu.

O cartão faz duas coisas.

1. Acumular pontos. Em cada visita, o titular acumula pontos, que pode trocar por uma vantagem: uma bebida, um desconto, um bilhete gratuito.
2. A tarifa social. Quem, no seu município, tem direito a uma comparticipação reforçada recebe discretamente uma tarifa muito reduzida nas atividades UiTPAS da sua própria região UiTPAS.

É desta segunda que trata este artigo, porque envolve dinheiro que não vem do visitante.

Como é paga a tarifa social

O princípio do UiTPAS é que o visitante com tarifa social paga 20 por cento do preço do bilhete. Os restantes 80 por cento são repartidos: 40 por cento para si, enquanto organizador, e 40 por cento para a administração local. A sua organização suporta, portanto, uma parte do desconto, e a parte do município é-lhe reembolsada a pedido.

Atenção: este é o princípio geral do UiTPAS. As regiões e os municípios podem fazer outros acordos sobre as percentagens, o reembolso e as atividades que participam. Por isso, verifique sempre o que se aplica à sua região antes de configurar o que quer que seja.

Quem tem direito à tarifa social é decidido pelo município, e não por si. Na bilheteira, nem deve perguntar: o próprio passe di-lo, e foi feito assim de propósito, para que ninguém tenha de explicar ao balcão que tem pouco dinheiro.

Como a sua organização adere

A Passavo só pode fazer alguma coisa depois de estar registado na publiq como organizador UiTPAS. Isso trata-se fora deste sistema.

1. Verifique se o seu município é um município UiTPAS. Encontra as regiões em uitpas.be. Se o seu município não estiver incluído, ainda não pode oferecer o UiTPAS; a iniciativa cabe então à administração local, que pode aderir a uma região UiTPAS vizinha.
2. Contacte a organização UiTPAS da sua região. É esse o caminho que a própria publiq indica para fornecedores num município que já participa. Normalmente, é o serviço de lazer ou de cultura da sua cidade ou município.
3. Faça os acordos. Que atividades participam, que tarifa se aplica, como e quando é reembolsada a parte do município.
4. Coloque as suas atividades na UiTdatabank. Cada atividade recebe aí um event-id próprio, e precisa desse id por produto. A sua organização também lá está, com um id próprio: é o seu organizer-id.

Atenção: os acordos com a sua região variam de município para município. Algumas regiões trabalham com um formulário de pedido próprio, outras com uma conversa e um acordo. Por isso, comece sempre pelo seu município ou pela publiq, através de publiq.be ou uitpas.be, e não por nós. Não podemos fazer com que seja reconhecido como fornecedor UiTPAS; isso é decidido pela sua região.

Pedir as suas chaves de API à publiq

Se for fornecedor UiTPAS, pede à publiq as chaves com que a Passavo pode falar com o UiTPAS em seu nome. É gratuito e demora um quarto de hora. Não precisa de chaves de teste: pede logo as chaves reais.

1. Inicie sessão na publiq platform. Abra platform.publiq.be e inicie sessão com o seu UiTiD, ou crie uma conta. O link abre diretamente o formulário para uma nova integração UiTPAS.

2. Escolha o tipo "UiTPAS API". Essa integração é gratuita.

3. Preencha o formulário:

   • Nome: o nome da sua organização;
   • Website: o endereço do seu site ou da sua bilheteira online, com https:// antes;
   • Objetivo: por exemplo "Ligar a nossa loja online e as vendas na bilheteira através da Passavo ao UiTPAS, para que a tarifa social seja verificada e registada automaticamente.";
   • Pessoa de contacto da organização: quem, na sua organização, é responsável pela venda de bilhetes ou pelo UiTPAS;
   • Contacto técnico: a Passavo, com o endereço support@passavo.eu. Assim, a publiq pode contactar-nos diretamente com uma pergunta técnica.

   Guarde o formulário. A integração está agora criada.

4. Ignore as chaves de teste e clique em "Activatie aanvragen" (pedir ativação). A publiq mostra primeiro chaves de teste; não precisa delas. No formulário de ativação:

   • indique como parceiro (quem fornece tecnicamente a ligação) a Passavo, com o nome e a morada da empresa por trás da Passavo. Encontra esses dados no nosso aviso legal;
   • enumere todas as organizações da UiTdatabank para as quais devem ser registados bilhetes. Se várias salas ou associações com organização própria na UiTdatabank venderem bilhetes através de si, inclua-as todas.

   Envie o pedido.

5. Aguarde o e-mail da publiq. Dentro de alguns dias úteis, recebe o client-id live e o client secret. Passada uma semana sem notícias? Contacte a publiq e indique que se trata de chaves de API para uma ligação UiTPAS através da Passavo.

6. Preencha as chaves na Passavo, como descrito no Passo 1 abaixo.

Bom saber: a Passavo é um parceiro novo da publiq. Nos primeiros pedidos que indiquem a Passavo como parceiro, a ativação pode por isso demorar um pouco mais do que o habitual. Se não tiver notícias ao fim de uma semana, avise-nos também através de support@passavo.eu: acompanhamos o assunto junto da publiq.

Onde encontra o seu organizer-id

O e-mail da publiq contém o client-id e o secret, mas não o seu organizer-id. Esse obtém-no na UiTdatabank:

1. Inicie sessão em uitdatabank.be com o mesmo UiTiD.
2. Abra a página da sua organização, a mesma que enumerou no pedido de ativação.
3. O organizer-id é o código longo com hífenes na barra de endereço (no formato 1a2b3c4d-…). Copie-o por completo.

Se várias organizações da sua lista venderem bilhetes através da Passavo, cada uma tem a sua própria organização na Passavo e preenche o seu próprio organizer-id. As chaves do e-mail da publiq são então usadas em cada uma delas.

O que precisa antes de começar

• A função Proprietário: só ela pode configurar os passes externos.
• O seu organizer-id UiTPAS da UiTdatabank.
• O client-id live e o client secret do e-mail da publiq, depois do seu pedido de ativação. As chaves de teste não funcionam.
• Produtos do tipo Evento ou Série: só aí pode preencher um ID do evento UiTPAS.
• Para cada produto que participa: o ID do evento UiTPAS.
• Um quarto de hora para pedir as chaves, alguns dias úteis até a publiq as enviar por e-mail, e depois mais um quarto de hora para preencher tudo na Passavo.

Duas coisas diferentes de um desconto normal

1. É a API da publiq que decide sobre o direito, não nós. A Passavo não calcula nenhuma tarifa e não memoriza quem tem direito. Quem tem direito hoje pode não o ter amanhã, e um "sim" memorizado é um município a pagar por alguém sem direito.
2. Um cancelamento também tem de chegar à publiq. Uma venda de bilhete que lá fica registada, enquanto o bilhete foi anulado do nosso lado, conta na liquidação — e isso só se nota um ano depois.

Passo 1 — Preparar a ligação

1. No menu à esquerda, em Definições, clique em Passes externos. Não vê essa opção? Então não tem a função Proprietário; peça a quem criou a organização.
2. Ligue Aceitamos UiTPAS com tarifa social.
3. Preencha o seu Organizer ID UiTPAS. Encontra-o na UiTdatabank, na sua organização (veja Onde encontra o seu organizer-id acima).
4. Preencha o Client ID e o Client secret: as chaves live do e-mail da publiq, não as chaves de teste. Pense nelas como o nome de utilizador e a palavra-passe com que a Passavo pode bater à porta da publiq em seu nome.
5. Clique em Guardar.
6. Depois, clique em Testar a ligação. O teste usa o que foi guardado; se testar antes de guardar, está a testar os dados antigos.

As chaves são guardadas encriptadas. Se mais tarde voltar a guardar com o campo do secret vazio, a chave existente mantém-se. Caso contrário, cada alteração apagaria uma chave que já ninguém consegue voltar a escrever.

O teste pergunta à publiq para que organizadores são válidas as suas chaves, e se pode, para o seu organizer-id, consultar tarifas e registar vendas de bilhetes. Se funcionar, vê o nome do seu organizador tal como a publiq o conhece. Se faltar uma permissão, a mensagem diz qual.

Em vez dos campos, vê a mensagem "A ligação ao UiTPAS ainda não foi disponibilizada nesta plataforma"? Não se trata de uma definição sua: a Passavo tem de ativar a ligação uma vez para esta instalação. Envie uma mensagem ao suporte e tratamos disso por si.

Passo 2 — Preencher o event-id em cada produto

Preencha em cada produto que participa no UiTPAS o ID do evento UiTPAS. Esse id pertence à atividade tal como está registada na publiq. O campo só existe em produtos do tipo Evento ou Série; um bilhete de entrada normal ou um bilhete com horário não pode, portanto, ter tarifa social.

Onde está esse campo:

1. No menu à esquerda, em Vendas, clique em Eventos e abra o produto.
2. Desça até ao bloco O evento. Aí está o campo ID do evento UiTPAS (o campo só aparece se a ligação estiver ativa na plataforma).
3. Cole o id que o evento tem na UiTdatabank (o código longo na barra de endereço quando abre lá o evento, ou o id que a publiq lhe enviou) e clique em Guardar alterações.

A publiq calcula por evento e não por organização. Sem esse id, não é possível calcular nenhuma tarifa: o visitante recebe então Este passe não dá desconto no que está no seu cesto e paga o preço total. Se algo correr mal, é a primeira coisa a verificar.

Passo 3 — Usar um passe, na loja e na bilheteira

Há um único campo para todos os passes: na loja, o campo Número do passe em Tem um UiTPAS ou um passe de museu?; na bilheteira, o campo UiTPAS ou passe de museu, sempre com o botão Aplicar. O visitante ou o seu colaborador na bilheteira escreve o número; pela forma desse número, a Passavo vê sozinha se se trata de um UiTPAS (treze algarismos) ou de outro passe.

O que acontece a seguir:

1. o número do passe é enviado à publiq;
2. a publiq diz se há direito à tarifa social;
3. se houver direito, o preço de um bilhete é reduzido;
4. imediatamente antes do pagamento, a venda do bilhete é registada na publiq; se o pagamento falhar, esse registo é anulado.

Na bilheteira funciona exatamente da mesma maneira: um campo, um número, uma tecla. Consulte A caixa da bilheteira.

Um passe vale para uma pessoa

Se houver uma linha com três bilhetes, ela é dividida: um bilhete com tarifa social e dois ao preço normal. Reduzir a linha toda faria o município comparticipar três vezes por um único cartão.

Se vier uma família com dois passes, acrescente-os um a um. Cada passe reduz um bilhete.

O registo é feito imediatamente antes do pagamento

É o que a publiq exige: só quando a venda do bilhete está registada na publiq fica assente que a tarifa social pode ser concedida. Por isso, a Passavo regista a venda no momento em que o visitante clica em Pagar (ou, na bilheteira, num botão de pagamento), e ainda antes de o dinheiro entrar.

• Se a publiq recusar nesse momento — porque, entretanto, o máximo semanal foi atingido noutra bilheteira, por exemplo —, o desconto é retirado da encomenda e o visitante vê a explicação da publiq. Paga então o preço normal, ou desiste; ninguém paga um montante reduzido que nunca lhe será reembolsado.
• Se o pagamento falhar ou o visitante desistir, a Passavo anula o registo na publiq. Por dinheiro que nunca chega, não deve haver tarifa social na liquidação de um município.

O que o visitante vê

Mensagem	O que se passa	O que faz
Tarifa social aplicada: paga … em vez de …	Há direito; o preço de um bilhete foi reduzido	Fazer o pagamento
Este UiTPAS não tem, de momento, direito à tarifa social	O passe existe, mas o estatuto social não está ativo	Preço normal. Para perguntas, encaminhe para o município
Het UiTPAS-nummer dat je invulde konden we niet terugvinden. Kijk je het nummer even na? (texto da própria publiq, em neerlandês)	A publiq não conhece este número	Peça que verifiquem o número; um algarismo errado acontece facilmente
Outra explicação da publiq, por exemplo Je kansenstatuut is vervallen…, Oeps, jouw UiTPAS is niet meer geldig… ou Je kan maximaal 1 ticket per week kopen aan kansentarief…	A publiq recusa a tarifa social e explica ela própria porquê. Mostramos esse texto tal e qual, como a publiq pede	Preço normal. Para perguntas, encaminhe para o balcão UiTPAS ou para o município
Este passe não dá desconto no que está no seu cesto	Há direito, mas nenhum dos produtos tem um ID do evento UiTPAS (ou a publiq não dá tarifa para esse evento)	Verifique o event-id no produto
Não reconhecemos este número de passe	O número não tem a forma de um passe que aceita	Peça que verifiquem o número
Não foi possível verificar o UiTPAS	Uma falha na publiq	Tente de novo mais tarde, ou faça o pagamento ao preço normal

Esta última distinção existe de propósito: um visitante deve saber se não tem direito ou se o sistema não está a colaborar por momentos. São duas conversas muito diferentes, e a primeira é uma que as pessoas preferem não ter num átrio cheio.

Cancelar e reembolsar

Se reembolsar uma encomenda através do seu fornecedor de pagamentos, a Passavo anula automaticamente a venda do bilhete na publiq assim que o reembolso for confirmado. Não precisa de fazer nada. Atenção: isso acontece para todos os passes dessa encomenda, também num reembolso parcial.

Se cancelar apenas um bilhete, sem reembolso, o registo na publiq mantém-se. O mesmo acontece numa venda em dinheiro na bilheteira que reembolsa a partir da gaveta. Nesses casos, informe o seu contacto UiTPAS, para que não fique na liquidação do seu município.

Se isso não funcionar — a publiq está em baixo, a rede falha —, a encomenda continua cancelada. O registo continua visível para que possa ser enviado de novo. Uma mensagem falhada para a publiq nunca deve impedir o seu próprio cancelamento: o visitante está à sua frente e quer o dinheiro de volta.

Erros frequentes

Definir a própria tarifa social como preço. Não o faça. O montante vem da publiq, por evento. Se o definir, a liquidação com o seu município deixa de bater certo.

Esquecer o event-id num produto novo. O passe é reconhecido, mas o visitante recebe Este passe não dá desconto no que está no seu cesto. É, de longe, a causa mais reportada.

Usar um passe para uma família inteira. Um passe reduz um bilhete. Se vier uma família com vários passes, acrescente-os um a um.

Perguntar quem tem direito à tarifa social. Não o faça. O próprio passe o diz, e a tarifa deve continuar discreta.

Dizer "não tem direito" quando há uma falha. Leia a mensagem. "Não foi possível verificar" significa que a publiq não está acessível por momentos, e não que o visitante não tem direito.

E se …

… o meu município não for um município UiTPAS?

Então ainda não pode oferecer o UiTPAS. Um município pode aderir a uma região UiTPAS vizinha; essa conversa tem-na com o vereador responsável ou com o serviço de lazer. A publiq acompanha os municípios nesse processo.

… o teste da ligação der erro?

Verifique primeiro o organizer-id, o client-id e o secret — um espaço copiado por engano é o clássico. Preencheu as chaves de teste que a publiq mostra logo depois de criar a integração? Essas não funcionam: a Passavo fala com o ambiente real do UiTPAS. Preencha as chaves live do e-mail de ativação. Se o erro persistir, contacte a publiq ou a sua região: é possível que a ativação ainda não esteja concluída.

… um visitante não tiver o passe consigo?

Então não há número e, por isso, não há tarifa social. Não pode procurar o número; a Passavo não guarda uma lista de passes, e é de propósito.

… o preço não mudar apesar de o passe ser reconhecido?

Quase sempre falta o event-id nesse produto, ou é o id de outra atividade. Verifique isso primeiro. Se o produto não for um Evento ou uma Série, não pode ter tarifa social.

… a publiq estiver em baixo num momento de grande movimento?

Faça o pagamento ao preço normal e encaminhe o visitante para o município para o reembolso, ou peça-lhe que volte mais tarde. Nunca defina manualmente um preço mais baixo: essa venda não entra na liquidação da publiq e o seu município não paga nada por ela.

Perguntas frequentes

Tenho de configurar eu a tarifa social? Não. O montante vem da publiq, por evento. Se o definir, a liquidação com o seu município deixa de bater certo.

Também funciona na bilheteira? Sim, exatamente da mesma maneira: um campo, um número, uma tecla.

Onde vejo o que foi registado? Na encomenda, a tarifa aplicada aparece na linha. O que foi enviado à publiq é guardado pela Passavo por utilização, com a referência que a publiq devolveu; o painel não tem uma vista geral separada disso.

A tarifa social custa-me dinheiro? Sim, uma parte. O princípio do UiTPAS é que a sua organização, enquanto organizador, suporta uma parte do desconto e o município comparticipa outra parte. O que foi exatamente acordado para a sua região, fica a saber junto do seu município.

Posso ver quem tem direito, sem que o visitante tenha de fazer nada? Não, e é assim que deve ser. É preciso um número de passe, e o direito é consultado na publiq nesse momento. Nada é memorizado.