Criar Classificação 1 de almoxarifados

post

https://app.fracttal.com/api/warehouses_groups_1/new-endpoint-1

Cria uma nova Classificação 1 de almoxarifados na empresa do caller.

Add-on necessário
Uso geral — sem add-on específico. Requer que a API key/usuário tenha permissão add sobre Configuração > Catálogos.

POST https://app.fracttal.com/api/warehouses_groups_1

Parâmetros de entrada — Obrigatórios

Nenhum — ver nota sobre description abaixo.

Parâmetros de entrada — Opcionais

Enviados no body da requisição.

Parâmetro	Tipo	Obrigatório	Descrição
`description`	texto (máx. 50 caracteres)	Não	Nome da classificação. A coluna é nullable — se não for enviada, o registro é criado com `description = null`. Não há truncamento automático: enviar mais de 50 caracteres gera um erro `500`.

Comportamentos que chamam a atenção (não são erros)

Enviar a mesma description duas vezes não falha nem é idempotente: cria um segundo registro com o mesmo texto. O endpoint não valida unicidade.

Não enviar description também não falha: cria o registro com description = null.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`success`	booleano	`true` se a criação foi bem-sucedida.
`message`	texto	`"200"` em sucesso; código/mensagem de erro caso contrário.
`data`	objeto	`{ id, id_company, description, enabled }` da classificação criada.
`total`	inteiro	`1` em sucesso.

Erros

Código	Causa
`401`	Token inválido ou ausente.
`500`	Sem permissão `add` sobre Configuração > Catálogos.
`500`	`description` excede 50 caracteres (erro de banco de dados, sem mensagem de validação específica).

Nota sobre o código de erro por falta de permissão
Atualmente a função retorna 500 tanto para a rejeição de permissão quanto para qualquer outro erro interno não tratado — não há um código 403 diferenciado. Está em discussão com a Arquitetura se deveria ser separado (ver PR DbProduction#2844 e FHEI-1822).

Exemplo

Request body

{
  "description": "Peças críticas"
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": {
    "id": 751,
    "id_company": 4344,
    "description": "Peças críticas",
    "enabled": true
  },
  "total": 1
}

Response — sem permissão `add` (`500`)

{
  "success": false,
  "message": "500",
  "data": null,
  "total": 0
}

Response

200

Language

Loading…