Pós-Venda e Alterações de Reserva

O módulo de pós-venda gerencia alterações de itinerário em reservas ativas (remarcação voluntária), re-tarifação com cálculo de diferenças de tarifa e penalidades da companhia aérea, bem como o disparo de planos de viagem oficiais.

---

Fluxo de Alteração de Reserva

---

1. Alterar Reserva - Tarifar (/AlterarReservaTarifar)

Calcula a diferença de tarifa, taxas de embarque adicionais e eventuais penalidades/multas cobradas pela companhia aérea para a troca de voos solicitada.

• Método: POST
• Rota: /api/V2/Voos/AlterarReservaTarifar

1.1 Parâmetros da Requisição (AlterarReservaRQ)

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Código localizador da reserva PNR (ex: "SPRPMK").
IdentificacaoDaViagem	String	Condicional	Chave tripKey do novo voo de ida selecionado na pesquisa.
IdentificacaoDaViagemVolta	String	Condicional	Chave tripKey do novo voo de volta selecionado na pesquisa.
MultipleTrips	Array	Condicional	Lista de novos voos para itinerários multi-trecho (TripIdentification).
TarifarMelhorPreco	Boolean	Não	Se true, busca a menor tarifa aplicável entre as cabines compatíveis.
RetornarPlanoDeFinanciamento	Boolean	Não	Se true, retorna opções de parcelamento para eventuais diferenças de valor.
RetornarRegrasTarifarias	Boolean	Não	Retorna o texto legal das regras tarifárias da nova classe.

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "IdentificacaoDaViagem": "G3~1500~BSB~GRU~2026-11-25~ECONOMICA",
  "TarifarMelhorPreco": true,
  "RetornarPlanoDeFinanciamento": true
}

1.2 Estrutura da Resposta (TarifaRS)

A resposta retorna a estrutura completa de tarifação com o montante adicional a pagar (diferença + multa), franquias de bagagem do novo voo e condições de emissão:

{
  "Data": "2026-10-15T16:20:00",
  "Moeda": "BRL",
  "TotalTarifa": 220.00,
  "TotalTaxa": 15.50,
  "TotalTaxaDU": 0.0,
  "TotalRepasseTerceiro": 0.0,
  "TotalGeral": 235.50,
  "TarifasPorPassageiro": [
    {
      "FaixaEtaria": "ADT",
      "Quantidade": 1,
      "TarifaCheia": 220.00,
      "Taxa": 15.50,
      "Total": 235.50
    }
  ],
  "Financiamento": [
    {
      "Parcelas": 1,
      "PrimeiraParcela": 235.50,
      "Moeda": "BRL"
    }
  ],
  "EmissionSettings": {
    "ExigeCodigoDeSeguranca": true
  },
  "Exception": null
}

---

2. Alterar Reserva - Confirmar (/AlterarReservaConfirmar)

Efetiva a alteração do itinerário no inventário do fornecedor, cancelando os segmentos antigos e confirmando os novos horários e voos no PNR.

• Método: POST
• Rota: /api/V2/Voos/AlterarReservaConfirmar

2.1 Parâmetros da Requisição (AlterarReservaRQ)

Utiliza a mesma estrutura de AlterarReservaRQ, incluindo dados de pagamento caso a alteração resulte em cobrança adicional imediata:

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Localizador da reserva.
IdentificacaoDaViagem	String	Condicional	Chave tripKey do novo voo confirmado.
IdentificacaoDaViagemVolta	String	Condicional	Chave tripKey do novo voo de volta.
Pagamento	Objeto	Condicional	Informado caso a alteração requeira liquidação de diferença tarifária/multa no ato.

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "IdentificacaoDaViagem": "G3~1500~BSB~GRU~2026-11-25~ECONOMICA",
  "Pagamento": {
    "FormaDePagamento": 1,
    "ValorFaturado": 235.50,
    "Requisicao": "PO-REMARK-001"
  }
}

2.2 Resposta (ReservaRS)

Retorna a reserva atualizada com o localizador, o novo status e a nova lista de voos confirmados.

{
  "Localizador": "SPRPMK",
  "Status": "Confirmada",
  "Data": "2026-10-15T16:25:00",
  "Voos": [
    {
      "Id": 1,
      "Companhia": "G3",
      "Numero": "1500",
      "DataSaida": "2026-11-25T14:00:00",
      "DataChegada": "2026-11-25T15:20:00",
      "Origem": { "CodigoIata": "BSB" },
      "Destino": { "CodigoIata": "GRU" },
      "Classe": "U"
    }
  ],
  "Passageiros": [
    {
      "Nome": "JOSE",
      "Sobrenome": "SILVA",
      "FaixaEtaria": "ADT"
    }
  ],
  "Exception": null
}

---

3. Enviar Plano de Viagem (/EnviarPlanoDeViagem)

Dispara o e-mail oficial formatado do Travellink com itinerário completo, horários de voo atualizados, franquias de bagagem, números de e-ticket e dados dos passageiros para os destinatários desejados.

• Método: POST
• Rota: /api/V2/Voos/EnviarPlanoDeViagem

3.1 Parâmetros da Requisição (EnviarPlanoDeViagemRQ)

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Localizador da reserva PNR (ex: "SPRPMK").
Para	String	Sim	E-mail do destinatário principal (ex: "passageiro@email.com").
Copia	String	Não	E-mails adicionais em cópia (separados por vírgula ou ponto e vírgula).
EnviarRegrasTarifarias	Boolean	Não	Se true, anexa ou inclui no corpo do e-mail o resumo das regras tarifárias.
DesejoReceberUmaCopia	Boolean	Não	Se true, envia automaticamente uma cópia para o e-mail cadastrado do usuário logado.

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "Para": "jose.silva@empresa.com.br",
  "Copia": "gestor.viagens@empresa.com.br",
  "EnviarRegrasTarifarias": false,
  "DesejoReceberUmaCopia": true
}

3.2 Resposta (EnviarPlanoDeViagemRS)

{
  "Data": "2026-10-15T16:30:00",
  "Sucesso": true,
  "Exception": null
}