Skip to main content
API v2 Em cinco minutos você gera o token da v2, faz a primeira chamada e vê os produtos do seu catálogo em JSON.

Pré-requisitos

  • Conta no SULTS com permissão de administrador, necessária para gerar o token.
  • Um terminal com curl, ou o seu editor com a linguagem de preferência.

Passo 1: gere o token da v2

Na plataforma, vá em Segurança > API > Gestão de Tokens v2 e crie um token.
O token da v2 é exibido uma única vez, na criação. Copie na hora e guarde em local seguro. Um token da gestão v1 recebe 401 nos endpoints desta versão.
O passo a passo com prints está em Crie seu token. GET /api/v2/compras/product/list devolve os produtos cadastrados. É uma chamada leve e sem efeito colateral. Troque SEU_TOKEN pelo token que você acabou de gerar.
O token vai puro no header. Não escreva Bearer antes dele.

Passo 3: confira a resposta

Você deve receber 200 e um array com os produtos do seu catálogo:
Se apareceu o name de pelo menos um produto seu, a integração está autenticada e funcionando. Repare que a v2 devolve um array direto, sem envelope. Quem vem da v1 costuma tropeçar aqui, porque lá a listagem vem dentro de data.

Se algo der errado

A causa mais comum de falha na primeira chamada é o token. Confira, nesta ordem:
  1. O token foi copiado por inteiro, sem espaço sobrando.
  2. O header tem o nome exato Authorization.
  3. O valor não tem o prefixo Bearer.
  4. O token nasceu na Gestão de Tokens v2, não na v1.
Persistindo a falha, o corpo da resposta traz a mensagem. O catálogo completo está em Erros.

Próximos passos

Convenções

Paginação por page, datas e o formato das listagens.

Mantenha os dados atualizados

O padrão de polling para manter o seu ERP atualizado.

Referência da API

Os 45 endpoints da v2, com playground.