Referencia de la APICategorías de productos
Editar
Actualiza el nombre o los productos de una categoría.
Descripción general
Este endpoint actualiza parcialmente una categoría de productos. Todos los campos del cuerpo son opcionales: los campos que omites no cambian. Una solicitud exitosa devuelve 200 con la categoría actualizada.
product_ids representa todos los productos de la categoría: los productos que ya estaban en ella y no vienen en la lista se quedan sin categoría, y los productos de la lista se mueven a esta categoría. Si omites product_ids, los productos de la categoría no cambian.
Requiere el permiso Crear en Productos.
Endpoint
PATCH
https://app.credonix.mx/api/v1/product-categories/{categoryId}Path param: categoryId — el id de la categoría.
Asigna los productos de la categoría
Envía la lista completa de productos que debe tener la categoría. El nombre queda igual porque no se envía name.
{ "product_ids": ["cmu218zqg0027v1dqr4r2ujcn"] }Reglas de los campos
| Campo | Tipo | Requerido | Notas |
|---|---|---|---|
name | string | No | Mínimo 1 carácter. No tiene que ser único. |
product_ids | string[] | No | Lista completa de productos de la categoría. Los productos que salen de la lista se quedan sin categoría; los productos de tu organización en la lista se mueven a esta categoría. Los id que no corresponden a un producto de tu organización se ignoran. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | VALIDATION_ERROR | Un campo tiene un valor o 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. |
404 | NOT_FOUND | La categoría no existe en esta organización. La respuesta incluye "La categoría no fue encontrada.". |