Neste artigo você verá:
Como solicitar a Chave de Assinatura
Como solicitar o usuário Web Services
Como configurar a integração no Monde
Como importar vendas
Principais erros e como resolver
O que é necessário para utilizar a integração?
Para utilizar a integração com a Azul Linhas Aéreas, sua agência precisa ter:
Usuário Web Services
Senha do usuário Web Services
Chave de Assinatura (Primary Key)
URL da integração
O usuário Web Services é único por agência e pode ser utilizado nas importações realizadas pelos vendedores.
Como solicitar o usuário Web Services?
Cada agência deve solicitar à Azul um usuário Web Services, que será utilizado por todos os vendedores na integração.
Para solicitar suas credenciais, entre em contato com a Azul pelo e-mail suporteb2b@voeazul.com.br.
Após receber o usuário e a senha, eles deverão ser informados diretamente no cadastro da integração no Monde.
Como solicitar a Chave de Assinatura?
Em 2026, a Azul passou a utilizar uma nova API, que exige uma Chave de Assinatura (Primary Key).
Sem uma chave válida 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 consultar os dados da Azul pela integração.
Cada agência precisa solicitar sua própria chave.
A 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.
1. Faça o cadastro no Portal do Desenvolvedor
Acesse o Portal do Desenvolvedor da Azul, no 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.
2. Solicite a chave de API
No portal:
Acesse a seção Products.
Localize o produto Sales B2B — Agency.
Clique sobre o produto.
Crie uma Chave de Assinatura.
Informe um nome para identificar a chave.
Clique em Subscribe.
O nome da chave deve conter o nome da agência para facilitar a identificação e não pode ter espaços ou acentos.
Exemplo: para uma agência chamada Azul Viagens Americana, o nome poderia ser azulviagensamericana-monde.
3. Solicite a liberação da chave
Após criar a chave, 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. Visualize e copie a chave
Após a aprovação:
Acesse o menu Profile.
Localize a chave aprovada.
Clique em Show.
Copie a chave exibida.
Essa é a Chave de Assinatura que deverá ser informada no cadastro da integração no Monde.
Como configurar a integração no Monde?
Após obter o usuário Web Services, a senha e a Chave de Assinatura, faça a configuração diretamente no cadastro da integração.
1. Cadastre a integração
Acesse Cadastros > Integrações.
Clique em Adicionar > Integração com Fornecedor.
Selecione Azul Linhas Aéreas.
Preencha os campos:
Usuário: informe o usuário Web Services fornecido pela Azul;
Senha: informe a senha do usuário Web Services;
Chave de Assinatura: informe a chave obtida no Portal do Desenvolvedor da Azul;
URL: informe a URL correspondente à integração.
Clique em Salvar.
Importação de vendas
Após configurar a integração, é possível importar as vendas utilizando:
Número da reserva
Localizador
Voucher
Digite a informação exatamente como aparece no portal da Azul, respeitando letras maiúsculas e demais caracteres.
Produtos importados
Passagem aérea
Forma de pagamento
Quando o cliente realizar o pagamento diretamente para a agência, essa forma de pagamento não será importada automaticamente.
Nesse caso, será necessário incluí-la manualmente no Monde.
Como atualizar a Chave de Assinatura?
A Azul recomenda atualizar a Chave de Assinatura a cada 6 meses.
Para gerar uma nova chave:
Acesse Profile no Portal do Desenvolvedor da Azul.
Localize a chave.
Clique em Regenerate.
Copie a nova chave.
Atualize a Chave de Assinatura no cadastro da integração da Azul no Monde.
Se houver comportamento suspeito, a chave poderá ser bloqueada automaticamente pela Azul.
Resolução de problemas
Credencial inválida
Confira se o usuário Web Services e a senha informados no cadastro da integração estão corretos.
Não utilize o CPF ou as antigas credenciais individuais dos vendedores.
Se necessário, confirme as credenciais Web Services com a Azul.
Mensagem de alerta ao importar
Verifique:
se a Chave de Assinatura foi preenchida no cadastro da integração;
se a chave já foi aprovada pela Azul;
se a chave informada está válida.
Voucher não encontrado
Confira:
se o número foi digitado exatamente como consta no portal da Azul;
se a Chave de Assinatura está válida;
se o usuário Web Services e a senha estão corretos.
Se todas as informações estiverem corretas e o problema continuar, entre em contato com o Suporte.