Início rápido

Antes de começar

A API REST do Sistema Loja permite ler e gravar dados da loja (produtos, clientes, vendas, fiscal e mais) a partir de outro sistema.

Você precisa de:

1. Uma loja ativa no Sistema Loja
2. Plano Expansão ou Rede (entitlement de acesso à API)
3. Um usuário com permissão para criar chaves
4. O slug da loja (ex.: loja-demo) — aparece na URL de acesso ao ERP (?loja=) e no header X-Store-Slug

1. Gerar a chave de API

No ERP (https://erp.nivesistemas.com.br), abra Sistema → Integração API. Crie uma chave e escolha o escopo; o valor completo (sl_live_...) é mostrado apenas uma vez. Guarde-o em um cofre de segredos.

O escopo padrão, Vendas, estoque e cadastros, cobre a maioria das integrações de e-commerce e automação. Para painéis e relatórios use Somente leitura. Veja os escopos no guia de autenticação.

2. URL base canônica

Em produção, todas as rotas usam o host do ERP:

https://api.nivesistemas.com.br

Exemplo: https://api.nivesistemas.com.br/products

Não use o site institucional (nivesistemas.com.br). A loja não é escolhida pelo domínio — você identifica a loja com X-Store-Slug (ou ?loja=) em cada requisição.

3. Primeira requisição

Liste produtos com curl (valores fictícios — troque pela sua chave e slug):

curl -X GET "https://api.nivesistemas.com.br/products" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Accept: application/json"

Com fetch (JavaScript):

const res = await fetch("https://api.nivesistemas.com.br/products", {
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    Accept: "application/json",
  },
});
const products = await res.json();

Com Python:

import requests

r = requests.get(
    "https://api.nivesistemas.com.br/products",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
        "Accept": "application/json",
    },
)
r.raise_for_status()
print(r.json())

4. Próximos passos

• Leia o guia de autenticação
• Consulte erros e limites
• Explore a referência completa