Tarifação de Voos e Regras Tarifárias

A etapa de tarifação valida o preço em tempo real junto ao fornecedor (GDS ou companhia aérea), congela as classes de reserva, confirma a disponibilidade de assentos nas cabines e retorna as políticas de cancelamento, penalidades e planos de financiamento autorizados.

---

1. Tarifar (/Tarifar)

Valida as opções de voo selecionadas na pesquisa antes da criação do PNR.

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

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

Campo	Tipo	Obrigatório	Descrição Detalhada
IdentificacaoDaViagem	String	Condicional	Chave tripKey do voo de ida (ou do itinerário completo combinado quando Flex: true).
IdentificacaoDaViagemVolta	String	Condicional	Chave tripKey do voo de volta (quando a pesquisa foi realizada com Flex: false).
ViagensMultiplas	Array	Condicional	Utilizado para tarifar pesquisas de múltiplos trechos (MultiplosTrechos). Lista de objetos contendo TripIdentification para cada segmento.
ClassesSelecionadas	Array	Não	Permite forçar ou validar classes tarifárias e famílias específicas por segmento de voo (FlightNumber, ClassOfService, FareBasis, Family).
TarifarMelhorPreco	Boolean	Não	Se true, instrui o motor a reavaliar se existe uma tarifa pública mais baixa disponível para os mesmos voos.
TarifarMelhorFamilia	Boolean	Não	Se true, avalia alternativas dentro da mesma família tarifária da companhia aérea.
RetornarPlanoDeFinanciamento	Boolean	Não	Se true, calcula e retorna a simulação oficial de parcelamento com cartões de crédito autorizados pela companhia aérea (FinancingPlans).
RetornarRegrasTarifarias	Boolean	Não	Se true, inclui o texto integral das regras tarifárias (penalidades de no-show, remarcação e reembolso) na resposta da tarifação.
RetornarUpsell	Boolean	Não	Se true, retorna opções de upgrade de família de tarifa (upsell, ex: adicionar bagagem e assento conforto por diferença de valor).
ClienteId	Integer	Não	Identificador do cliente corporativo para aplicação de acordos negociados.
transacaoId	String	Não	Identificador de correlação (GUID) para auditoria.

---

1.2 Estrutura da Resposta (TarifaRS)

Campo	Tipo	Descrição
Data	DateTime	Carimbo de data/hora do processamento.
Companhia	String	Código IATA da companhia aérea responsável pela emissão (ex: "G3").
Price	Objeto	Detalhamento tarifário consolidado (Tarifa, Taxa, Total, TotalTarifa, TotalTaxaEmbarque, TotalFee, TotalRav, TotalTaxaServico, TotalGeral, etc.).
Price.AdultPrice	Objeto	Composição de custo por passageiro adulto (ADT).
Price.ChildPrice	Objeto	Composição de custo por passageiro criança (CHD).
Price.BabyPrice	Objeto	Composição de custo por bebê de colo (INF).
PriceChange	Objeto	Informa se houve variação de valor entre a pesquisa e a tarifação (PreviousAmount, CurrentAmount, Currency).
CabinChanges	Array	Informa se houve realocação involuntária de classe/cabine (RequestedCabin, SelectedCabin, SelectedCabinDescription).
AutomaticReprice	Boolean	Se true, sinaliza que o motor executou retarificação automática devido a expiração de assentos anteriores.
ModelTributaryInformation	Objeto	Regra de Informação Tributária do canal: • RequiredPayer (Boolean): Se o pagador exige dados fiscais. • RequiredPassenger (Boolean): Se o viajante exige dados fiscais. • Model (String): Modelo ("Pagador01" ou "Passageiro01"). • InformacaoTributariaObrigatoria (Boolean): Se é mandatório para a agência.
RequiresTributaryInformation	Boolean	Indicador geral se a emissão requer dados tributários.
AcceptedTributaryInformationType	Array	Lista de tipos de documentos fiscais suportados para este canal.
DocumentosAceitos	Array	Documentos aceitos para os passageiros (Id, Descricao).
FoidRequired	Boolean	Se true, a companhia aérea exige documento FOID obrigatório na reserva.
FOIDPassengerDocumentOptions	Array	Relação de documentos aceitos para atendimento do requisito de FOID.
RequiresPassengerDocument	Boolean	Se true, o envio de documento de cada passageiro é obrigatório já na reserva.
RequiresFromDateBirthOfAdultPassengers	Boolean	Se a companhia exige a data de nascimento dos adultos no PNR.
RequiresDateOfBirthforChildPassengers	Boolean	Se a companhia exige a data de nascimento das crianças no PNR.
RequiresContactFromPassengers	Boolean	Se a companhia aérea exige e-mail e telefone de cada passageiro no PNR.
RequiresPassengerContactAllowsYoutoRefuse	Boolean	Se a companhia aérea permite o envio de flag de recusa de contato do passageiro.
EnableMiddleName	Boolean	Se a companhia aérea suporta campo específico de nome do meio (Middle Name).
EnableTSAFields	Objeto	Requisitos de segurança para voos nos EUA/internacionais (Redress, Required, PassportRequired, CitizenCard).
FinancingPlans	Array	Planos de parcelamento aprovados por bandeira (Vendor, Installments, PrimeiraParcela, vlJurosCalculado, etc.).
FareRules	Array	Regras textuais detalhadas da tarifa.
UpsellOptions	Array	Opções de famílias superiores de tarifa (upsell) disponíveis para seleção.
CanVisualizeCommercialTerms	Boolean	Se o usuário logado tem permissão para visualizar margens e comissões comerciais.
EmissionSettings	Objeto	Configurações técnicas de emissão do fornecedor (ConfiguracoesDeEmissao).
Exception	Objeto / null	Preenchido em caso de indisponibilidade de tarifa ou recusa da companhia.

---

2. Obter Regras da Tarifa (/ObterRegraDaTarifa)

Recupera as penalidades contratuais detalhadas de alteração de voo, cancelamento, reembolso e não comparecimento (no-show).

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

2.1 Parâmetros da Requisição

{
  "IdentificacaoDaViagem": "G3~1500~GIG~GRU~2026-10-15~U~ECONOMICA"
}

2.2 Estrutura da Resposta

{
  "Data": "2026-10-15T10:15:00",
  "Regras": [
    {
      "Categoria": "Cancelamento / Reembolso",
      "Descricao": "Permitido antes do voo com retenção de R$ 350,00 por trecho. Não reembolsável após o voo."
    },
    {
      "Categoria": "Alteração de Voo",
      "Descricao": "Permitida mediante pagamento de taxa de remarcação de R$ 250,00 mais eventual diferença tarifária."
    },
    {
      "Categoria": "No-Show",
      "Descricao": "Taxa de não comparecimento de R$ 400,00 por passageiro."
    }
  ],
  "Exception": null
}