Items

Los ítems son artículos de los que queremos llevar el control. Hay varias formas de categorizarlas y hay varios tipos, a continuación veremos como funcionan en Zauru.

Nuevo Ítem (producto o servicio)

Antes de poder vender o comprar productos o servicios, hay que crear los ítems que contengan el nombre y las especificaciones de estos. Los pasos para crear un Ítem son los siguientes:

1. Ir a “Configuraciones”
2. Seleccionar “Ítems”
3. Seleccionar “Nuevo Ítem”

Tipos de Item basados en como se manejan sus inventarios

Hay 2 tipos de Ítems:

1. Los Ítems que son productos
2. Los ítems que son servicios Los productos son almacenables y registran existencias, los servicios no son almacenables. Al seleccionar la caja de Almacenable (Paso 1) se registraran existencias de este ítem, si no se selecciona la caja de Almacenable (Paso 1) Zauru sabrá que este ítem es un servicio.

Tipos de productos (items no servicios)

Hay productos que son vendibles, pero no son comprables, y hay productos que son comprables pero no vendibles, por ejemplo: En un escenario de una Empresa que produce su propia mercadería, la materia prima es comprable, luego de un proceso de producción, el producto terminado vendible. Dicha empresa no venderá materia prima y no comprara producto terminado. Entonces el ítem de su materia prima es comprable y su producto terminado es vendible.

Hay 3 Tipos de Productos (Paso 2):

1. Los productos identificables, que llevan numero de serie único
2. Los productos perecederos, que pertenecen a un lote y tienen fecha de expiración.
3. Los productos normales, que no tienen fecha de vencimiento ni numero de serie.

Otras Características de los Ítems

Sus productos pueden tener ciertas características que los diferencien de los demás, por ejemplo: su peso, su unidad de medida, sus meses de garantía, un punto de re orden y una cantidad recomendada a ordenar. Para especificar dichas categorías a sus productos deberá colocarlas en el ítem, las características son las siguientes:

Si un ítem esta activo se podrá interactuar con el dentro del sistema. Coloque el nombre de su producto, no es recomendable que tenga productos con el mismo nombre. Coloque el código de su producto, si tiene. Coloque el código de barras de su producto para que pueda ser leído por el lector de código de barras. Coloque la unidad que utiliza para medir su producto. Coloque el peso de su producto. Coloque el volumen en metros cúbicos de su producto. Coloque la cantidad mínima que debería de tener en existencia de su producto. Cuando las existencias alcancen esa cantidad, el sistema le notificara poniendo su producto en color rojo, para que sepa cuando es recomendable volver a ordenar. Cuando su producto llegue a un punto de re orden, especifique la cantidad que seria recomendable volver a comprar. Coloque los meses de garantía que tiene su producto o Servicio. Si su producto o servicio paga IVA marque el cheque, si no, déjelo vacío. Coloque la tasa de arancel que paga su producto en la importación. Si su producto o servicio tiene alguna característica que no se pudo especificar en los campos anteriores, la puede colocar en la descripción. Adjunte imágenes de sus productos para que sean visibles en el modulo de punto de venta (P.O.S). Adjunte un PDF. Adjunte un producto o servicio a un proyecto que haya creado previamente. Seleccione un proveedor definido de sus productos o servicios. Para Guardar los cambios presione el botón de “Crear ítem”.

NOTA: La única característica obligatoria del ítem es su nombre, todos los demás campos son opcionales.

Importar Ítems

Cuando su empresa tiene cientos de productos o servicios puede ser tedioso crear items. Zauru le permite importar cantidades grandes de Ítems en formatos pre-definidos de Excel. Los pasos para importar ítems son los siguientes:

1. Ir a “Configuraciones”.
2. Seleccionar “Ítems”.
3. Click en el botón de “Importar”.

A continuación encontrara una guía para la importación de sus Ítems.

4. Deberá descargar la plantilla de importación de Ítems señalada. El único campo obligatorio para importar ítems es el nombre, todos los demás campos son opcionales.

Las entradas de texto permitidas para cada campo están especificadas en la imagen de abajo y son las siguientes:

• Booleano: TRUE or FALSE, si no se especifica una de las dos variables en la importación el sistema asumirá que es FALSE.
• Numero Entero: Solo se permiten números sin punto decimal o separador de miles (comas).
• Numero con Decimales: Solo numero sin separador de miles (comas).
• Texto: Cualquier carácter es permitido.
• Cadena de texto: Cualquier carácter dentro de la cadena es permitido, pero que no sea mayor a 256 caracteres.

5. Al terminar de colocar los campos que desee importar en la plantilla de Excel deberá seleccionar el archivo a importar.

6. Seleccione el botón de “Importar Ítems” y espere a que Zauru suba sus ítems, si aparece algún error en la importación, revise si su plantilla de Excel cumple las normas de importación.

Categorizar Ítems

