Listar productos
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.
Parámetros de consulta
Sección titulada «Parámetros de consulta»per_pageintegerRegistros por página. Por defecto 20.
searchstringTexto a buscar en el nombre, el código y el número de parte del producto, y en los códigos de barras.
brand_idintegerSolo los productos de esa marca.
measurement_unit_idintegerSolo los productos con esa unidad de medida base.
category_idintegerSolo los productos que tienen esa categoría.
provider_idintegerSolo los productos que tienen un precio de ese proveedor.
tracking_typestringSolo los productos con esa trazabilidad: none, lot, serial o lot_serial.
is_inventory_itembooleanFiltra por producto de inventario. Se interpreta como booleano; un valor vacío no filtra.
is_dropshipping_enabledbooleanFiltra por dropshipping habilitado. Se interpreta como booleano; un valor vacío no filtra.
warehouse_idintegerSolo los productos que tienen una configuración de producto-almacén en ese almacén.
with_aggregatesbooleanCon un valor verdadero, agrega a cada producto stock_on_hand, stock_value, warehouses_count, provider_products_count y product_barcodes_count.
relationsstringRelaciones a cargar. El modelo no restringe las relaciones. Ver Resumen.
count_relationsstringConteos de relaciones. El modelo no define conteos permitidos.
orderstringOrden de los resultados con el formato campo|ASC o campo|DESC. Campos permitidos: id, name, code, part_number, created_at, updated_at, status.
Permiso
Sección titulada «Permiso»No exige un permiso del módulo: ProductPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.
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"const response = await fetch( "https://servererp.allendostmen.app/api/product?per_page=20&search=interruptor&brand_id=1&order=name|ASC", { method: "GET", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", }, },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->get('https://servererp.allendostmen.app/api/product', [ 'per_page' => 20, 'search' => 'interruptor', 'brand_id' => 1, 'order' => 'name|ASC',]);{ "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}{ "message": "This action is unauthorized."}