API de Demander: listas de precios

Este artículo es parte de la documentación API de integración REST.

Documentación para consultar, insertar, actualizar y eliminar listas de precios.

Consulta

Enumera las listas de precios de la empresa. Sin filtro, considera dataAlteracao de los últimos 6 meses.

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

Precaución

Paginación

• pagina — base 1 (predeterminado 1)
• limite — predeterminado 100, máximo 500

Filtros

• Formato filtroDataAlteracao — Y-m-d
• operadorFiltro (opcional) — <, >, =, <=, >= (predeterminado >=)

Retorno:

{
  "listasDePreco": [
    {
      "codigo": "1",
      "descricao": "ATACADO/RS",
      "ativo": 1,
      "codFilialUnidade": "55",
      "temFreteEmbutidoNoValor": 0,
      "condicoesAdicionais": "10,20,30",
      "valorMinimoPedido": "100.50",
      "precoComImpostos": 0,
      "codMoeda": "BRL",
      "utilizaRedespacho": 0,
      "dataAlteracao": "2026-07-24 10:00:00"
    }
  ]
}

Insertar o actualizar

POST inserción mediante la tecla codigo.

Rota: {host}/public/v1/listas-de-preco
Método: POST
Body: json

Propiedad	Tipo	Tamaño	Obligatorio	Descripción
código	cadena	20	✓	Código de lista de precios. Identificador único utilizado para insertar o actualizar (upsert).
descripción	cadena	50	✓	Nombre/descripción de la lista de precios.
activo	entero			Valores: 0 o 1. Valor predeterminado de inclusión: 1. Los inactivos no le aparecen al vendedor.
codFilialUnidade	cadena	15		Sucursal/unidad. Si se completa, la lista solo aparece en los pedidos de esa sucursal.
temFreteEmbutidoNoValor	entero			Valores: 0 o 1. Indica si el envío ya está incluido en el valor de los productos.
condicoesAdicionais	cadena	500		Códigos de condiciones de pago liberadas (separados por comas). En blanco se libera todo.
valorMinimoPedido	decimal	15.2		Valor mínimo permitido para pedidos de esta lista.
precoComImpostos	entero			Valores: 0 o 1. Valor predeterminado de inclusión: 0. Indica si el precio ya incluye impuestos.
codMoeda	cadena	3		Código de moneda ISO (por ejemplo: BRL, USD).
utilizaRedespacho	entero			Valores: 0 o 1. Valor predeterminado de inclusión: 0. Muestra el campo de reenvío en el pedido.

Precaución

Inclusión

• Es necesario enviar todos los atributos que sean obligatorios. Devolver 201.

Actualización

• Sólo el atributo codigo es obligatorio. Devuelve 200.

Cuerpo:

{
  "codigo": "1",
  "descricao": "ATACADO/RS",
  "ativo": 1,
  "codFilialUnidade": "55",
  "temFreteEmbutidoNoValor": 0,
  "condicoesAdicionais": "10,20,30",
  "valorMinimoPedido": 100.5,
  "precoComImpostos": 0,
  "codMoeda": "BRL",
  "utilizaRedespacho": 0
}

Retorno:

{
  "codigo": "1",
  "descricao": "ATACADO/RS",
  "ativo": 1,
  "codFilialUnidade": "55",
  "temFreteEmbutidoNoValor": 0,
  "condicoesAdicionais": "10,20,30",
  "valorMinimoPedido": "100.50",
  "precoComImpostos": 0,
  "codMoeda": "BRL",
  "utilizaRedespacho": 0,
  "dataAlteracao": "2026-07-24 10:00:00"
}

Eliminar

Elimina la lista de precios.

Rota: {host}/public/v1/listas-de-preco?codigo={codigo}
Método: DELETE

Retorno:

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