Es probable que sus productos estén categorizados por tamaño, color, peso, tipo de cliente, material, personaje etc. Es posible categorizar sus productos en Zauru para poder ubicar sus productos más fácilmente. Los pasos para categorizar ítems son los siguientes:

1. Ir a “Configuraciones”.
2. Seleccionar “Ítems”.
3. Seleccionar “Categoría de Ítems” en las pestañas.
4. Click en el botón “+ Nueva Categoría de Ítems”.

5. Coloque el Nombre de la Categoría de Ítems.

6. Coloque una nota sobre la categoría de Ítems. (opcional)

7. Presione “Crear Categoría de Ítems”.

Luego de crear la Categoría de Ítems deberá colocársela al ítem(s) que desea categorizar. La forma de hacerlo es la siguiente:

1. Ir a “Configuraciones”.
2. Seleccionar “Ítems”.
3. Seleccione “Editar” para agregar un ítem existente a una categoría.

Súper Categorías de Ítems

Es probable que sus productos estén categorizados por tamaño, color, peso, tipo de cliente, material, personaje etc. Ahora es posible categorizar sus productos en Zauru también por SÚPER CATEGORÍAS, lo cual permitirá poder ubicar sus productos de una forma aún más fácil. Los pasos para categorizar ítems con SÚPER CATEGORÍAS son los siguientes:

1. Ir a “Configuraciones”.
2. Seleccionar “Ítems”.
3. Seleccionar “Súper Categoría de Ítems” en las pestañas.
4. Click en el botón “+ Nueva Súper Categoría de Ítems”.

5. Coloque el Nombre de la Súper Categoría de Ítems.
6. Coloque una nota sobre la Súper categoría de Ítems. (opcional)
7. Puede elegir un color (Esto será funcional si la empresa utiliza el módulo de PDV.
8. Presione “Crear Súper Categoría de Ítems”.

Marcas de Ítems

Es probable que sus productos estén categorizados por tamaño, color, peso, tipo de cliente, material, personaje etc. Ahora es posible categorizar sus productos en Zauru también por MARCAS, lo cual permitirá poder ubicar sus productos de una forma aún más fácil. Los pasos para categorizar ítems con MARCAS son los siguientes:

1. Ir a “Configuraciones”.
2. Seleccionar “Ítems”.
3. Seleccionar “Marcas” en las pestañas.
4. Click en el botón “+ Nueva Marca”.

5. Coloque el Nombre de la Marca de Ítems.
6. Coloque una nota sobre la Marca de Ítems. (opcional)
7. Puede elegir un color (Esto será funcional si la empresa utiliza el módulo de PDV.
8. Presione “Crear Marca”.

API (llamadas desde sistemas externos)

obtener información del item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/1.json

crear item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item": {
      "name": "Producto prueba",
      "reference": "Referencia del producto prueba",
      "stockable": "false"
    }
  }' \
  https://app.zauru.com/settings/items.json

actualizar item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "item": {
      "name": "Producto prueba actualizado",
      "sellable": "1",
      "purchasable": "1"
    }
  }' \
  https://app.zauru.com/settings/items/1.json

actualizar variaciones de item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PATCH \
  -d '{
    "id": "1",
    "items": [
      {
        "id": "2",
        "master_item_id": "1",
        "item_attributes_attributes": [
          {"key": "Color", "value": "Rojo", "color": "#FF0000"}
        ]
      }
    ]
  }' \
  https://app.zauru.com/settings/items/1/update_item_variations.json

destruir item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/items/1.json

Nota: Solo se puede eliminar el item si no tiene # de serie, lotes, aparece a un envío, aparece a un paquete, aparece a una factura, aparece en una orden de compra o está seleccionado en algún descuentos de items.

listado de categorías de items

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/item_categories.json

crear categoría de item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item_category": {
      "name": "super categoria",
      "notes": "descripcion de la categoria"
    }
  }' \
  https://app.zauru.com/settings/items/item_categories.json

obtener detalle de categoría de item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/item_categories/1.json

actualizar categoría de item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "item_category": {
      "name": "categoria actualizada"
    }
  }' \
  https://app.zauru.com/settings/items/item_categories/1.json

eliminar categoría de item

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/items/item_categories/1.json

---

Variaciones de Ítems

Zauru le permite manejar variaciones de un mismo producto (por ejemplo: diferentes colores, tallas o materiales de un mismo artículo). Las variaciones se manejan a través de un sistema de Ítem Maestro e Ítems Hijos.

Configurar Variaciones

Para gestionar las variaciones de un ítem:

1. Vaya al detalle del ítem que será el maestro.
2. Seleccione la opción "Editar Variaciones".

En esta vista podrá:

