Grade (eixos e sugestão)

Base: https://api.nivesistemas.com.br · 4 endpoints

GET /grid-catalog/seed/profiles

Ramos disponíveis para sugestão de grade

Resposta: { profiles: [{ id, label }], suggested }

curl -X GET "https://api.nivesistemas.com.br/grid-catalog/seed/profiles" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

const res = await fetch("https://api.nivesistemas.com.br/grid-catalog/seed/profiles", {
  method: "GET",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
  },
});
const data = await res.json();

import requests

res = requests.request(
    "GET",
    "https://api.nivesistemas.com.br/grid-catalog/seed/profiles",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

POST /grid-catalog/seed/suggest

Sugerir rótulos e valores de divisão/subdivisão (catálogo do ramo + IA)

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`profile`	string	não	Ramo; padrão vem do CNAE da loja
`businessDescription`	string	não	Tipo de negócio em texto livre (até 500 caracteres)
`useAi`	boolean	não	false devolve só o catálogo do ramo

Resposta: { divisionAxisLabel, subdivisionAxisLabel, divisions, subdivisions, aiUsed, aiError }

curl -X POST "https://api.nivesistemas.com.br/grid-catalog/seed/suggest" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"profile":"","businessDescription":"","useAi":true}'

const res = await fetch("https://api.nivesistemas.com.br/grid-catalog/seed/suggest", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "profile": "",
    "businessDescription": "",
    "useAi": true
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/grid-catalog/seed/suggest",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "profile": "",
      "businessDescription": "",
      "useAi": True
    },
)
print(res.json())

POST /grid-catalog/seed/apply

Gravar rótulos da loja e cadastrar os valores escolhidos

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`divisionAxisLabel`	string	sim	Nome do eixo principal
`subdivisionAxisLabel`	string	sim	Nome do eixo secundário
`divisions`	string[]	não	Valores da divisão
`subdivisions`	string[]	não	Valores da subdivisão

curl -X POST "https://api.nivesistemas.com.br/grid-catalog/seed/apply" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"divisionAxisLabel":"","subdivisionAxisLabel":"","divisions":null,"subdivisions":null}'

const res = await fetch("https://api.nivesistemas.com.br/grid-catalog/seed/apply", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "divisionAxisLabel": "",
    "subdivisionAxisLabel": "",
    "divisions": null,
    "subdivisions": null
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/grid-catalog/seed/apply",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "divisionAxisLabel": "",
      "subdivisionAxisLabel": "",
      "divisions": None,
      "subdivisions": None
    },
)
print(res.json())

PUT /grid-catalog/axis-labels

Atualizar só os nomes dos eixos (padrão legado: Tamanho e Cor)

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`divisionAxisLabel`	string	sim	Nome do eixo principal
`subdivisionAxisLabel`	string	sim	Nome do eixo secundário

curl -X PUT "https://api.nivesistemas.com.br/grid-catalog/axis-labels" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"divisionAxisLabel":"","subdivisionAxisLabel":""}'

const res = await fetch("https://api.nivesistemas.com.br/grid-catalog/axis-labels", {
  method: "PUT",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "divisionAxisLabel": "",
    "subdivisionAxisLabel": ""
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "PUT",
    "https://api.nivesistemas.com.br/grid-catalog/axis-labels",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "divisionAxisLabel": "",
      "subdivisionAxisLabel": ""
    },
)
print(res.json())