Serviços (configuração)

Liga/desliga o módulo de serviços e os submódulos (campo, projetos, NFS-e, etc.).

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

GET /service-settings

Obter configurações de serviços

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

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

PUT /service-settings

Atualizar configurações de serviços

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`servicesEnabled`	boolean	não	Liga o módulo de serviços na loja
`useProjects`	boolean	não	Projetos
`useContracts`	boolean	não	Contratos
`useSubscriptions`	boolean	não	Assinaturas
`useTimeTracking`	boolean	não	Apontamento de horas
`useFieldService`	boolean	não	Atendimento em campo
`autoGenerateReceivable`	boolean	não	Gerar conta a receber ao concluir a OS. Se a OS for faturada no PDV depois, recebíveis abertos da OS são cancelados na finalização da venda.
`autoGenerateNfse`	boolean	não	Emitir NFS-e ao concluir a OS. Preferível faturar pelo PDV (to-sale + nfseIntent na finalize); se a nota já existir na OS, o finalize da venda não reemite.
`nfseEnvironment`	string	não	HOMOLOG \| PROD
`nfseSeries`	string	não	Série numérica da NFS-e

curl -X PUT "https://api.nivesistemas.com.br/service-settings" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"servicesEnabled":true,"useProjects":true,"useContracts":true,"useSubscriptions":true,"useTimeTracking":true,"useFieldService":true,"autoGenerateReceivable":true,"autoGenerateNfse":true,"nfseEnvironment":"","nfseSeries":""}'

const res = await fetch("https://api.nivesistemas.com.br/service-settings", {
  method: "PUT",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "servicesEnabled": true,
    "useProjects": true,
    "useContracts": true,
    "useSubscriptions": true,
    "useTimeTracking": true,
    "useFieldService": true,
    "autoGenerateReceivable": true,
    "autoGenerateNfse": true,
    "nfseEnvironment": "",
    "nfseSeries": ""
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "PUT",
    "https://api.nivesistemas.com.br/service-settings",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "servicesEnabled": True,
      "useProjects": True,
      "useContracts": True,
      "useSubscriptions": True,
      "useTimeTracking": True,
      "useFieldService": True,
      "autoGenerateReceivable": True,
      "autoGenerateNfse": True,
      "nfseEnvironment": "",
      "nfseSeries": ""
    },
)
print(res.json())

POST /service-settings/apply-aesthetic-clinic-preset

Aplicar modelo pronto para clínica de estética

curl -X POST "https://api.nivesistemas.com.br/service-settings/apply-aesthetic-clinic-preset" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

const res = await fetch("https://api.nivesistemas.com.br/service-settings/apply-aesthetic-clinic-preset", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
  },
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/service-settings/apply-aesthetic-clinic-preset",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

POST /service-settings/apply-mechanic-workshop-preset

Aplicar modelo pronto para oficina mecânica

curl -X POST "https://api.nivesistemas.com.br/service-settings/apply-mechanic-workshop-preset" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo"

const res = await fetch("https://api.nivesistemas.com.br/service-settings/apply-mechanic-workshop-preset", {
  method: "POST",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
  },
});
const data = await res.json();

import requests

res = requests.request(
    "POST",
    "https://api.nivesistemas.com.br/service-settings/apply-mechanic-workshop-preset",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
)
print(res.json())

GET /service-settings/assignable-users

Usuários que podem receber visita, OS ou recorrência (só dados básicos, sem exigir permissão de usuários)

Resposta: Lista ordenada por nome de { id, name, username, agendaColor, active }. O usuário de suporte da plataforma não aparece.

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

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