Obter as credenciais do ERP

Este tutorial mostra onde gerar, em cada sistema de gestão (ERP), as credenciais usadas para cadastrar a integração no painel. Com os dados em mãos, siga o tutorial Configurar integrações com ERP para cadastrar e testar.

Iniciante

6 min de leitura

Nesta página

Este tutorial mostra onde gerar, em cada sistema de gestão (ERP), as credenciais usadas para cadastrar a integração no painel. Com os dados em mãos, siga o tutorial Configurar integrações com ERP para cadastrar e testar.

Crie credenciais exclusivas para a Azos. Em caso de dúvidas, entre em contato com o suporte.

SistemaO que você vai obter
IXCToken (ID do usuário + token)
SGPApp, Token e URL
AtlazToken de integração
GesprovUsuário, senha e URL
HubsoftHost, Client ID, Client Secret, e-mail e senha
MKAuthClient ID, Client Secret e URL
TopSappUsuário, senha, identificador do sistema e URL
VoalleClient ID, Client Secret, Syndata e URL
LH ProvedorToken de parceiro e URL
BeeswebE-mail e senha (ou token de API)
PipesoftClient ID, Client Secret e URL
RBXSoftChave de integração e URL

IXC

1. Vá em Configurações do sistema › Usuários e clique em Novo.

Novo usuário no IXC
Novo usuário no IXC

2. Clique em algum usuário administrador.

3. Ative Permite acesso ao webservice.

Permite acesso ao webservice
Permite acesso ao webservice

4. Salve. O token é gerado automaticamente em Token de acesso.

Token gerado
Token gerado

5. No campo Token do painel, cole o ID do usuário e o token separados por dois-pontos, sem espaço. Exemplo: se o usuário é o 185, cole 185:a1b2c3d4e5f6....

SGP

1. Acesse Administração › Integrações › Tokens.

Menu Tokens no SGP
Menu Tokens no SGP

2. Clique em Adicionar token, no canto superior direito:

  • em Descrição, digite Azos;
  • em Aplicações, clique no + e digite Azos nos dois campos.
Adicionar token
Adicionar token

3. Salve. O token é gerado na lista.

Token gerado
Token gerado

Os dados para o painel são:

