Início rápido

Antes de integrar com a Mercos, é necessário utilizar nosso ambiente exclusivo para testes: o sandbox. Nele, você pode simular requisições e validar o funcionamento da integração.

Para acessá-lo, crie uma conta clicando aqui .

O acesso ao sandbox tem validade limitada. Se expirar, basta solicitar uma renovação pelo chat da plataforma.

Exemplo de Requisição de Teste

Abaixo, um exemplo de requisição à API usando a entidade de status. Esse comando simula uma conexão com nosso servidor no ambiente de testes:

curl \
  -H 'Content-Type: application/json' \
  -H "ApplicationToken: {{ApplicationToken}}" \
  -H "CompanyToken: {{CompanyToken}}" \
  -X GET \
  https://sandbox.mercos.com/api/v1/token_auth_status

Entendendo os tokens:

💡
Após enviar sua primeira requisição com os tokens, sua aplicação estará conectada à empresa correspondente.

ApplicationToken
- Identifica sua aplicação (por exemplo, seu ERP).
- No sandbox, utilize o token de teste: d39001ac-0b14-11f0-8ed7-6e1485be00f2
CompanyToken
- Representa o cliente da sua aplicação (ex: sua empresa).
- Para encontrá-lo: Acesse Minha Conta > Sistema > Integração e clique em Gerar ou copiar o Company Token.

✅
Próximo passo: Após validar sua integração no sandbox, entre em contato pelo chat da plataforma para darmos início ao processo de homologação 🔗 e liberação do ambiente de produção.

Segurança dos Tokens 🔐

Os tokens utilizados na integração (como Application Token e Company Token) são credenciais sensíveis que garantem o acesso à sua conta e dados da empresa.

Nunca compartilhe esses tokens publicamente ou com pessoas não autorizadas. Eles devem ser armazenados de forma segura e utilizados apenas dentro da sua aplicação, com os devidos controles de acesso.

💡
Recomendamos ocultar esses valores em logs, interfaces e prints de tela.