Referencia de la APICategorías de productos
Crear
Crea una categoría de productos en tu organización.
Descripción general
Este endpoint crea una categoría de productos. El único campo obligatorio es name. Con product_ids puedes asignar productos a la nueva categoría en la misma solicitud. Una solicitud exitosa devuelve 201 con la categoría creada.
Requiere el permiso Crear en Productos.
Endpoint
POST
https://app.credonix.mx/api/v1/product-categoriesCrea una categoría
Envía el nombre de la categoría. Sin product_ids la categoría se crea sin productos.
{ "name": "Servicios profesionales" }Reglas de los campos
| Campo | Tipo | Requerido | Notas |
|---|---|---|---|
name | string | Sí | Mínimo 1 carácter. No tiene que ser único. |
product_ids | string[] | No | id de productos de tu organización. Cada producto se mueve a la nueva categoría y deja la categoría que tenía. Los id que no corresponden a un producto de tu organización se ignoran. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | VALIDATION_ERROR | Falta name, un campo tiene un tipo incorrecto o el cuerpo incluye campos desconocidos. |
401 | MISSING_API_KEY, INVALID_API_KEY, API_KEY_REVOKED | API key ausente, inválida o revocada. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Crear en Productos. |