Tabela IBPT

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

GET /ibpt

Listar entradas IBPT

Query params

Campo	Tipo	Obrigatório	Descrição
`q`	string	não	Busca por NCM

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

const res = await fetch("https://api.nivesistemas.com.br/ibpt", {
  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/ibpt",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

POST /ibpt

Criar entrada IBPT

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`ncm`	string	sim	NCM
`description`	string	não	Descrição
`federal`	number	não	Alíquota federal %
`state`	number	não	Alíquota estadual %

curl -X POST "https://api.nivesistemas.com.br/ibpt" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"ncm":"","description":"","federal":0,"state":0}'

const res = await fetch("https://api.nivesistemas.com.br/ibpt", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "ncm": "",
    "description": "",
    "federal": 0,
    "state": 0
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/ibpt",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "ncm": "",
      "description": "",
      "federal": 0,
      "state": 0
    },
)
print(res.json())

PATCH /ibpt/:id

Atualizar entrada

Parâmetros de rota: id

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`federal`	number	não	Alíquotas

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

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

import requests

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

DELETE /ibpt/:id

Excluir entrada

Parâmetros de rota: id

Resposta: 204 No Content

curl -X DELETE "https://api.nivesistemas.com.br/ibpt/{id}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

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

import requests

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

POST /ibpt/import

Importar tabela IBPT (CSV)

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`csv`	string	sim	Conteúdo CSV

curl -X POST "https://api.nivesistemas.com.br/ibpt/import" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"csv":""}'

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

import requests

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

POST /ibpt/import-official

Enfileirar importação da tabela IBPT oficial

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`uf`	string	não	UF (opcional; padrão: UF da loja)

Resposta: 202 — job enfileirado (status PENDING). Acompanhe em GET /ibpt/import-jobs

curl -X POST "https://api.nivesistemas.com.br/ibpt/import-official" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"uf":""}'

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

import requests

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

GET /ibpt/import-jobs

Listar jobs de importação IBPT da loja

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

const res = await fetch("https://api.nivesistemas.com.br/ibpt/import-jobs", {
  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/ibpt/import-jobs",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

GET /ibpt/import-jobs/:id

Detalhe de um job de importação IBPT

Parâmetros de rota: id

curl -X GET "https://api.nivesistemas.com.br/ibpt/import-jobs/{id}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

const res = await fetch("https://api.nivesistemas.com.br/ibpt/import-jobs/{id}", {
  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/ibpt/import-jobs/{id}",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

DELETE /ibpt/import-jobs/failed

Remover todas as importações IBPT com falha

Resposta: 200 — { deleted: number }

curl -X DELETE "https://api.nivesistemas.com.br/ibpt/import-jobs/failed" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

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

import requests

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

DELETE /ibpt/import-jobs/:id

Remover uma importação IBPT com falha

Parâmetros de rota: id

Resposta: 204 — só jobs com status FAILED

curl -X DELETE "https://api.nivesistemas.com.br/ibpt/import-jobs/{id}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

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

import requests

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