API de Demander - Stock por sucursal

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

Documentación para consultar, insertar, actualizar y eliminar stocks por sucursal.

Consulta

Enumera las acciones por sucursal de la empresa. Sin filtro, considera dataAlteracao de los últimos 6 meses.

Rota: {host}/public/v1/estoques-por-filial?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:

{
  "estoquesPorFilial": [
    {
      "codProduto": "00009",
      "codFilialUnidade": "00",
      "saldoEstoque": 10.5,
      "dataEstoque": "2020-08-28 15:51:10",
      "dataAlteracao": "2026-07-27 10:00:00"
    }
  ]
}

Insertar o actualizar

POST inserción mediante la tecla compuesta codProduto + codFilialUnidade.

Rota: {host}/public/v1/estoques-por-filial
Método: POST
Body: json

Propiedad	Tipo	Tamaño	Obligatorio	Descripción
codProduto	cadena	30	✓	Código de producto. Parte de la clave upsert.
codFilialUnidade	cadena	30	✓	Código de sucursal. Parte de la clave upsert.
saldoEstoque	decimal		✓	Saldo en existencias. Acepta 0.
dataEstoque	fechahora		✓	Fecha/hora del último cambio de stock. Formato Y-m-d H:i:s.

Precaución

Inclusión

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

Actualización

• Sólo codProduto y codFilialUnidade son obligatorios. Devuelve 200.

Cuerpo:

{
  "codProduto": "00009",
  "codFilialUnidade": "00",
  "saldoEstoque": 10.5,
  "dataEstoque": "2020-08-28 15:51:10"
}

Retorno:

{
  "codProduto": "00009",
  "codFilialUnidade": "00",
  "saldoEstoque": 10.5,
  "dataEstoque": "2020-08-28 15:51:10",
  "dataAlteracao": "2026-07-27 10:00:00"
}

Eliminar

Elimina inventario por sucursal.

Rota: {host}/public/v1/estoques-por-filial?codProduto={codProduto}&codFilialUnidade={codFilialUnidade}
Método: DELETE

Retorno:

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