Configurações do PDV

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

GET /pos-settings

Obter configurações da tela de vendas

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

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

PATCH /pos-settings

Atualizar configurações da tela de vendas

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`requireSellerForPos`	boolean	não	Exigir vendedor no PDV
`posDefaultSellerIds`	array	não	IDs dos vendedores padrão (máx. 10)
`allowNegativeStock`	boolean	não	Permitir estoque negativo
`posAllowServices`	boolean	não	Permitir serviços no PDV
`posAllowShippingAmount`	boolean	não	Permitir valor de frete
`posAllowSaleCarrier`	boolean	não	Exibir transportadora na venda e incluir na NF-e 55 (padrão desligado)
`posShowManagementIndicators`	boolean	não	Indicadores gerenciais
`posShowProductCode`	boolean	não	Exibir código interno no PDV, cadastro e demais telas; no PDV também busca por ele (padrão desligado)
`posShowCommissionOnFinalize`	boolean	não	Mostrar comissão na finalização
`posFinalizeAsModal`	boolean	não	Finalizar venda em modal central
`posLayout`	string	não	Layout do PDV: STACKED ou SPLIT
`posInstagramSearchEnabled`	boolean	não	Busca por Instagram
`posAutoPrintReceipt`	boolean	não	Imprimir cupom não fiscal automaticamente ao finalizar a venda
`posPrintOrderPdf`	boolean	não	Gerar PDF A4 do pedido ao finalizar venda sem documento fiscal
`posPrefillPaymentAmount`	boolean	não	Pré-preencher o valor recebido ao escolher a forma de pagamento (padrão: true)
`creditPricingEnabled`	boolean	não	Preço a prazo
`requireCashSessionForPos`	boolean	não	Exigir sessão de caixa
`birthdayDiscountEnabled`	boolean	não	Desconto de aniversário
`birthdayDiscountPercent`	number	não	Percentual (0–100)

curl -X PATCH "https://api.nivesistemas.com.br/pos-settings" \
  -H "Authorization: Bearer sl_live_exemplo_abc123xyz789" \
  -H "X-Store-Slug: loja-demo" \
  -H "Content-Type: application/json" \
  -d '{"requireSellerForPos":true,"posDefaultSellerIds":[],"allowNegativeStock":true,"posAllowServices":true,"posAllowShippingAmount":true,"posAllowSaleCarrier":true,"posShowManagementIndicators":true,"posShowProductCode":true,"posShowCommissionOnFinalize":true,"posFinalizeAsModal":true,"posLayout":"","posInstagramSearchEnabled":true,"posAutoPrintReceipt":true,"posPrintOrderPdf":true,"posPrefillPaymentAmount":true,"creditPricingEnabled":true,"requireCashSessionForPos":true,"birthdayDiscountEnabled":true,"birthdayDiscountPercent":0}'

const res = await fetch("https://api.nivesistemas.com.br/pos-settings", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer sl_live_exemplo_abc123xyz789",
    "X-Store-Slug": "loja-demo",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "requireSellerForPos": true,
    "posDefaultSellerIds": [],
    "allowNegativeStock": true,
    "posAllowServices": true,
    "posAllowShippingAmount": true,
    "posAllowSaleCarrier": true,
    "posShowManagementIndicators": true,
    "posShowProductCode": true,
    "posShowCommissionOnFinalize": true,
    "posFinalizeAsModal": true,
    "posLayout": "",
    "posInstagramSearchEnabled": true,
    "posAutoPrintReceipt": true,
    "posPrintOrderPdf": true,
    "posPrefillPaymentAmount": true,
    "creditPricingEnabled": true,
    "requireCashSessionForPos": true,
    "birthdayDiscountEnabled": true,
    "birthdayDiscountPercent": 0
  }),
});
const data = await res.json();

import requests

res = requests.request(
    "PATCH",
    "https://api.nivesistemas.com.br/pos-settings",
    headers={
        "Authorization": "Bearer sl_live_exemplo_abc123xyz789",
        "X-Store-Slug": "loja-demo",
    },
    json={
      "requireSellerForPos": True,
      "posDefaultSellerIds": [],
      "allowNegativeStock": True,
      "posAllowServices": True,
      "posAllowShippingAmount": True,
      "posAllowSaleCarrier": True,
      "posShowManagementIndicators": True,
      "posShowProductCode": True,
      "posShowCommissionOnFinalize": True,
      "posFinalizeAsModal": True,
      "posLayout": "",
      "posInstagramSearchEnabled": True,
      "posAutoPrintReceipt": True,
      "posPrintOrderPdf": True,
      "posPrefillPaymentAmount": True,
      "creditPricingEnabled": True,
      "requireCashSessionForPos": True,
      "birthdayDiscountEnabled": True,
      "birthdayDiscountPercent": 0
    },
)
print(res.json())