Neste artigo, você vai aprender a cadastrar uma integração com fornecedor, alterar as credenciais e a URL dela, desativá-la ou excluí-la, e manter os vínculos de produtos adicionais e de pessoas da integração.

As integrações com fornecedores permitem importar vendas, reservas ou informações disponibilizadas por fornecedores diretamente para o Monde.

Cada fornecedor pode ter um processo próprio de configuração. Por isso, os dados necessários para habilitar a integração podem variar conforme o fornecedor.

No Monde Web, acesse Cadastros > Integrações. No Monde Desktop, o menu Cadastros > Integrações abre essa mesma tela no navegador.

Ao acessar a tela Integrações, no Monde Web em Cadastros > Integrações, o sistema exibe a listagem das integrações cadastradas.

Por padrão, a tela pode exibir apenas integrações ativas.

A listagem pode ser filtrada por:

Se uma integração foi desativada, altere o filtro Ativa para Não para localizá-la.

Para cadastrar uma nova integração:

Após salvar, o sistema exibirá a mensagem de confirmação.

Para conferir que deu certo: no Monde Web, em Cadastros > Integrações, pesquise a integração pelo campo Buscar e veja se ela aparece na listagem.

Os dados de acesso da integração devem ser obtidos com o próprio fornecedor.

Em alguns casos, a agência pode precisar cadastrar mais de uma integração para o mesmo fornecedor.

Isso pode acontecer, por exemplo, quando o fornecedor disponibiliza credenciais diferentes para tipos de venda diferentes.

Se o fornecedor envia um usuário e senha para vendas faturadas e outro para vendas não faturadas, cadastre duas integrações separadas.

No campo Descrição, use nomes que ajudem a diferenciar cada uma:

Essa identificação facilita a consulta, a manutenção e a conferência das integrações cadastradas.

Se o fornecedor alterar o usuário ou a senha da integração, atualize esses dados no Monde.

A URL Webservice é o endereço eletrônico usado para manter a comunicação entre o Monde e o fornecedor. É por meio dessa comunicação que o sistema consegue importar as informações disponibilizadas pelo fornecedor.

Quando o fornecedor atualizar a URL da integração, será necessário alterar essa informação no Monde.

A nova URL deve ser informada pelo fornecedor.

Se você não localizar o campo URL Webservice ou tiver dúvida sobre qual informação preencher, entre em contato com o Suporte Monde.

Use a desativação quando a integração não deve mais ser usada no momento, mas o cadastro ainda pode ser mantido para consulta ou uso futuro.

Depois disso, a integração ficará inativa.

Para localizá-la novamente, use o filtro Ativa = Não.

Use a exclusão quando a integração não será mais utilizada e não precisa permanecer cadastrada no sistema.

Antes de excluir, confirme se a integração realmente não será mais utilizada.

Quando houver dúvida, prefira desativar a integração em vez de excluir.

Na tela da integração, que abre no Monde Web em Cadastros > Integrações, há a aba Vínculos de produtos adicionais, que guarda o pareamento entre os itens que o fornecedor devolve e os produtos do Monde.

É por ela que a importação reconhece sozinha um adicional já conhecido — pacote de bebidas, internet, bagagem extra — e o traz para a venda como produto próprio, em vez de somá-lo às taxas do produto principal. Um item ainda sem vínculo pode ser pareado na hora da importação, e o vínculo passa a valer nas próximas importações daquela integração.

O pareamento segue duas regras:

Na mesma tela da integração, a aba Vínculos de pessoas guarda o pareamento entre cada código que a integração devolve e uma pessoa já cadastrada no Monde. Como nos produtos adicionais, cada integração tem os seus vínculos de pessoas.

Nas abas Vínculos de produtos adicionais e Vínculos de pessoas, os vínculos da integração aparecem em uma lista com estas colunas:

A lista abre ordenada por Código no fornecedor. Clique no título de uma coluna para ordenar por ela, e use o botão Colunas, acima da lista, para escolher as colunas que aparecem. Quando a integração já tem vínculos, o campo de busca acima da lista procura pelo código, pela descrição ou pelo produto, na aba de produtos, e pelo código ou pela pessoa, na aba de pessoas.

Para editar um vínculo de produto adicional ou de pessoa:

Verifique se aparece a mensagem Vínculo atualizado com sucesso. e se a linha mostra o dado novo.

Na tela Integrações, no Monde Web em Cadastros > Integrações, podem aparecer dois tipos de cadastro:

Para importar vendas ou informações de fornecedores, utilize o tipo Integração com Fornecedor.

A API Monde é outro tipo de integração, voltado para uso de credenciais de acesso por sistemas externos. Ela pode ser usada por toda empresa com licença ativa do Monde, sem licença à parte.