Integração com a Enjoy.it
A Enjoy.it é um sistema de autosserviço de bebidas. O estabelecimento instala torneiras controladas por um totem: o cliente se identifica com uma comanda, um cartão ou um QR Code, serve a si mesmo o quanto quiser, e a torneira mede exatamente quantos mililitros saíram. Cada servida vira uma venda registrada na Enjoy.it, cobrada por mililitro — quem tirou 300 ml paga menos do que quem tirou 500 ml.
Esta documentação é para quem vai ligar um sistema de frente de caixa (PDV) a essa operação, de modo que o que o cliente serviu na torneira chegue à conta dele no seu sistema.
A API é REST, com JSON e autenticação por chave — a parte técnica é direta. O que costuma exigir mais atenção é entender em que momento da operação cada chamada acontece, porque existe uma venda sendo feita fora do seu PDV.
Onde ela entra no seu PDV
A Enjoy.it funciona como um garçom invisível que lança itens na conta do cliente sem passar pela sua tela. Seu sistema tem dois papéis: dizer quem é o cliente e trazer os lançamentos de volta.
1. ABRIR 2. CONSUMIR 3. FECHAR
Seu PDV avisa: O cliente serve Seu PDV busca os
"a comanda 006 sozinho, quantas chopes, soma na conta
é do João" vezes quiser e bloqueia a comanda
| | |
POST .../checkin (nenhuma chamada GET .../transactions
sua nesta etapa) POST .../checkout
Na prática, você mexe em telas que o seu sistema já tem:
| Tela que o seu PDV já tem | O que você acrescenta nela |
|---|---|
| Abrir comanda, mesa ou conta | Uma chamada avisando a Enjoy.it quem é o cliente daquela comanda |
| Lançamento de itens pelo garçom | Nada. Os chopes entram sozinhos, sem digitação |
| Extrato / espelho da conta | Uma chamada que busca os chopes e os exibe junto com o resto |
| Fechamento e pagamento | Uma busca final dos chopes e uma chamada que bloqueia a comanda |
| Recarga de crédito | Uma chamada informando o valor pago — só existe no modelo pré-pago |
Em uma operação pós-paga, que é a mais simples, são três chamadas obrigatórias: abrir, consultar e fechar. Todo o resto da documentação é sobre variações desse mesmo trio.
Como o cliente é reconhecido na torneira
A jornada é sempre a mesma; muda só o que o cliente apresenta no equipamento para liberar o chopp.
| Forma | Quando usar | Endpoints |
|---|---|---|
| Comanda | O cartão tem um número impresso e o caixa não lê chip. É o caminho mais simples e o padrão recomendado. | Comandas |
| RFID / NFC | Você já tem leitor de cartão no caixa e prefere trabalhar com o código do chip | RFID |
| QR Code | Totem de autoatendimento ou operação sem cartão físico | QR Code |
| Wallet | Aplicativo próprio, onde o cliente libera a torneira remotamente | Wallet |
Escolher a forma de identificação é só a primeira de três decisões. As outras duas — quem paga antes ou depois, e como os chopes chegam até você — estão em Escolha sua integração, com uma pergunta objetiva para cada uma.
Por onde começar
- Conceitos e glossário, se o vocabulário da operação não for familiar.
- Peça as credenciais de homologação em tech@letsenjoy.it.
- Faça a primeira chamada e veja uma comanda abrir de verdade.
- Responda as três perguntas em Escolha sua integração.
- Implemente o fluxo completo seguindo Jornada ponta a ponta.
- Agende a homologação técnica com a equipe Enjoy.it e faça a virada assistida para produção.