Create Warehouses Group 1

post

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

Creates a new Warehouses Group 1 classification in the caller's company.

Required add-on
General use — no specific add-on required. The API key/user must have add permission on Configuration > Catalogs.

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

Input parameters — Required

None — see the note about description below.

Input parameters — Optional

Sent in the request body.

Parameter	Type	Required	Description
`description`	string (max. 50 chars)	No	Classification name. The column is nullable — if not sent, the record is created with `description = null`. No automatic truncation: sending more than 50 characters causes a `500` error.

Notable behaviors (not errors)

Sending the same description twice does not fail and is not idempotent: it creates a second record with the same text. The endpoint does not validate uniqueness.

Not sending description does not fail either: the record is created with description = null.

Output parameters

Parameter	Type	Description
`success`	boolean	`true` if the creation was successful.
`message`	string	`"200"` on success; error code/message otherwise.
`data`	object	`{ id, id_company, description, enabled }` of the created classification.
`total`	integer	`1` on success.

Errors

Code	Cause
`401`	Invalid or missing token.
`500`	Missing `add` permission on Configuration > Catalogs.
`500`	`description` exceeds 50 characters (database error, no specific validation message).

Note on the permission-error status code
The function currently returns 500 both for a permission rejection and for any other unhandled internal error — there is no separate 403 code. This is under discussion with Architecture as to whether it should be split out (see PR DbProduction#2844 and FHEI-1822).

Example

Request body

{
  "description": "Critical spare parts"
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": {
    "id": 751,
    "id_company": 4344,
    "description": "Critical spare parts",
    "enabled": true
  },
  "total": 1
}

Response — missing `add` permission (`500`)

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

Response

200

Language

Loading…