Skip to content
DemanderDemanderDemander Docs
Light
English

Demander API - Products

This article is part of the REST Integration API documentation.

Documentation for consulting, inserting, updating and deleting products.

Consultation

Section titled “Consultation”

List the company’s products. Without filter, considers dataAlteracao from the last 6 months.

Rota: {host}/public/v1/produtos?pagina={pagina}&limite={limite}&filtroDataAlteracao={data}&operadorFiltro={operador}
Método: GET

Return:

{
  "produtos": [
    {
      "codigo": "PROD-001",
      "codGrupoProduto": "1",
      "codMarca": 10,
      "descricao": "Produto Teste",
      "saldoEstoque": 100,
      "unidadeVenda": "UN",
      "precoVenda": 10.5,
      "permiteDesconto": 1,
      "codTamanho": null,
      "aliquotaICMSST": null,
      "bcICMSST": null,
      "aliquotaIPI": null,
      "bcIPI": null,
      "mva": null,
      "campoLivre1": null,
      "campoLivre2": null,
      "campoLivre3": null,
      "ativo": 1,
      "qtdeMinimaPorPedido": 1,
      "referencia": "REF-001",
      "controlePorLote": 0,
      "codNCM": null,
      "precoPauta": null,
      "observacao": null,
      "observacaoLojaVirtual": null,
      "dataEstoque": null,
      "segmentosRelacionados": null,
      "codProdutoPrincipal": null,
      "descProdutoPrincipal": null,
      "codSegmentoGrade": null,
      "codTipoGradeVariacao1": null,
      "codTipoGradeVariacao2": null,
      "codTipoGradeVariacao3": null,
      "codTipoGradeVariacao4": null,
      "codigoBarras": "7891234567890",
      "codigoBarrasEmbalagem": null,
      "ordemSeparacao": null,
      "qtdePorPallet": null,
      "jsonCamposAuxiliares": null,
      "dataAlteracao": "2026-07-27 14:00:00"
    }
  ]
}

Insert or update

Section titled “Insert or update”

POST upsert by key codigo.

Rota: {host}/public/v1/produtos
Método: POST
Body: json
Property Type Size Mandatory Description
code string 30 ✓ Product code. Unique identifier used to insert or update (upsert).
description string 300 ✓ Product Description.
codGrupoProduto string 30 Product group code.
codMarca int Brand code.
saldoEstoque decimal Stock balance. Default on inclusion: 0.
unidadeVenda string 5 Sales unit. Values ​​longer than 5 characters are truncated.
precoVenda decimal Sale price.
permiteDesconto int Values: 0 or 1. Default on inclusion: 1.
codTamanho string 50 Size code.
aliquotaICMSST decimal ICMS ST rate.
bcICMSST decimal ICMS ST calculation basis.
aliquotaIPI decimal IPI rate.
bcIPI decimal IPI calculation basis.
mva decimal MVA.
campoLivre1 string 500 Free field 1.
campoLivre2 string 500 Free field 2.
campoLivre3 string 5000 Free field 3.
active int Values: 0 or 1. Default on inclusion: 1.
qtdeMinimaPorPedido decimal Minimum quantity per order. Default on inclusion: 1.
reference string 50 Product reference.
controlePorLote int Values: 0 or 1. Default on inclusion: 0.
codNCM string 50 NCM code.
precoPauta decimal Standard price.
observation string 5000 Product observation.
observacaoLojaVirtual string Note for the online store.
dataEstoque date Stock date. Format Y-m-d.
segmentosRelacionados string 500 Related segments. Only updates when completed.
codProdutoPrincipal string 30 Main product code (grade).
descProdutoPrincipal string 100 Description of the main product (grid).
codSegmentoGrade string 50 Grid segment code.
codTipoGradeVariacao1 string 50 Grid variation 1 type code.
codTipoGradeVariacao2 string 50 Grid variation 2 type code.
codTipoGradeVariacao3 string 50 Grid variation 3 type code.
codTipoGradeVariacao4 string 50 Grid variation 4 type code.
codigoBarras string 20 Barcode.
codigoBarrasEmbalagem string 20 Packaging barcode.
ordemSeparacao string 50 Separation order.
qtdePorPallet decimal Quantity per pallet.
jsonCamposAuxiliares string JSON with auxiliary fields.

Body:

{
  "codigo": "PROD-001",
  "descricao": "Produto Teste",
  "codGrupoProduto": "1",
  "unidadeVenda": "UN",
  "precoVenda": 10.5,
  "saldoEstoque": 100,
  "ativo": 1,
  "permiteDesconto": 1,
  "referencia": "REF-001",
  "codigoBarras": "7891234567890"
}

Return:

{
  "codigo": "PROD-001",
  "codGrupoProduto": "1",
  "codMarca": null,
  "descricao": "Produto Teste",
  "saldoEstoque": 100,
  "unidadeVenda": "UN",
  "precoVenda": 10.5,
  "permiteDesconto": 1,
  "codTamanho": null,
  "aliquotaICMSST": null,
  "bcICMSST": null,
  "aliquotaIPI": null,
  "bcIPI": null,
  "mva": null,
  "campoLivre1": null,
  "campoLivre2": null,
  "campoLivre3": null,
  "ativo": 1,
  "qtdeMinimaPorPedido": 1,
  "referencia": "REF-001",
  "controlePorLote": 0,
  "codNCM": null,
  "precoPauta": null,
  "observacao": null,
  "observacaoLojaVirtual": null,
  "dataEstoque": null,
  "segmentosRelacionados": null,
  "codProdutoPrincipal": null,
  "descProdutoPrincipal": null,
  "codSegmentoGrade": null,
  "codTipoGradeVariacao1": null,
  "codTipoGradeVariacao2": null,
  "codTipoGradeVariacao3": null,
  "codTipoGradeVariacao4": null,
  "codigoBarras": "7891234567890",
  "codigoBarrasEmbalagem": null,
  "ordemSeparacao": null,
  "qtdePorPallet": null,
  "jsonCamposAuxiliares": null,
  "dataAlteracao": "2026-07-27 14:00:00"
}

Delete

Section titled “Delete”

Remove the product.

Rota: {host}/public/v1/produtos?codigo={codigo}
Método: DELETE

Return:

{
  "mensagem": "Registro excluído com sucesso."
}