Dúvidas respondidas
Quero me tornar parceiro do Monde, por onde começo?
Como autorizo um sistema externo a criar registros no Monde da minha agência?
A conexão automática tem custo, e quem paga?
Por que o cadastro de parceiro ainda não foi aprovado?
O que você vai resolver
Neste artigo, você vai aprender como funciona a conexão automática de parceiros no Monde: quem pode solicitá-la, como é o fluxo até a aprovação, o que o parceiro informa na integração e o que a agência autoriza.
Público-alvo: empresas que querem integrar o próprio sistema ao Monde, e administradores da agência que vão autorizar a conexão.
Requisitos: para o cadastro de parceiro, o CNPJ da empresa e um e-mail com o domínio dela. Para autorizar a conexão, um usuário administrador da agência.
Contexto ou termos-chave
Conexão automática: a ligação entre o sistema de um parceiro e o Monde de uma agência, criada quando a agência autoriza esse parceiro a acessar a conta dela.
Parceiro: a empresa aprovada pelo Monde para acessar o Monde das agências pela API, identificada pelo CNPJ informado no cadastro.
Licença de API: a contratação que a agência faz com o Monde e que libera, na conexão automática, os recursos que vão além de vendas.
Quem pode solicitar a conexão automática
O pedido parte da empresa que quer integrar o próprio sistema ao Monde, e não da agência. A agência entra depois, autorizando um parceiro que o Monde já aprovou.
Podem solicitar:
Empresas que trabalham com agências de viagens, como operadoras, consolidadoras, redes hoteleiras, locadoras, seguradoras e receptivos;
Empresas de tecnologia que desenvolvem CRM, BI, aplicativos e sites para o turismo.
A agência que quer ligar o próprio site, o próprio BI ou outra ferramenta dela ao Monde não passa por aqui: esse caso é a API contratada pela agência, explicada em Como solicitar e utilizar a API do Monde.
Como é o fluxo para se tornar parceiro
O cadastro é público, e o acesso à API só começa depois que o Monde aprova.
Acesse https://web.monde.com.br/partners/signup e preencha Empresa, CNPJ, Responsável, E-mail corporativo e Telefone / WhatsApp
Marque a declaração de que você pode representar a empresa e o aceite dos Termos de Uso da API Monde para Parceiros
Clique em Solicitar integração
Abra o e-mail que o Monde envia, clique em Confirmar e-mail e crie a senha da área do parceiro
Aguarde o contato da equipe do Monde para a reunião de alinhamento
Aprovado o cadastro, abra pelo e-mail a página de credenciais e guarde o Client ID e o Segredo
Entre em https://web.monde.com.br/partners/integration e informe a Política de privacidade e a URL de retorno
Dois detalhes do cadastro:
O e-mail precisa ter o domínio da empresa. Gmail, Hotmail, Outlook e afins não são aceitos;
O link de confirmação do e-mail vale dois dias.
O que o Monde avalia antes de aprovar
Seguir o fluxo não garante a aprovação. O Monde confere os dados da empresa, conversa com o seu time na reunião de alinhamento e decide a seu critério: ele pode aprovar, recusar ou pedir mais informações, sem obrigação de justificar a decisão.
É na aprovação que o Monde define as permissões do parceiro, ou seja, o que ele vai poder fazer no Monde das agências. O parceiro não escolhe essa lista.
Depois da aprovação, o CNPJ do cadastro não muda mais: para integrar com outro CNPJ, é preciso um cadastro novo, e as agências autorizam esse cadastro de novo.
Como acompanhar a situação do cadastro
A situação do cadastro aparece na área do parceiro, em https://web.monde.com.br/partners/integration, acessada com o e-mail e a senha criados na confirmação.
As situações possíveis são:
Aguardando e-mail: falta confirmar o e-mail pelo link que o Monde enviou;
Em análise: o Monde confere os dados e entra em contato para agendar a reunião de alinhamento;
Aprovado, configuração pendente: falta informar a Política de privacidade, a URL de retorno ou as duas;
Conexão habilitada: as agências já podem conectar o seu sistema ao Monde;
Suspenso: o acesso está suspenso;
Não aprovado: o cadastro não foi aprovado.
O que é gratuito e o que é pago
Para o parceiro, o uso da API é gratuito em qualquer modalidade. O que pode ter custo é a licença de API da agência, e isso depende das permissões que o Monde liberou para o parceiro.
O que cada modalidade exige:
Vendas: o parceiro cria e edita as próprias vendas na conta da agência, e pode anexar arquivos a elas. Nem o parceiro nem a agência pagam por essa modalidade;
Demais recursos: qualquer permissão fora de vendas exige que a empresa escolhida pela agência tenha licença de API ativa, contratada por ela com o Monde.
Na modalidade Demais recursos, o acesso do parceiro depende da licença da agência: se ela vencer ou for cancelada, o acesso a esses recursos para.
Para contratar a licença de API, a agência fala com o time Comercial do Monde. Quando a agência tem mais de uma empresa cadastrada, a licença é por empresa, como explicado em Como funcionam multiempresas no Monde.
O que o parceiro precisa fazer na integração
Com o cadastro aprovado, a integração é construída no sistema do parceiro, por um desenvolvedor.
Na área do parceiro, em https://web.monde.com.br/partners/integration, informe a Política de privacidade, que a agência lê antes de autorizar, e a URL de retorno, o endereço do seu sistema que recebe a agência depois da autorização. As duas precisam começar com https://
Guarde o Client ID e o Segredo da página de credenciais no servidor do seu sistema, nunca no navegador do usuário
Coloque no seu sistema o botão Conectar com o Monde, apontando para o endereço de autorização que o seu sistema monta a cada acesso
Siga a documentação da API para montar o endereço de autorização, trocar o código pelo token e usar a API
Enquanto faltar a Política de privacidade ou a URL de retorno, nenhuma agência consegue autorizar o seu sistema.
Limitações conhecidas
O Segredo aparece uma única vez, na página de credenciais. Guarde-o nesse momento. Para vê-lo de novo, não há como reabrir a mesma página: é preciso pedir ao Monde que gere um segredo novo;
A URL de retorno é uma só por parceiro. Para atender endereços diferentes, trate essa diferença dentro do seu próprio sistema;
Depois que a conexão é habilitada, as duas URLs podem ser trocadas, mas não podem ficar em branco.
A documentação da API
A documentação da API do Monde é pública, em https://web.monde.com.br/api/v3/documentation, e não exige login. Ela está em português e em inglês, e tem uma seção própria sobre a conexão automática, com o passo a passo técnico e os modelos do botão Conectar com o Monde.
Na abertura da página há o link para baixar o arquivo da especificação, no padrão OpenAPI, para abrir a documentação em outras ferramentas.
Como a agência autoriza a conexão
A agência autoriza a conexão a partir do sistema do parceiro, e quem faz isso precisa ser um usuário administrador.
No sistema do parceiro, clique em Conectar com o Monde
Entre na conta da agência no Monde com um usuário administrador
Confira o nome e o CNPJ do parceiro e, se quiser, abra a Política de privacidade do parceiro
Escolha em Empresa qual empresa da agência o parceiro vai acessar
Leia a lista Este parceiro poderá, que mostra tudo o que ele vai poder fazer
Clique em Autorizar
A autorização vale só para a empresa selecionada. Para liberar o parceiro em mais de uma empresa, repita o processo uma vez para cada uma.
Onde a agência vê e remove a conexão
No Monde Web, acesse Cadastros > Integrações: a conexão aparece na lista com o tipo Conexão automática, o nome da empresa e a situação Ativa.
Nessa lista, o administrador da agência pode:
Abrir a conexão e ver o parceiro, a empresa e as permissões concedidas;
Renomear a conexão, no campo Nome da integração, o que ajuda quando o mesmo parceiro tem mais de uma integração na mesma empresa;
Excluir a conexão.
Ao excluir, o parceiro perde o acesso na hora e a conexão fica na lista com a situação Excluída. O que ele já cadastrou não é afetado. Não há como reativar a conexão excluída: para religar, a agência autoriza de novo pelo sistema do parceiro.
Mensagens de erro conhecidas
As mensagens abaixo aparecem para a agência ao clicar em Conectar com o Monde no sistema do parceiro, ou na tela de autorização que abre em seguida.
A conexão automática deste parceiro ainda não está habilitada
Causa: o parceiro ainda não informou a Política de privacidade ou a URL de retorno na área dele.
Como resolver: avise o parceiro, que completa os dados em https://web.monde.com.br/partners/integration. A agência não tem como liberar isso.
Apenas administradores da agência podem autorizar parceiros a acessar a API
Causa: o usuário que entrou no Monde não é administrador.
Como resolver: peça a um administrador da agência que faça a autorização, ou ajuste o usuário em Como configurar Permissões de Acesso.
Esta empresa não tem licença da API Monde, e este parceiro pede recursos que exigem a licença
Causa: o parceiro recebeu permissões fora de vendas, e a empresa escolhida não tem licença de API ativa.
Como resolver: escolha outra empresa da agência que tenha a licença, ou fale com o time Comercial do Monde para contratá-la.
Validação e próximos passos
Para garantir que a conexão automática foi concluída, confira os dois lados.
O parceiro entra em https://web.monde.com.br/partners/integration e verifica se a situação aparece como Conexão habilitada;
A agência acessa, no Monde Web, Cadastros > Integrações e verifica se a conexão aparece com o tipo Conexão automática, a empresa certa e a situação Ativa.
A partir daí, os registros criados pelo parceiro entram no Monde da agência sozinhos. As integrações em que a agência informa usuário e senha do fornecedor são outro caminho, descrito em Como cadastrar, editar, desativar ou excluir integrações com fornecedores.