Ativos / equipamentos

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

GET /service-assets

Listar ativo de serviço

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

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

POST /service-assets

Criar ativo de serviço

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`customerId`	uuid	sim	Cliente
`name`	string	sim	Nome do equipamento
`serialNumber`	string	não	Número de série
`model`	string	não	Modelo
`brand`	string	não	Marca
`addressLine`	string	não	Endereço de instalação
`city`	string	não	Cidade
`state`	string	não	UF
`notes`	string	não	Observações
`active`	boolean	não	Ativo

Resposta: 201 Created

curl -X POST "https://api.nivesistemas.com.br/service-assets" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"00000000-0000-0000-0000-000000000000","name":"Exemplo","serialNumber":"","model":"","brand":"","addressLine":"","city":"","state":"","notes":"","active":true}'

const res = await fetch("https://api.nivesistemas.com.br/service-assets", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "customerId": "00000000-0000-0000-0000-000000000000",
    "name": "Exemplo",
    "serialNumber": "",
    "model": "",
    "brand": "",
    "addressLine": "",
    "city": "",
    "state": "",
    "notes": "",
    "active": true
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/service-assets",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "customerId": "00000000-0000-0000-0000-000000000000",
      "name": "Exemplo",
      "serialNumber": "",
      "model": "",
      "brand": "",
      "addressLine": "",
      "city": "",
      "state": "",
      "notes": "",
      "active": True
    },
)
print(res.json())

PATCH /service-assets/:id

Atualizar ativo de serviço

Parâmetros de rota: id

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`customerId`	uuid	sim	Cliente
`name`	string	sim	Nome do equipamento
`serialNumber`	string	não	Número de série
`model`	string	não	Modelo
`brand`	string	não	Marca
`addressLine`	string	não	Endereço de instalação
`city`	string	não	Cidade
`state`	string	não	UF
`notes`	string	não	Observações
`active`	boolean	não	Ativo

curl -X PATCH "https://api.nivesistemas.com.br/service-assets/{id}" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"00000000-0000-0000-0000-000000000000","name":"Exemplo","serialNumber":"","model":"","brand":"","addressLine":"","city":"","state":"","notes":"","active":true}'

const res = await fetch("https://api.nivesistemas.com.br/service-assets/{id}", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "customerId": "00000000-0000-0000-0000-000000000000",
    "name": "Exemplo",
    "serialNumber": "",
    "model": "",
    "brand": "",
    "addressLine": "",
    "city": "",
    "state": "",
    "notes": "",
    "active": true
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "PATCH",
    "https://api.nivesistemas.com.br/service-assets/{id}",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "customerId": "00000000-0000-0000-0000-000000000000",
      "name": "Exemplo",
      "serialNumber": "",
      "model": "",
      "brand": "",
      "addressLine": "",
      "city": "",
      "state": "",
      "notes": "",
      "active": True
    },
)
print(res.json())

DELETE /service-assets/:id

Excluir ativo de serviço

Parâmetros de rota: id

Resposta: 204 No Content

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

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

GET /service-assets/:id

Detalhe do ativo

Parâmetros de rota: id

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

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

GET /service-assets/qr/:token

Consultar ativo pelo token do QR

Parâmetros de rota: token

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

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

GET /service-assets/:id/orders

Ordens de serviço do equipamento/veículo

Parâmetros de rota: id

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

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

PUT /service-assets/:id

Atualizar equipamento/veículo (alias do PATCH)

Parâmetros de rota: id

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

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

import requests

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