Fornecedores

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

GET /suppliers

Listar fornecedores

Query params

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

curl

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

JavaScript

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

GET /suppliers/:id

Detalhe do fornecedor

Parâmetros de rota: id

curl

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

JavaScript

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

POST /suppliers

Criar fornecedor

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
name	string	sim	Razão social / nome
taxId	string	não	CNPJ
email	string	não	E-mail
phone	string	não	Telefone

curl

curl -X POST "https://api.nivesistemas.com.br/suppliers" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"name":"Exemplo","taxId":"","email":"","phone":""}'

JavaScript

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

Python

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/suppliers",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "name": "Exemplo",
      "taxId": "",
      "email": "",
      "phone": ""
    },
)
print(res.json())

PATCH /suppliers/:id

Atualizar fornecedor

Parâmetros de rota: id

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
name	string	não	Campos do POST

curl

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

JavaScript

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

Python

import requests

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

DELETE /suppliers/:id

Excluir fornecedor

Parâmetros de rota: id

Resposta: 204 No Content

curl

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

JavaScript

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

Python

import requests

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

PUT /suppliers/:id/default-brand

Definir ou remover a marca padrão do fornecedor, sem alterar o resto do cadastro

Parâmetros de rota: id

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
brandId	string	sim	Marca padrão; null desvincula

Resposta: O fornecedor atualizado. 404 se o fornecedor não existe; 400 se a marca não existe.

curl

curl -X PUT "https://api.nivesistemas.com.br/suppliers/{id}/default-brand" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"brandId":""}'

JavaScript

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

Python

import requests

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