Restofy Docs
Productos POST

Crear producto del catálogo

POST /api/products/create-product

Descripción

Registra un producto nuevo en el catálogo del restaurante, asignándole automáticamente un código único.

Detalles

Crea un producto vinculado a una categoría, unidad de medida y tiempo de servicio. El código identificador del producto se genera de forma automática a partir del prefijo de la categoría asignada, sin que el integrador deba enviarlo. La apariencia visual y el estado se aplican con valores por defecto si no se envían. Falla si ya existe un producto con el mismo nombre, o si la categoría, la unidad o el tiempo de servicio no existen o no están disponibles.

Permisos requeridos

catalog.module

Request

Nombre Tipo Requerido Reglas
name string Sí
min:2 max:150
productCategoryUuid string Sí
min:36 max:36
unitId int Sí
min_value:1
defaultCourseId int Sí
min_value:1
internalName string No
max:150
description string No
max:2000
kitchenDefaultNotes string No
max:2000
basePriceCents int No
min_value:0 default:0
prepTimeMinutes int No
min_value:0 default:0
stockMin string No
decimal min_value:0 default:0
iconFontAwesome string No
max:100 default:fa-solid fa-bowl-food
color string No
min:7 max:7 default:#FF4500
isActive int No
enum:0,1 default:1
taxProductCategoryId int No
min_value:1
revenueAccountId int No
min_value:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/products/create-product \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "name": "string",
    "productCategoryUuid": "string",
    "unitId": 1,
    "defaultCourseId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "name": "Producto Test 6a57891470518",
    "productCategoryUuid": "ef52bb1b-f81b-44f8-a33c-119ca3d557ce",
    "unitId": 1,
    "defaultCourseId": 5,
    "basePriceCents": 1000,
    "iconFontAwesome": "fa-solid fa-bowl-food",
    "color": "#FF4500",
    "isActive": 1
}

Response

{
    "success": true,
    "message": "Producto creado",
    "data": {
        "product": {
            "uuid": "2f93aa47-c689-4b96-ba7e-bae484e3dc26",
            "name": "Producto Test 6a57891470518",
            "sku": "SOP-003",
            "internalName": null,
            "description": null,
            "kitchenDefaultNotes": null,
            "basePriceCents": 1000,
            "prepTimeMinutes": 0,
            "stockMin": "0.0000",
            "sortKey": "h",
            "iconFontAwesome": "fa-solid fa-bowl-food",
            "color": "#FF4500",
            "isActive": 1,
            "productCategoryUuid": "ef52bb1b-f81b-44f8-a33c-119ca3d557ce",
            "productCategoryName": "Sopas y Cremas",
            "unitId": 1,
            "defaultCourseId": 5,
            "taxProductCategoryId": null,
            "revenueAccountId": null
        }
    }
}
Volver a Productos