Ir al contenido

Crear un producto

POST/api/product

Crea un producto. Dentro de una transacción, el servidor guarda el producto con estado activo, genera su code correlativo, registra las categorías, los precios por proveedor, las categorías de costo unitario, las presentaciones y los códigos de barras enviados, genera los códigos de barras internos y calcula las palabras clave de búsqueda. Responde 201.

part_numberstringobligatorio

Número de parte. Máximo 50 caracteres. Debe ser único, también frente a productos eliminados.

namestringobligatorio

Nombre del producto. Máximo 255 caracteres.

descriptionstringobligatorio

Descripción del producto. Máximo 1000 caracteres.

brand_idintegerobligatorio

Marca. Debe existir en marcas.

measurement_unit_idintegerobligatorio

Unidad de medida base. Debe existir en unidades de medida.

unified_index_idinteger

Índice unificado. Debe existir en índices unificados.

product_categoriesarrayobligatorio

Categorías del producto. Debe tener al menos un elemento y cada elemento lleva category_id (obligatorio, debe existir en categorías).

featuresstring

Características del producto.

buy_pricenumber

Precio de compra. No tiene reglas de formato.

sale_pricenumber

Precio de venta. No tiene reglas de formato.

stockinteger

Stock. No tiene reglas de formato.

imagestring

Imagen del producto: una ruta existente o un objeto base64 del frontend. Si envías la clave, el servidor reemplaza la imagen.

filestring

Se acepta en la validación, pero el caso de uso no lo usa; la imagen se envía en image.

file_extensionstring

Obligatorio si se envía file. El caso de uso no lo usa.

provider_productsarray

Lista de precios por proveedor. Cada elemento lleva provider_id (obligatorio, debe existir), code (obligatorio, máximo 50), coin_id (obligatorio, debe existir), price (obligatorio, numérico, de 0.01 a 1000000000), stock (obligatorio, entero de 0 a 1000000000), delivery_days (obligatorio, entero de 1 a 180), link_url (URL), commentary, name, description, payment_type (contado, crédito, credito_15, credito_30 o credito_60), inquiry_date (fecha que no sea futura) y evidence_file (objeto con base_64 y extension_file, que puede ser pdf, jpg, jpeg, png o webp).

product_unit_cost_categoriesarray

Categorías de costo unitario. Cada elemento lleva unit_cost_category_id, que debe existir en categorías de costo unitario.

is_inventory_itemboolean

Indica si el producto participa del kardex físico.

is_dropshipping_enabledboolean

Indica si el producto expone la disponibilidad del proveedor.

tracking_typestring

Trazabilidad: none, lot, serial o lot_serial.

picking_strategystringcondicional

Estrategia de salida: fefo, fifo o manual. Obligatoria si tracking_type es lot o lot_serial. Si falta, el mensaje es La estrategia de salida es obligatoria para productos con trazabilidad por lote.

product_unitsarray

Presentaciones del producto. Cada elemento lleva measurement_unit_id (debe existir), factor (numérico, mayor que 0), is_purchase_default e is_sale_default (booleanos). La unidad base se agrega con factor 1. Si envías la clave, el servidor sincroniza las presentaciones.

product_barcodesarray

Códigos de barras. Cada elemento lleva barcode (obligatorio, texto de hasta 255 caracteres), source (obligatorio: manufacturer, internal o provider), symbology (EAN13, UPCA, C128 o QR), provider_id (obligatorio si source es provider; no aplica en los demás), product_unit_id, is_primary, label e id. El código no puede repetirse en la lista ni estar registrado en otro producto. Si envías la clave, el servidor sincroniza los códigos.

quotation.configuration.create, que se valida en ProductPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/product" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"part_number": "NSX100F",
"name": "Interruptor termomagnético 3x100A",
"description": "Interruptor termomagnético tripolar de 100 A",
"brand_id": 1,
"measurement_unit_id": 2,
"product_categories": [
{
"category_id": 3
}
],
"sale_price": 150,
"is_inventory_item": true,
"tracking_type": "none"
}'
Producto creado201
{
"id": 1,
"brand_id": 1,
"measurement_unit_id": 2,
"unified_index_id": null,
"code": "0000001",
"part_number": "NSX100F",
"name": "Interruptor termomagnético 3x100A",
"description": "Interruptor termomagnético tripolar de 100 A",
"features": null,
"search_keywords": "interruptor termomagnetico 3x100a nsx100f 0000001 schneider",
"buy_price": "120.00000000",
"sale_price": "150.00000000",
"stock": null,
"image": null,
"thumbnall": null,
"is_inventory_item": true,
"is_dropshipping_enabled": false,
"tracking_type": "none",
"picking_strategy": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "El número de parte ya existe. Verifique o restaure el registro si fue eliminado anteriormente.",
"errors": {
"part_number": [
"El número de parte ya existe. Verifique o restaure el registro si fue eliminado anteriormente."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}