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

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`.

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."
}