API de reservas de cruzeiros
Uma API de cruzeiros permite que o seu site mostre saídas em tempo real, precifique categorias de cabine e crie reservas de cruzeiro junto à companhia. Esta página explica como são os dados, como funcionam cabines e pagamentos e as duas formas de colocar inventário de cruzeiros no seu próprio site PHPTRAVELS.
O que uma API de cruzeiros retorna
Um cruzeiro é vendido como uma saída: um navio, um roteiro, uma data de partida. Toda API de cruzeiros, seja qual for o formato, é construída em torno dessa unidade.
Uma busca envia uma região, um mês ou período de datas, uma duração e o número de hóspedes. A resposta é uma lista de saídas, cada uma com o navio, a companhia, as datas de embarque e retorno, os portos de escala com horários, os dias no mar e um preço inicial por pessoa para cada categoria de cabine ainda disponível.
A partir daí, outras chamadas precificam a categoria escolhida para os hóspedes reais, listam as cabines que podem ser escolhidas, fazem a reserva e recebem os pagamentos. Nomes e formatos variam entre companhias, por isso a plataforma mapeia cada fonte para o mesmo modelo de saída, cabine e reserva antes de o hóspede ver qualquer coisa.
Companhia
Sua companhia parceira
Navio parceiro · 7 noites
Roteiro
Registro ilustrativo, não o formato de uma companhia específica.
Categorias de cabine
Em cada saída, uma API de cruzeiros lista categorias de cabine. Elas são o principal fator de preço, e cada uma muda várias coisas ao mesmo tempo.
O preço de entrada da saída. As companhias costumam dividi-la em várias categorias por convés e posição, cada uma com seu código.
Um degrau acima, com luz natural. Algumas categorias têm vista obstruída, o que a API indica na descrição da categoria.
Um espaço externo privativo, com categorias que mudam conforme a altura do convés e a posição no meio ou na popa.
O topo da tabela de preços, muitas vezes com extras incluídos na tarifa, e as categorias com mais chance de serem vendidas como uma cabine específica.
Cada categoria tem um código, e cada saída pode ser vendida sob vários códigos de tarifa: tarifas padrão, promocionais e de grupo ou de agência. A mesma cabine pode ter preços e condições diferentes conforme o código de tarifa.
Na reserva garantida, o hóspede compra uma categoria e a companhia atribui a cabine depois, nessa categoria ou superior. A reserva de cabine específica fixa o número da cabine no momento da reserva. Muitas companhias precificam as duas de forma diferente.
Escolha da cabine
Quando a companhia permite reservar uma cabine específica, a API retorna as cabines ainda disponíveis na categoria escolhida, com convés, posição e quantos hóspedes cada uma acomoda.
Convés 9
Selecione uma cabine
Cabine 9110
Interna
Cabine interna, o menor preço neste convés. Vendida como cabine específica ou como garantida.
Vista para o mar
Cabine com janela na proa, onde o casco se curva. A API retorna a observação sobre a vista junto com a categoria.
Varanda
Cabine com varanda no meio do navio. A posição no convés costuma ser uma categoria separada, com preço próprio.
Suíte
Suíte voltada para a popa com varanda maior. Normalmente reservada como cabine específica, não como garantida.
No Cruzeiros do PHPTRAVELS, os navios trazem seus conveses e categorias de cabine e os hóspedes escolhem com os fatos diante deles, sejam as cabines suas ou de uma companhia conectada.
Cronograma de pagamento
Cruzeiros são reservados com meses de antecedência e pagos em etapas. A companhia define as datas e os valores de cada saída e tarifa, e a API os retorna junto com a reserva.
O hóspede paga um depósito definido pela companhia, por pessoa ou por reserva, para confirmar a cabine.
O saldo vence em uma data definida pela companhia antes da partida. Reservas não pagas podem ser canceladas pela companhia depois dela.
Com o pagamento integral, a companhia libera os documentos do cruzeiro e o hóspede preenche os dados de check-in.
O hóspede embarca. Alterações a partir daí são tratadas a bordo ou conforme as regras da companhia.
Quanto mais perto da saída, maior a parte da tarifa retida no cancelamento. Os períodos e percentuais pertencem a cada companhia e tarifa, por isso uma API de cruzeiros os envia com a reserva e a sua plataforma os mostra ao hóspede antes do pagamento.
Quando você vende saídas contratadas por conta própria, o Cruzeiros funciona do mesmo jeito: você define o depósito e a data do saldo por saída, e os saldos em aberto são acompanhados no painel de administração até serem pagos.
Preços em cruzeiros
Preços de cruzeiro são lidos de outra forma que os de hotéis ou voos. Uma API de cruzeiros retorna as partes separadas, e o seu motor de reservas precisa juntá-las do mesmo jeito que a companhia.
Sobre o preço da companhia, o PHPTRAVELS aplica suas margens e comissões por navio, saída ou canal, e os agentes no Portal de viagens B2B veem suas próprias tarifas líquidas.
As tarifas de cruzeiro são cotadas por hóspede. Uma cabine para dois custa o dobro da tarifa por pessoa, e a API precifica cada hóspede por idade e posição na cabine.
Os preços iniciais pressupõem dois hóspedes dividindo a cabine. O terceiro e o quarto hóspede costumam pagar tarifa menor, e quem viaja sozinho paga um suplemento individual.
Impostos governamentais, taxas e tarifas portuárias são somados por pessoa à tarifa do cruzeiro. Mostre-os em linhas separadas para que o total não traga surpresas.
Algumas tarifas incluem crédito a bordo, pacote de bebidas ou gorjetas. A API os retorna como itens incluídos na tarifa, e é um dos motivos pelos quais duas tarifas da mesma cabine diferem.
Como obter inventário de cruzeiros
Há dois caminhos para ter cruzeiros no seu site. Muitas agências começam pelo primeiro e acrescentam o segundo quando o volume justifica.
Cadastre no painel as saídas que você contrata: navios, conveses, categorias de cabine, roteiros porto a porto, datas de partida, tarifas por pessoa, temporadas, depósitos e datas de saldo. Parceiros de cruzeiros podem receber um login de fornecedor para manter as próprias saídas atualizadas.
Não há conector de cruzeiros pronto na lista de integrações do PHPTRAVELS. Como todos os planos incluem o código-fonte completo, a API de uma companhia ou consolidadora de cruzeiros é conectada como Integração de API personalizada, mapeada para as mesmas saídas, cabines e reservas que o módulo já exibe.
Procurando fornecedores? A Lista de fornecedores XML API de viagens lista companhias de cruzeiro que distribuem por APIs, e O que é integração de API explica como uma conexão assim é construída.
Abra a demo ao vivo para buscar saídas, comparar categorias de cabine e reservar com depósito, e depois compare os planos em Preços.
Uma API de cruzeiros é um conjunto de serviços web que uma companhia ou consolidadora de cruzeiros abre para vendedores de viagens. O seu sistema a usa para buscar saídas, ler roteiros, precificar categorias de cabine, listar cabines disponíveis, fazer reservas e receber depósitos e pagamentos finais.
Não. O módulo de Cruzeiros é construído em torno de inventário que você mesmo gerencia: navios, categorias de cabine e saídas que você contrata. A conexão com uma companhia ou consolidadora específica é desenvolvida como integração sob medida sobre o código-fonte incluído.
Você se candidata à companhia ou a uma consolidadora de cruzeiros como vendedor de viagens. Os termos de acesso variam por companhia e mercado. Você assina o contrato e recebe as credenciais por conta própria; o PHPTRAVELS nunca fornece credenciais de fornecedor.
A reserva garantida assegura uma categoria de cabine por um preço definido, e a companhia atribui a cabine real depois, nessa categoria ou superior. A reserva de cabine específica fixa o número da cabine no momento da reserva.
A companhia os define por saída e tarifa, e a API os retorna com a reserva. Nas saídas que você mesmo cadastra, você define o depósito e a data do saldo por saída no painel de administração.
As tarifas de cruzeiro são cotadas por hóspede, geralmente com base em dois hóspedes dividindo a cabine. O terceiro e o quarto hóspede pagam suas próprias tarifas, quem viaja sozinho paga um suplemento individual, e impostos, taxas e tarifas portuárias são somados por pessoa.
Sim. Os agentes reservam no portal B2B com suas próprias tarifas líquidas e comissões e pagam pela carteira do agente, na mesma instalação do seu site público.
O plano Enterprise inclui a REST API e os webhooks do PHPTRAVELS com documentação, e todos os planos incluem o código-fonte completo, então seus desenvolvedores podem estender o motor de reservas de cruzeiros ou conectá-lo a outros sistemas.
Comece pelas saídas que você já contrata, carregadas no módulo de Cruzeiros, e veja como elas vendem. Quando uma parceria com uma companhia ou o volume valer a pena, acrescente a API dela por meio de uma integração sob medida.
Continue a explorar
Cookies para medição de anúncios
Usamos cookies do Google para medir quais anúncios trazem visitantes e pedidos de contato, e para lhe mostrar anúncios relevantes. Aceite para permiti-los ou recuse para manter apenas os cookies necessários ao funcionamento do site. Declaração de privacidade
