A unPlan.es converte um orçamento, um estilo e um intervalo de datas num dia totalmente reservado — da manhã à noite, consciente do transporte público, com sessões com entrada agendada e reservas que gerimos por si (cada uma com o seu fornecedor real). O cliente percorre um assistente de 7 passos; os parceiros recebem tráfego qualificado e de alta intenção, com fulfilment end-to-end em 24 horas.
Um documento para fornecedores de inventário, redes de afiliação e parceiros comerciais — quem somos, o que entregamos, como conectar. Snapshot gerado em 2026-05-28 00:27 UTC.
O que vais encontrar neste documento.
Não é um marketplace de atividades soltas. É um planeador que costura um dia inteiro — manhã, almoço, tarde, jantar, noite — ancorado à hora real do voo, com trânsitos validados contra o Google Maps e sessões com entrada agendada carimbadas a partir do catálogo de cada fornecedor.
Seis faixas diárias com duas alternativas por faixa, mais uma opção "tempo livre". Os dias de chegada e regresso adaptam-se à hora real de aterragem/descolagem — nunca prometemos um almoço de boas-vindas às 13:30 quando o avião aterra às 16:00.
Quando um fornecedor está ligado, as opções mostradas são inventário em direto com preços em EUR. Se uma categoria não tiver resolver real, fica vazia até integrarmos um — nunca inventamos.
O cliente não reserva peça por peça. Como intermediário por mandato, reservamos inventário em hold (Duffel hold orders, LiteAPI prebookId, Viator cartRef) e confirmamos em 24 h; cada reserva é paga com o seu fornecedor real e a unplan cobra apenas a sua gestão (não é o comerciante das reservas). Os localizadores chegam por email e notificação push.
Todo o percurso corre numa única função serverless (Vercel) com CSP estrita, HSTS e RLS na base de dados Supabase.
Se fornece voos, hotéis, bilhetes, tours, restaurantes ou experiências, eis o que ligamos, como, e qual o custo para si.
| Categoria | Fornecedores | Modo de integração | Estado |
|---|---|---|---|
| Vuelos | Aviasales · Duffel · Kiwi.com · LiteAPI Flights | Aggregator · API E2E · Aggregator · API E2E | Em direto |
| Trenes | Rail Europe | Aggregator | Beta |
| Alojamiento | LiteAPI Hotels | API E2E | Em direto |
| Actividades & tours | Awin product feeds · Civitatis · Fever · GetYourGuide · Groupon · Klook · Tiqets · TradeDoubler product feeds · Viator | Feed · Aggregator · Aggregator · Aggregator · Aggregator · Aggregator · Aggregator · Feed · API E2E | Em direto |
| Museos & cultura | Fever · Tiqets · Viator | Aggregator · Aggregator · API E2E | Em direto |
| Guías locales | GuruWalk · Viator · WeGoTrip | Aggregator · API E2E · Aggregator | Em direto |
| Experiencias premium | Tiqets | Aggregator | Em direto |
| Restaurantes | Yelp Fusion | Feed | Beta |
| Vida nocturna | Fever | Aggregator | Em direto |
| Conciertos | Fever · Ticketmaster | Aggregator · Aggregator | Em direto |
| Plan gratuito | OpenStreetMap POIs | Feed | Em direto |
Pesquisa → prebook → book → cancel a partir do nosso backend serverless. O cliente não reserva peça por peça: chamamos a sua API com o padrão de booking diferido e cada reserva é paga com o seu fornecedor real (a unplan atua como intermediário por mandato e cobra apenas a sua gestão, não é o comerciante das reservas). Usado por Duffel, LiteAPI (hotéis e voos) e Viator Partner (gated).
Ideal para: receitas diretas em tarifa wholesale + margem, sem perda de cookie de afiliação.
Ingerimos o seu Product Data Feed (Awin, TradeDoubler, Impact, Partnerize), aplicamos o nosso tagger + cache L2 e mostramos as opções dentro da agenda. Click-through para o seu checkout com publisher / SID / CID já carimbados.
Ideal para: marcas com programas de afiliação e modelos CPA / CPL.
Quando não há API de booking, usamos APIs de pesquisa (Yelp, OSM Overpass) e redirecionamos o cliente com o nosso partner ID. O parser inbound captura o localizador no email de resposta.
Ideal para: cobertura long-tail e de complemento.
A unPlan.es é um publisher editorial com um modelo comercial claro: cada percurso pelo assistente termina num plano que gerimos como intermediário por mandato (cada reserva com o seu fornecedor real). O tráfego que enviamos é tráfego com intenção de compra, orçamento conhecido e itinerário confirmado, não cliques por curiosidade.
Carimbamos Publisher ID / SID / CID em cada deep-link, deixamos a cookie da rede na mesma janela e notificamos as URLs de postback (Impact, Partnerize) quando disponíveis. Cada redirecionamento é uma pesquisa em que já conhecemos as datas, o tamanho do grupo, o orçamento e a alternativa considerada.
Sem idas e vindas, sem corridas de reembolso. O cliente não reserva peça por peça: cada reserva é paga com o seu fornecedor real e a unplan cobra apenas a sua gestão (não é o comerciante das reservas). Mantemos o inventário em hold 24-72 h e reconciliamos reservas manuais + API antes do auto-confirm disparar. Se não pudermos entregar, o sistema reembolsa automaticamente — o parceiro vê um cancelamento limpo, não um chargeback.
Tom editorial, sem pop-ups, sem tráfego incentivado, sem coupon-scraping. O inventário aparece acompanhado de contexto cultural e gastronómico. A marca lê-se como concierge, não como comparador.
Mercado espanhol com expansão europeia ativa. O autocompletar de origem usa Google Places (pós-março 2025), e o assistente suporta 10 estilos em ES, FR, IT, PT, NL, DE, mais uma expansão curada pelo Leste europeu (9 cidades adicionadas em 2026-05).
Uma postura técnica séria não é opcional quando se chamam as APIs de outros com a reputação deles em jogo. Este é o stack e o que fazemos para o proteger.
docs/runbooks/security-incident.md (T+0 / 15 m / 1 h / 24 h / 7 d)./api/cron/expire-holds reembolsa de 5 em 5 min os holds vencidos e notifica o cliente.O cliente paga o preço wholesale tal qual. A nossa management fee está fixada a 0 % — a receita da unPlan.es é a comissão de afiliação / parceiro a montante, líquida para o cliente. A única linha opcional é o cartão virtual pré-pago ("All-Inclusive"), com teto de 50 EUR / pessoa / dia e uma fee administrativa de 25 EUR absorvida na linha de gestão. Teto total de fees fixas: 25 EUR por plano.
Há três portas. Escolha a que encaixa e devolvemos um plano de integração de uma página em 5 dias úteis.
Se opera uma API de booking (NDC, hotel content + book, reserva de ticketing), construímos o adaptador em pkg/providers/, certificamos contra o seu sandbox e implantamos em produção com os nossos padrões de booking diferido e idempotency-key.
Timeline: habitualmente 2–4 semanas por adaptador, sujeito a certificação.
Se gere um Product Data Feed ou um programa Click + Postback (Awin, TradeDoubler, Impact, Partnerize, Travelpayouts), partilhe o FID / SID / publisher ID e ativamos na mesma semana. Aceitamos JSON, CSV, JSONL e o novo Awin Enhanced Feed v2.
Timeline: 1–7 dias das credenciais até à primeira receita.
Integrações editoriais à medida: estilos de marca dentro do assistente, pacotes de cidades curados, vouchers B2B, cartões-presente através da linha de cartão virtual pré-pago. Pensada para travel boards, DMOs, grupos hoteleiros e programas de cartões premium.
Timeline: conforme brief de campanha.
Vendas, parcerias, co-marketing, onboarding de afiliados, consultas de revenue share.
Implementação de adaptadores, handoff de sandbox, configuração de postbacks, certificação.