Serviços Auxiliares (Ancillaries)

O módulo de serviços auxiliares gerencia a oferta e a contratação de adicionais de viagem vinculados a um localizador existente (PNR). Abrange desde franquia de bagagem despachada adicional até serviços especiais como menores desacompanhados, transporte de animais (pet in cabin / pet in hold), refeições especiais e acesso a lounges.

---

Fluxo de Contratação de Ancillaries

---

1. Tipos de Serviço Auxiliar (ServicoTipo)

Ao consultar a disponibilidade, informe o código numérico ou mnemônico do serviço desejado:

Código	Descrição	Casos de Uso Típicos
1	Bagagem	1ª peça despachada (até 23kg), 2ª peça, excesso de peso ou pranchas/equipamentos.
2	Assento	Assentos especiais ou upgrades pagos através do catálogo de serviços.
3	Outros	Prioridade de check-in, fila rápida de raio-X (fast track).
4	MenorDesacompanhado	Serviço de acompanhamento obrigatório para menores viajando sós.
5	PetCabine	Transporte de cão/gato na cabine de passageiros (PETC).
6	PetPorao	Transporte de animais no compartimento de carga (AVIH).
7	RefeicaoEspecial	Solicitação de alimentação kosher, vegetariana, sem glúten, etc.
8	SalaVIP	Acesso avulso a salas VIP conveniadas no aeroporto.
9	Upgrade	Upgrade de cabine de passageiros.

---

2. Disponibilidade de Serviços (/DisponibilidadeDeServicoAuxiliar)

Consulta o catálogo de adicionais elegíveis para a reserva informada no fornecedor.

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

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

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Localizador da reserva PNR (ex: "SPRPMK").
ServicoTipo	Integer / String	Sim	Tipo do serviço auxiliar consultado (1 ou "Bagagem", 5 ou "PetCabine", etc.).

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "ServicoTipo": 1
}

2.2 Estrutura da Resposta (DisponibilidadeDeServicoAuxiliarRS)

Campo	Tipo	Descrição
DisponibilidadeId	String	Identificador de sessão da busca de adicionais. Necessário para as etapas seguintes de tarifação e gravação.
Localizador	String	Localizador consultado.
RequerTarifacao	Boolean	Se true, a companhia aérea exige que os itens passem pelo endpoint /TarifarServicoAuxiliar antes da gravação.
PagamentoObrigatorio	Boolean	Se true, exige liquidação financeira imediata (cartão ou faturado) na chamada de gravação.
ConfiguracoesDeEmissao	Objeto	Regras técnicas de pagamento e emissão do fornecedor.
Ofertas	Array	Lista de ofertas organizadas por passageiro (Passageiro) e trecho (TrechoList).
...Ofertas[].Itens[].ServicoList	Array	Lista de serviços elegíveis (ServicoId, Descricao, Codigo, Quantidade, Moeda, Valor).
Exception	Objeto / null	Objeto de erro.

Exemplo de Resposta

{
  "DisponibilidadeId": "DISP-ANC-892173",
  "Localizador": "SPRPMK",
  "RequerTarifacao": false,
  "PagamentoObrigatorio": true,
  "Ofertas": [
    {
      "Pax": {
        "PaxID": "1",
        "Nome": "JOSE",
        "Sobrenome": "SILVA"
      },
      "Items": [
        {
          "SegmentList": [
            {
              "TrechoID": "1",
              "NumeroDoVoo": "1500",
              "Companhia": "G3",
              "Origem": "BSB",
              "Destino": "GRU"
            }
          ],
          "ServiceList": [
            {
              "ServiceId": "BAG-01-BSB-GRU",
              "Description": "1a Bagagem Despachada (até 23kg)",
              "Code": "0BG",
              "Quantity": 1,
              "Currency": "BRL",
              "Amount": 110.00,
              "Type": 1
            },
            {
              "ServiceId": "BAG-02-BSB-GRU",
              "Description": "2a Bagagem Despachada (até 23kg)",
              "Code": "0BH",
              "Quantity": 1,
              "Currency": "BRL",
              "Amount": 160.00,
              "Type": 1
            }
          ]
        }
      ]
    }
  ],
  "Exception": null
}

