API do Demander - Filiais

Este artigo faz parte da documentação da API de Integração REST.

Documentação para consultar, inserir, atualizar e excluir filiais.

Consulta

Lista as filiais da empresa. Sem filtro, considera dataAlteracao dos últimos 6 meses.

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

Retorno:

{
  "filiais": [
    {
      "codigo": "1",
      "descricao": "MATRIZ",
      "ativo": 1,
      "dataAlteracao": "2026-07-15 10:00:00"
    }
  ]
}

POST upsert pela chave codigo.

Rota: {host}/public/v1/filiais
Método: POST
Body: json

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codigo	string	15	✓	Código da filial. Identificador único usado para inserir ou atualizar (upsert).
descricao	string	255	✓	Nome da filial.
ativo	int			Valores: `0` ou `1`. Padrão na inclusão: `1`.

Body:

{
  "codigo": "1",
  "descricao": "MATRIZ",
  "ativo": 1
}

Retorno:

{
  "codigo": "1",
  "descricao": "MATRIZ",
  "ativo": 1,
  "dataAlteracao": "2026-07-15 10:00:00"
}

Remove a filial.

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

Retorno:

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