Ir al contenido

Listar productos

GET/api/product

Devuelve la lista paginada de productos. Usa BaseControllerHelper::index, así que admite los parámetros comunes de paginación, filtros y orden descritos en Paginación, filtros y orden.

per_pageinteger

Registros por página. Por defecto 20.

searchstring

Texto a buscar en el nombre, el código y el número de parte del producto, y en los códigos de barras.

brand_idinteger

Solo los productos de esa marca.

measurement_unit_idinteger

Solo los productos con esa unidad de medida base.

category_idinteger

Solo los productos que tienen esa categoría.

provider_idinteger

Solo los productos que tienen un precio de ese proveedor.

tracking_typestring

Solo los productos con esa trazabilidad: none, lot, serial o lot_serial.

is_inventory_itemboolean

Filtra por producto de inventario. Se interpreta como booleano; un valor vacío no filtra.

is_dropshipping_enabledboolean

Filtra por dropshipping habilitado. Se interpreta como booleano; un valor vacío no filtra.

warehouse_idinteger

Solo los productos que tienen una configuración de producto-almacén en ese almacén.

with_aggregatesboolean

Con un valor verdadero, agrega a cada producto stock_on_hand, stock_value, warehouses_count, provider_products_count y product_barcodes_count.

relationsstring

Relaciones a cargar. El modelo no restringe las relaciones. Ver Resumen.

count_relationsstring

Conteos de relaciones. El modelo no define conteos permitidos.

orderstring

Orden de los resultados con el formato campo|ASC o campo|DESC. Campos permitidos: id, name, code, part_number, created_at, updated_at, status.

No exige un permiso del módulo: ProductPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/product" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "search=interruptor" \
--data-urlencode "brand_id=1" \
--data-urlencode "order=name|ASC"
Lista de productos200
{
"current_page": 1,
"data": [
{
"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
}
],
"first_page_url": "https://servererp.allendostmen.app/api/product?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/product?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/product",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}