> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/parametrage-produit/les-forfaits-prepayes-bons-cadeaux-cheques-cadeaux/carnet-de-bons.md). # Livro de vouchers Venda de múltiplas entradas ou sessões do mesmo produto simultaneamente, a um preço único: 1 código, N utilizações. *** ### Qual é a finalidade de um livro de cupons? Um livreto de vouchers permite vender antecipadamente um número determinado de utilizações de um produto, a um preço fixo. Por exemplo: **10 utilizações por 100 €**. O cliente paga 100 €, recebe **um código único**, e este código é **válido 10 vezes** para o produto em questão. Esta é a resposta para necessidades como: * Passe para 10 aulas em grupo, * livreto com 5 entradas para a piscina / escalada / circuito de aventura nas copas das árvores, * Assinatura de "20 descidas" para uma atividade. * Pacotes de sessões vendidos a um preço preferencial em comparação com uma sessão individual. > **A partir da versão 11.9 (agosto de 2026).** Anteriormente, essa necessidade era atendida pelo uso indevido do **pacote pré-pago**, o que resultava em preços incorretos e uma contagem imprecisa das sessões restantes. O talão de vouchers agora é o mecanismo oficial: veja Talão de Vouchers ou Pacote Pré-pago? *** ### Princípio de funcionamento Um caderno não é um novo tipo de produto: é um **vale-presente com múltiplos usos**. Ele é criado na mesma seção "Vale-Presente" de um produto, com um campo adicional: **Usos Incluídos**. | Usos incluídos | Resultado | | ------------------ | ------------------------------------------------------------- | | `1` (valor padrão) | Vale-presente clássico: 1 código, 1 uso | | `10` | Caderno: 1 código, 10 utilizações, vendido ao preço indicado. | Pontos principais: * **O preço inserido é o preço do passe completo**, não o preço de uma única sessão. "10 entradas por €100" está definido para o preço de **€100** e inclui 10 utilizações. * A compra gera **apenas um código**, independentemente do número de utilizações. * Cada vez que uma reserva é paga com este código, o saldo restante **diminui**. Se a reserva for cancelada, o saldo será **reembolsado**. * O preço do passe **substitui** o preço da sessão no momento da reserva, incluindo quaisquer tarifas com desconto ou sazonais. * A **data de validade** aplica-se a todo o livreto: após o vencimento, quaisquer usos não utilizados serão perdidos. *** ### Crie um livro de cupons 1. **Faça login no Yoplanning.pro.** 2. Menu **Administração** → **Produtos**. 3. Abra o menu de **três pontinhos** no canto superior direito do produto em questão e, em seguida, **edite o produto**. 4. Na seção **“Vale-presente”**, clique em **Adicionar um vale-presente** e insira as seguintes informações: * o **nome** do voucher, tal como será visto pelo cliente (ex.: "Caderneta de 10 ingressos"); * o **preço**: o preço do caderno completo (por exemplo, 100 €); * a **validade** em número de meses (vazio = sem data de expiração); * **Usos incluídos**: o número de vezes que o caderno é usado (por exemplo, 10). Valores aceitos: de 1 a 999. 5. *(Opcional)* Seção **Vários produtos**: insira uma **etiqueta de produto** para que o caderno possa ser usado em todos os produtos com essa etiqueta, e não apenas no produto atual. 6. Na seção **“Venda Online”**, marque a opção **venda online de vouchers** se desejar que o livreto possa ser adquirido a partir do seu módulo de reservas. 7. **Salvar.** Após o cadastro, o voucher aparece na lista de vouchers do produto com a menção **"10 usos por voucher"**. > **O campo "Usos incluídos" não está aparecendo?** Provavelmente você está editando um **plano pré-pago** (produto do tipo crédito). Este campo é reservado para vouchers vinculados a um produto; em um plano pré-pago, ele fica oculto e com o valor fixo de 1. *** ### Venda de um bloco de vales #### Online, através do módulo de reservas. Se a venda online de vouchers estiver habilitada, o livreto será oferecido como qualquer outro vale-presente. O cliente: 1. escolhe o caderno, 2. Pagar o preço do notebook, 3. recebe seu **bilhete com um código único**. O cliente pode comprar **vários notebooks** no mesmo pedido: nesse caso, receberá um código para cada notebook. #### No balcão O atendimento no balcão utiliza o mesmo módulo de reservas, conectado à sua conta. A venda de folhetos é feita exatamente da mesma forma que online. #### Disponível para venda manual mediante encomenda. 1. Abra um pedido existente ou crie um **pedido em branco** (menu **Pedidos** → três pontos → **Criar um pedido em branco**) e insira as informações do cliente. 2. Clique em **“Vender um voucher”**. 3. Selecione a opção correta correspondente ao livreto. O campo de preço exibirá então **"Preço para 10 utilizações"**: este é, de fato, o preço total do livreto. 4. Validar, receber o pagamento e enviar o **bilhete** ao cliente. > Na venda manual, você vende **um caderno por vez**: o campo Quantidade é preenchido com o número de vezes que o caderno pode ser usado. Para vender dois cadernos para o mesmo cliente, repita o processo. *** ### Use um caderno #### Pelo cliente, online 1. O cliente normalmente reserva a sua atividade através do seu módulo de reservas. 2. Na última etapa, antes do pagamento, ele insere o **código do seu livreto** no campo destinado a códigos. 3. Aplica-se a taxa do livreto e deduz-se o número correspondente de utilizações. #### Por você, a partir da programação 1. Faça o pedido utilizando os serviços habituais. 2. Na etapa de pagamento, clique em **“Usar um voucher”** abaixo do botão *Adicionar um pagamento*. 3. Digite o **código** do caderno (ou o nome do cliente que o possui) e confirme. #### O que você precisa saber * **Um código pode abranger vários participantes no mesmo pedido**, até o limite de usos restantes. Exemplo: uma família de 3 pessoas em um livreto de 10 → 3 usos deduzidos com uma única entrada de código. * **Não é possível inserir o mesmo código duas vezes no mesmo pedido.** Se precisar fazer um ajuste, modifique o pedido em vez de inserir o código novamente. * **O caderno é utilizado no produto ao qual está anexado**, ou em qualquer produto que possua a etiqueta especificada na seção "Vários produtos". * **O preço do passe tem prioridade sobre o preço da sessão**, incluindo preços variáveis: o preço cobrado é o preço unitário do passe (preço do passe ÷ número de utilizações). * **Em caso de cancelamento** de uma reserva paga com o livreto, os valores correspondentes serão devolvidos ao livreto. *** ### Acompanhe os usos restantes O menu **Vales** da sua equipe lista todos os vales emitidos, incluindo os livretos. Para cada caderno, você verá: * o **código**, * o **cliente**, * a **data de validade**, * o **status**: *Válido*, *Parcialmente Usado*, *Usado* ou *Expirado*, * o contador **“Restante: 7 / 10”**. Você pode filtrar por cliente, produto, período ou status e pesquisar diretamente por um código. A exportação de dados recupera as colunas **quantidade inicial**, **quantidade restante** e **valor residual**, úteis para fins contábeis relacionados a vendas pré-pagas. > O filtro de status **“Usado”** baseia-se no fato de que pelo menos um uso foi realizado: um notebook que foi iniciado, mas não esgotado, será exibido. Consulte o contador “Restante: X / Y” para a linha que determina o status real. *** ### Livro de vouchers ou plano pré-pago? Ambos são vendidos antecipadamente, mas não são a mesma coisa. | | **Caderno de vales-presente** | **Pacote pré-pago / vale-presente** | | ------------------ | -------------------------------------------------------------- | ---------------------------------------------------------- | | O que é deduzido? | Uma **diversa gama de usos** | Um **valor em euros** | | Perímetro | O produto do voucher (ou produtos que ostentam a sua etiqueta) | Qualquer produto vendido online | | Preço aplicado | O preço do livreto, que substitui o preço da sessão. | A taxa padrão da sessão, paga com cartão de crédito. | | contador visível | "Restante: 7/10" | Saldo em euros | | Restante | Os itens não utilizados são perdidos após o vencimento. | Saldo não utilizado em euros | | Caso de uso típico | Passe para 10 sessões, livreto de inscrição, material do curso | Reembolso, brinde de qualquer valor, crédito para clientes | **Na prática:** Assim que vender *um número de sessões* para uma atividade, utilize um **bloco de vouchers**. Reserve o pacote pré-pago para os casos em que estiver vendendo *uma quantia em dinheiro* para ser gasta livremente. *** ### Erros comuns e soluções | Mensagem/sintoma | Causa | Solução | | ------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | **"Já utilizado"** | O notebook não está mais disponível para uso. | Verifique o balcão no menu **Vales**. Venda um novo livreto, se necessário. | | **"Expirado"** | A data de validade do folheto expirou. | A validade se aplica a todo o livreto. Altere a data de validade do voucher se desejar oferecer um desconto. | | **"Este voucher não corresponde a nenhum item deste pedido"** | O produto reservado não é o que está no caderno e não possui a etiqueta do produto. | Selecione o produto no voucher ou insira uma etiqueta de produto na seção "Vários produtos" do voucher. | | **"O valor do voucher não corresponde à quantidade do item"** | O comando requer mais usos do que os disponíveis no caderno. | Reduza o número de participantes no pedido ou complemente com outro método de pagamento. | | **O campo "Usos incluídos" está ausente.** | Você está editando um plano pré-pago (produto de crédito). | Crie o voucher a partir da página de detalhes do produto, não de um plano pré-pago. | | **O livro de reservas não aparece no site de reservas.** | A venda online de vouchers não está habilitada para este produto. | Na seção **Venda Online** da ficha do produto: marque a caixa para venda online de vouchers. | *** ### Melhores práticas * **Indique claramente o conteúdo da brochura** em seu nome: "Brochura com 10 entradas - adulto" é mais descritivo do que "Brochura". * **Defina um período de validade compatível com a sua estação do ano.** Um período de validade em branco significa "sem expiração": os usos permanecem válidos indefinidamente. * **Teste antes da inauguração do estabelecimento**: venda um livreto para si mesmo, utilize uma transação, verifique o contador "Restante" e o preço aplicado ao pedido. * **Comunique as condições** de utilização: âmbito dos produtos abrangidos, data de validade, não sendo possível o reembolso de produtos não utilizados. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/parametrage-produit/les-forfaits-prepayes-bons-cadeaux-cheques-cadeaux/carnet-de-bons.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.