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 passo a passo com prints está em Crie seu token.Passo 2: liste os produtos do catálogo
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.
Bearer antes dele.
Passo 3: confira a resposta
Você deve receber200 e um array com os produtos do seu catálogo:
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:- O token foi copiado por inteiro, sem espaço sobrando.
- O header tem o nome exato
Authorization. - O valor não tem o prefixo
Bearer. - O token nasceu na Gestão de Tokens v2, não na v1.
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.