Saltar al contenido
Facturador

Vendeya: productos

GET /api/sellnow/items

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Catálogo completo (sin paginar) para Vendeya: productos activos con código interno y stock en el almacén del establecimiento del usuario, favoritos primero. Incluye insumos, combos, modificadores y, si la empresa usa lista de precios, las presentaciones con sus precios.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.

Reglas:

  • Con group_variations=1 las variaciones viajan dentro de su producto padre (variations) en lugar de como productos sueltos.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
group_variations query no 1 1 agrupa las variaciones (talla, color...) dentro del producto padre.

Respuestas

200 — Productos

{
  "success": true,
  "data": [
    {
      "id": 31,
      "unit_type_id": "NIU",
      "category_id": 7,
      "description": "GASEOSA COCA COLA 500ML",
      "name": "Gaseosa personal",
      "second_name": null,
      "warehouse_id": null,
      "internal_id": "P0001",
      "barcode": "7751271001234",
      "item_code": "50202301",
      "item_code_gs1": null,
      "stock": 120,
      "stock_min": 10,
      "currency_type_id": "PEN",
      "currency_type_symbol": "S/",
      "sale_affectation_igv_type_id": "10",
      "price": "2.50",
      "calculate_quantity": false,
      "has_igv": true,
      "active": true,
      "sale_unit_price": "S/ 2.50",
      "purchase_unit_price": "S/ 1.80",
      "created_at": "2026-10-01 09:00:00",
      "updated_at": "2026-11-07 10:00:00",
      "apply_store": false,
      "apply_restaurant": false,
      "restaurant_favorite": false,
      "image_url": "https://empresa.dominio/storage/uploads/items/gaseosa-coca-cola-500ml-31.jpg",
      "image_url_medium": "https://empresa.dominio/storage/uploads/items/gaseosa-coca-cola-500ml-31-medium.jpg",
      "image_url_small": "https://empresa.dominio/storage/uploads/items/gaseosa-coca-cola-500ml-31-small.jpg",
      "favorite": true,
      "area_print": null,
      "has_supplies": false,
      "is_dish": false,
      "has_sets": false,
      "items_sets": [],
      "modifiers": [],
      "parent_item_id": null,
      "variation_label": null,
      "variation_attributes": [],
      "variations_count": 0,
      "has_variations": false,
      "variation_variables": [],
      "variations": [],
      "item_unit_types": []
    }
  ]
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.