Passar para o conteúdo principal

Como configurar a integração com a Azul Linhas Aéreas

Neste artigo, veja como cadastrar e importar suas vendas da Azul Linhas Aéreas.

Atualizado há mais de 3 semanas

Neste artigo você verá:

  • Como solicitar a Chave de Assinatura

  • Como configurar a integração no Monde

  • Como importar vendas

  • Principais erros e como resolver


Configuração obrigatória — Chave de Assinatura

Em 2026, a Azul passou a utilizar uma nova API, que exige o uso de uma Chave de Assinatura (Primary Key).

Sem a chave preenchida na integração:

  • Será exibida uma mensagem de alerta ao tentar importar

  • A integração não funcionará

A Chave de Assinatura funciona como uma senha técnica que autoriza sua agência a consumir os dados da Azul via integração.

⚠️ Cada agência precisa solicitar a sua própria chave.

Essa chave:

  • É individual

  • Não deve ser compartilhada

  • Pode ser revogada em caso de uso indevido

  • Deve ser atualizada a cada 6 meses, conforme recomendação de segurança da Azul

Como solicitar a chave?

1. Cadastro no Portal do Desenvolvedor

  • Acesse o Portal do Desenvolvedor da Azul (ambiente de produção).

  • Clique em Sign up.

  • Preencha o formulário de registro.

  • Confirme o cadastro pelo e-mail recebido.

  • Após a confirmação, faça login no portal.

Exemplo:

Signup

2. Solicitar a chave de API

  • No portal, acesse a seção Products.

  • Localize o produto Sales B2B — Agency.

  • Clique sobre o produto.

Passos 2 e 3
  • Crie uma chave de assinatura.

  • O nome da chave deve conter o nome da agência para fácil identificação e não pode conter espaços e acentos.

    • Exemplo: Se a agência fosse Azul Viagens Americana, a chave seria azulviagensamericana-monde .

  • Clique em Subscribe.

Passos 4 e 5

3. Solicitar liberação da chave

Após a criação, envie um e-mail para: suporteb2b@voeazul.com.br

Anexe:

  • Um print da tela mostrando a URL do ambiente

  • O nome da chave criada

Aguarde a aprovação do time técnico da Azul.
A confirmação será enviada por e-mail.

4. Visualizar e copiar a chave

Após a aprovação:

  • Acesse o menu Profile.

  • Localize a chave aprovada.

  • Clique em Show.

  • Copie a chave exibida.

Subscriptions

Essa é a chave que será informada na integração dentro do Monde.


Configurando a integração no Monde

Após obter a Chave de Assinatura, siga os passos abaixo.

1. Cadastrar a integração

  • Acesse Cadastros > Integrações

  • Clique em Novo

  • Selecione Azul Linhas Aéreas

  • Clique em OK

2. Vincular aos usuários

  • Acesse Cadastros > Pessoas

  • Localize o usuário que utilizará a integração com duplo clique.

  • Vá até a aba Usuário.

  • Em Integração, clique em Adicionar.

  • Selecione a integração da Azul Linhas Aéreas. Caso não exista cadastro, clique em “…”, selecione Nova Pessoa Jurídica e cadastre normalmente.

Informe:

  • Usuário (é o mesmo utilizado pelo vendedor para acessar o portal da Azul)

  • Senha (é a mesma utilizada pelo vendedor para acessar o portal da Azul)

  • Chave de Acesso (a chave obtida no passo anterior)

Salve e repita para todos os usuários que farão importação.


Importação de vendas

É possível importar utilizando:

  • Número da reserva

  • Localizador

  • Voucher

⚠️ Atenção: digite exatamente como aparece no portal da Azul, respeitando letras maiúsculas e caracteres.


Produtos importados

  • Passagem aérea


Observação

  • Se o cliente pagar diretamente para a agência, essa forma de pagamento não será importada automaticamente.

  • Será necessário incluir manualmente no Monde.

⚠️ Atualização da Chave (Importante)

A Azul recomenda atualizar a chave a cada 6 meses.

Para regenerar:

  • Acesse o Profile

  • Localize a chave

  • Clique em Regenerate

Regenerate Subscription Key
  • Atualize a nova chave onde estiver sendo utilizada

Se houver comportamento suspeito, a chave poderá ser bloqueada automaticamente.


Resolução de problemas

Credencial inválida

Significa que:

  • Usuário ou senha estão incorretos no cadastro do Monde.

  • Solução: atualize o login no cadastro do usuário.

Mensagem de alerta ao importar

Verifique:

  • Se a Chave de Assinatura foi preenchida

  • Se a chave já foi aprovada pela Azul

Voucher não encontrado

Se já confirmou:

  • Número digitado corretamente

  • Chave válida

  • Credenciais corretas

Entre em contato com o suporte.

Respondeu à sua pergunta?