---

3. Tarifar Serviço Auxiliar (/TarifarServicoAuxiliar)

Quando RequerTarifacao: true for retornado na disponibilidade, este endpoint deve ser executado para confirmar a cotação exata e regras de cancelamento dos serviços selecionados.

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

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

Campo	Tipo	Obrigatório	Descrição
DisponibilidadeId	String	Sim	Identificador retornado na consulta de disponibilidade.
Localizador	String	Sim	Localizador da reserva.
ServiceIds	Array[String]	Sim	Lista de identificadores de serviço selecionados (ServiceId).

Exemplo de Requisição

{
  "DisponibilidadeId": "DISP-ANC-892173",
  "Localizador": "SPRPMK",
  "ServiceIds": [
    "BAG-01-BSB-GRU"
  ]
}

---

4. Gravar Serviço Auxiliar (/GravarServicoAuxiliar)

Efetiva a compra e a vinculação dos serviços auxiliares aos passageiros da reserva.

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

4.1 Parâmetros da Requisição (GravarServicoAuxiliarRQ)

Campo	Tipo	Obrigatório	Descrição
DisponibilidadeId	String	Sim	Identificador retornado na disponibilidade.
Localizador	String	Sim	Localizador da reserva.
ServiceIds	Array[String]	Sim	Lista de serviços selecionados para contratação.
Payment	Objeto	Condicional	Obrigatório se PagamentoObrigatorio: true.
Payment.FormaDePagamento	Integer	Se Payment	1: Faturado / Depósito. 2: Cartão de Crédito.
Payment.CartaoDeCredito	Objeto	Se Cartão	Estrutura de cartão completa com titular, validade, CVV e endereço.
Payment.ValorFaturado	Decimal	Se Faturado	Valor a ser debitado na fatura da agência.
Payment.Requisicao	String	Não	Ordem de compra corporativa.

Exemplo de Requisição (Com Pagamento em Cartão)

{
  "DisponibilidadeId": "DISP-ANC-892173",
  "Localizador": "SPRPMK",
  "ServiceIds": [
    "BAG-01-BSB-GRU"
  ],
  "Payment": {
    "FormaDePagamento": 2,
    "CartaoDeCredito": {
      "Bandeira": 5,
      "Numero": "4000123456789010",
      "Validade": "12/2028",
      "CodigoDeSeguranca": "123",
      "TitularNome": "JOSE SILVA",
      "TitularCPF": "12345678901",
      "Parcelas": 1
    }
  }
}

4.2 Resposta (GravarServicoAuxiliarRS)

{
  "Data": "2026-10-15T15:45:00",
  "Localizador": "SPRPMK",
  "Status": "Confirmado",
  "EMDs": [
    {
      "Numero": "1274900123456",
      "Descricao": "1a Bagagem Despachada (23kg)",
      "PaxRef": "1",
      "Valor": 110.00
    }
  ],
  "Exception": null
}

---

5. Cancelar Serviço Auxiliar (/CancelarServicoAuxiliar)

Remove e estorna serviços auxiliares previamente gravados que permitam cancelamento avulso conforme política da companhia aérea.

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

5.1 Parâmetros da Requisição (CancelarServicoAuxiliarRQ)

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Localizador da reserva.
ServiceIds	Array[String]	Sim	Lista de identificadores de serviços a cancelar.

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "ServiceIds": [
    "BAG-01-BSB-GRU"
  ]
}

5.2 Resposta

{
  "Data": "2026-10-15T16:10:00",
  "Localizador": "SPRPMK",
  "CancelamentoConfirmado": true,
  "Exception": null
}