post
https://app.fracttal.com/api/warehouses_groups_1/
Creates a new Warehouses Group 1 classification in the caller's company.
Required add-onGeneral use — no specific add-on required. The API key/user must have
addpermission on Configuration > Catalogs.
POST https://app.fracttal.com/api/warehouses_groups_1Input parameters — Required
Sent in the request body.
| Parameter | Type | Required | Description |
|---|---|---|---|
description | string (max. 200 chars) | Yes | Classification name. It cannot be empty, missing, or contain only spaces. Leading and trailing spaces are removed before the text is validated and saved. |
Input parameters — Optional
None.
Length ofdescription
- The text accepts up to 200 characters, counted after removing leading and trailing spaces.
- If it exceeds 200 characters, the request is rejected with a
400error and no record is created. The API does not shorten the text automatically.- Integrations must send
descriptionwith a maximum of 200 characters.
Notable behaviors (not errors)
- Sending the same
descriptiontwice does not fail and is not idempotent: it creates a second record with the same text. The endpoint does not validate uniqueness.- The classification is always created as enabled (
enabled = true).
Output parameters
| Parameter | Type | Description |
|---|---|---|
success | boolean | true if the creation was successful. |
message | string | "200" on success; the error code otherwise. |
data | object | { id, id_company, description, enabled } of the created classification. On error, an array with { "ERROR": "<message>" }. |
total | integer | 1 on success, 0 on error. |
Errors
| Code | Cause |
|---|---|
400 | description is empty, missing, or contains only spaces. |
400 | description exceeds 200 characters. |
401 | Invalid or missing token. |
403 | The API key/user does not have add permission on Configuration > Catalogs. |
500 | Unexpected internal error. |
Example
Request body
{
"description": "Critical spare parts"
}Response 200
200{
"success": true,
"message": "200",
"data": {
"id": 751,
"id_company": 4344,
"description": "Critical spare parts",
"enabled": true
},
"total": 1
}Response — empty, missing, or whitespace-only description (400)
description (400){
"success": false,
"message": "400",
"data": [{ "ERROR": "description is required and cannot be empty" }],
"total": 0
}Response — description longer than 200 characters (400)
description longer than 200 characters (400){
"success": false,
"message": "400",
"data": [{ "ERROR": "description exceeds maximum length of 200 characters" }],
"total": 0
}Response — missing add permission (403)
add permission (403){
"success": false,
"message": "403",
"data": [{ "ERROR": "User does not have permission to add warehouse group" }],
"total": 0
}Response — invalid or missing token (401)
401){
"success": false,
"message": "401",
"data": [{ "ERROR": "Unauthorized" }],
"total": 0
}