GTINs

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

GET /gtins

Listar GTINs

Query params

Campo	Tipo	Obrigatório	Descrição
q	string	não	Busca
page	integer	não	Página
pageSize	integer	não	Itens por página

curl

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

JavaScript

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

Python

import requests

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

GET /gtins/lookup/:gtin

Buscar produto/variante por GTIN

Parâmetros de rota: gtin

curl

curl -X GET "https://api.nivesistemas.com.br/gtins/lookup/{gtin}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

JavaScript

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

Python

import requests

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

GET /gtins/by-product/:productId

GTINs de um produto

Parâmetros de rota: productId

curl

curl -X GET "https://api.nivesistemas.com.br/gtins/by-product/{productId}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

JavaScript

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

Python

import requests

res = requests.request(
    "GET",
    "https://api.nivesistemas.com.br/gtins/by-product/{productId}",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

PATCH /gtins/:variantId

Alterar GTIN de uma variante

Parâmetros de rota: variantId

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
gtin	string	sim	Novo GTIN

curl

curl -X PATCH "https://api.nivesistemas.com.br/gtins/{variantId}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"gtin":""}'

JavaScript

const res = await fetch("https://api.nivesistemas.com.br/gtins/{variantId}", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "gtin": ""
  }),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "PATCH",
    "https://api.nivesistemas.com.br/gtins/{variantId}",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "gtin": ""
    },
)
print(res.json())

POST /gtins/bulk

Atualizar GTINs em lote

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
updates	array	sim	Lista [{ variantId, gtin }]

curl

curl -X POST "https://api.nivesistemas.com.br/gtins/bulk" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"updates":[]}'

JavaScript

const res = await fetch("https://api.nivesistemas.com.br/gtins/bulk", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "updates": []
  }),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/gtins/bulk",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "updates": []
    },
)
print(res.json())