• Ver todos los ítems hijos (variaciones) del ítem maestro.
• Agregar nuevos ítems como variaciones seleccionándolos de una lista de ítems similares.
• Crear nuevos ítems hijos directamente con sus atributos de variación (ej. Color: Rojo, Talla: M).
• Editar los atributos de cada variación (clave, valor y color).
• Desvincular un ítem hijo del maestro.

Cada ítem hijo hereda automáticamente los atributos del ítem maestro cuando este se actualiza, manteniendo la consistencia entre todas las variaciones.

Atributos de Ítem

Los atributos son pares clave-valor que permiten definir las características de las variaciones. Por ejemplo:

• Clave: Color, Valor: Rojo
• Clave: Talla, Valor: M
• Clave: Material, Valor: Algodón

Cada atributo puede tener un color asociado (útil para el módulo de Punto de Venta).

Importar Ítems con Precios de Venta

Además de la importación básica de ítems, Zauru le permite importar ítems junto con sus precios de venta sugeridos. Para ello:

1. Ir a "Configuraciones".
2. Seleccionar "Ítems".
3. Seleccionar "Importar Ítems con Precios de Venta".

Esta funcionalidad le permite especificar, además de los datos del ítem, el precio de venta, la moneda del precio y si es un precio flexible, creando automáticamente el precio sugerido al importar.

Verificación de Ítems Faltantes en Importación

Cuando realiza una importación de ítems, Zauru le permite verificar si existen ítems que no se importaron correctamente. Esta funcionalidad es útil para auditorías de importación:

1. Ir a "Configuraciones".
2. Seleccionar "Ítems".
3. Seleccionar "Verificar Ítems Faltantes".

El sistema comparará los datos del archivo de importación con los ítems existentes y le mostrará cuáles no se encuentran en el sistema, permitiéndole crear los ítems faltantes directamente.

Filtrar Ítems por Etiquetas

En el listado de ítems, Zauru le muestra una nube de etiquetas (Tag Cloud) que le permite filtrar rápidamente los productos por las etiquetas que tengan asignadas. Simplemente haga click en una etiqueta de la nube para filtrar los ítems que la tengan.

Exportar Ítems

Zauru le permite exportar su listado de ítems en formato CSV, XLS o JSON. Para exportar:

1. Ir a "Configuraciones".
2. Seleccionar "Ítems".
3. Seleccionar el formato de exportación deseado (CSV, XLS o JSON).

Los datos exportados incluyen: código, nombre, categoría, marca, etiquetas, estado activo, tipo de producto, precios y demás características.

Formularios Asociados al Ítem

Al visualizar los detalles de un ítem, Zauru le mostrará los formularios personalizados que tenga asociados para el tipo de documento "Ítem". También podrá ver el historial de formularios enviados (submissions) relacionados con ese ítem.

API (llamadas desde sistemas externos)

Obtener listado de marcas

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/brands.json

Crear marca

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "brand": {
      "name": "Marca Ejemplo",
      "notes": "Descripción de la marca",
      "color": "#FF0000"
    }
  }' \
  https://app.zauru.com/settings/items/brands.json

Exportar ítems

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/export.csv

Obtener ítems en JSON con todas las asociaciones

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/export.json

API de Súper Categorías de Ítems

Obtener listado de súper categorías

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/item_super_categories.json

Crear súper categoría de ítem

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item_super_category": {
      "name": "Electrónica",
      "description": "Productos electrónicos",
      "color": "#0000FF"
    }
  }' \
  https://app.zauru.com/settings/items/item_super_categories.json

Actualizar súper categoría de ítem

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "item_super_category": {
      "name": "Electrónica y Accesorios"
    }
  }' \
  https://app.zauru.com/settings/items/item_super_categories/1.json

Eliminar súper categoría de ítem

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/items/item_super_categories/1.json

API de Marcas de Ítems

Obtener detalle de una marca

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/items/brands/1.json

Actualizar marca

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "brand": {
      "name": "Marca Ejemplo Actualizada"
    }
  }' \
  https://app.zauru.com/settings/items/brands/1.json

Eliminar marca

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/items/brands/1.json

API de Importación de Ítems

Crear importación de ítems

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item_import": {
      "file": "archivo_excel.xlsx"
    }
  }' \
  https://app.zauru.com/settings/items/item_imports.json

Crear importación de ítems con precios y existencias

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item_stock_price_import": {
      "file": "archivo_excel.xlsx",
      "agency_id": "1"
    }
  }' \
  https://app.zauru.com/settings/items/item_stock_price_imports.json

API de Verificación de Ítems Faltantes

Crear verificación de ítems faltantes

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "item_import_check": {
      "file": "archivo_excel.xlsx"
    }
  }' \
  https://app.zauru.com/settings/items/item_import_checks.json

Crear ítems faltantes detectados

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "items": [
      {"ean13": "7501000001", "name": "Producto faltante 1"}
    ],
    "items_product_types": {"1": "0"}
  }' \
  https://app.zauru.com/settings/items/item_import_checks/create_missing_items.json