CampoValor
Apptelia
TokenA chave gerada.
URLO endereço do SGP no navegador (ex.: https://seusgp.com.br).

Atlaz

  1. Acesse o painel do Atlaz como administrador.
  2. Vá em Configurações › API / Integrações.
  3. Gere ou copie o Token de integração.

Gesprov

  1. Acesse o Gesprov com o login de administrador.
  2. Crie um usuário exclusivo para a integração com a Azos.
  3. Anote o usuário e a senha criados.
  4. A URL é o endereço do seu Gesprov (ex.: https://seugesprov.com.br).

Hubsoft

1. Acesse o Hubsoft como administrador e vá em Configuração › Geral › Usuário.

Usuário no Hubsoft
Usuário no Hubsoft

2. Clique no + e crie um usuário exclusivo para a Azos. Depois de salvar, localize o usuário na lista e clique em AÇÕES.

Lista de usuários
Lista de usuários

3. No menu que abrir, clique em Editar.

Editar usuário
Editar usuário

4. Na aba API, ative Permite acesso à API de Integração e Permite acesso à API GraphQL. Logo abaixo aparecem as credenciais:

  • HOST: a URL base do sistema;
  • CLIENT ID;
  • CLIENT SECRET.
Credenciais da API
Credenciais da API

5. Na aba Permissões, marque todas as permissões e salve.

Permissões do usuário
Permissões do usuário

O e-mail e a senha desse usuário vão nos campos E-mail do usuário e Senha do cadastro.

MKAuth

  1. Acesse o painel do MKAuth como administrador.
  2. Vá em Configurações › API.
  3. Crie um novo Client, de preferência exclusivo para a Azos.
  4. Copie o Client ID e o Client Secret gerados.
  5. A URL é o endereço do seu MKAuth (ex.: https://seumkauth.com.br).

TopSapp

  1. Acesse o TopSapp como administrador.
  2. Crie um usuário exclusivo para a integração com a Azos.
  3. Anote o usuário, a senha e o identificador do sistema.
  4. A URL é o endereço do seu TopSapp (ex.: https://seutopsapp.com.br).

Voalle

A API do Voalle (APIs para Terceiros) só aceita um usuário integrador: um usuário que não entra na interface do ERP, só na API.

  1. No Voalle, acesse Configurações › Usuários e cadastre um novo usuário, exclusivo para a Azos.
  2. Marque a opção Usuário integrador e salve. Sem essa opção, a autenticação retorna Não autorizado.
  3. Depois de salvar, o Voalle gera o Client ID e o Client Secret desse usuário. Copie os dois.
  4. Peça ao suporte do Voalle o Syndata do seu ambiente: é a chave que identifica para qual ambiente a requisição vai.

Os dados para o painel são:

CampoValor
URL do ERPO endereço do seu Voalle (ex.: https://erp.seuprovedor.com.br).
Client IDO Client ID do usuário integrador.
Client SecretO Client Secret do usuário integrador.
SyndataA chave do ambiente informada pelo suporte do Voalle.

A Azos usa as portas 45700 (autenticação) e 45715 (API) desse mesmo endereço. Se houver firewall, elas precisam estar liberadas.

Todas as ações feitas pela API ficam registradas no log do Voalle em nome desse usuário; por isso, use um usuário só para a Azos.

LH Provedor

O LH Provedor não publica documentação aberta da API. A integração usa a API de Parceiros do LH Provedor, autenticada por um token de parceiro.

  1. Peça ao suporte do LH Provedor um token de acesso à API de Parceiros para a Azos.
  2. Confirme com o suporte o endereço do seu sistema. A Azos acessa as rotas em <URL do sistema>/api-parceiros.

Os dados para o painel são:

CampoValor
URL do ERPO endereço do seu LH Provedor, sem /api-parceiros no final.
Token de APIO token de parceiro fornecido pelo LH Provedor.

Beesweb

A Beesweb autentica com o e-mail e a senha de um usuário da administração.

  1. Acesse a Beesweb como administrador e cadastre um usuário exclusivo para a Azos, com acesso à administração.
  2. Anote o e-mail e a senha desse usuário.
  3. Se a Beesweb já tiver fornecido um token de API (api_token), ele pode ser usado no lugar do e-mail e da senha. Dúvidas sobre o acesso à API: suporte da Beesweb, contato@beesweb.com.br.

Os dados para o painel são:

CampoValor
URL do ERPhttps://api.beesweb.com.br (padrão).
E-mailO e-mail do usuário criado.
SenhaA senha do usuário criado.
Token de API (opcional)O api_token, se tiver. Preencha e-mail e senha ou o token.

Pipesoft

O Pipesoft não publica a documentação da API; as credenciais são fornecidas pelo próprio Pipesoft.

  1. Peça ao suporte do Pipesoft as credenciais da API REST para a Azos: um Client ID (começa com Client_Id_) e um Client Secret (começa com Client_Secret_).
  2. Confirme o endereço do servidor Pipesoft do provedor (ex.: http://10.0.0.5). Ele precisa ser acessível pela internet.

Os dados para o painel são:

CampoValor
URL do ERPO endereço do servidor Pipesoft, sem /api no final (a Azos acrescenta).
Client IDO Client_Id_... fornecido.
Client SecretO Client_Secret_... fornecido.

RBXSoft

O RBX ISP (RouterBox) usa uma chave de integração para os Web Services.

  1. No RBX ISP, acesse Empresa › Parâmetros › Web Services.
  2. Cadastre uma chave de integração para a Azos (ou copie a existente) e salve.
  3. Copie a chave de integração.

Os dados para o painel são:

CampoValor
URL do ERPO endereço do seu RBX ISP (ex.: https://rbx.seudominio.com.br), sem /routerbox no final.
Chave de integraçãoA chave cadastrada em Web Services.

Os Web Services do RBX só funcionam com HTTPS. Mais detalhes na documentação de Web Services da RBXSoft.

Compartilhe este tutorial

Continue lendo

Selecionados a partir dos assuntos deste tutorial.

Todos os tutoriais