¿Qué es el módulo Items?

El módulo Items en OrderGrid es la ubicación central para gestionar todos tus artículos de inventario. Este módulo te permite crear, editar y configurar artículos de inventario para agilizar las operaciones del almacén, incluidas las recepciones, el picking y los ajustes de stock. Todos los artículos deben configurarse en el módulo Inventory > Items antes de ser utilizados en distintos almacenes o tiendas dentro del sistema.

Para acceder a Items, navega a:

☰ > Inventory > Items

Crear artículos

En la aplicación OrderGrid, puedes crear un artículo mediante la interfaz de la app o ingresar datos de artículos a través de la Open API en el sistema OrderGrid:

Usando la interfaz de la app

Creación Manual de Artículos (artículo único): Esto le permite crear un solo elemento a la vez.
Carga Masiva de Artículos mediante archivo CSV: Esto te permite crear múltiples artículos a la vez.

Usando la Open API

Crear elementos a través de API: Esto funciona enviando los datos del artículo a la plataforma OrderGrid desde tu aplicación de terceros.

Antes de crear artículos, puedes configurar los siguientes inventory settings, que se usarán durante el proceso de creación de artículos. De forma predeterminada, ya existen algunas opciones para comenzar.

Para configurar los inventory settings, navega a ☰ > Inventory > Settings

UOM: Define varias unidades de medida para los artículos.
- Opciones UOM por defecto:
  - EA
  - CS
  - BG
Categories: Define categorías para la agrupación organizativa.
- Opciones de categoría por defecto:
  - Default
Brands: Preconfigura nombres de marca para una selección sencilla.
- Opciones de marca por defecto:
  - My Brand
Item Tags: Crea etiquetas para filtrar artículos.
- Opciones de tag por defecto:
  - My Tag
Item Types: Establece tipos de artículo para definir su uso.
- Opciones de tipo por defecto:
  - Filter
  - Insert
  - Product
  - Shipping Box

Creación manual de artículos (Artículo único) 🪜

Para crear un nuevo artículo manual en OrderGrid, sigue estos pasos 🪜:

⚠️ Nota: Los campos marcados con asterisco (*) son obligatorios.

En la página Items, haz clic en + New Item.
En el formulario New Item > pestaña General, agrega el detalle del artículo en la sección Main Item information:
- HS Code: Harmonized System (HS) codes se usan comúnmente durante el proceso de importación y exportación para la clasificación de mercancías. Esta información es requerida si el artículo será procesado para una orden que cruza fronteras internacionales.
- Item Name*: Introduce el nombre del artículo (p. ej., “Manzanas Orgánicas”).
- Brand*: Selecciona la marca asociada.
- SKU: Stock-keeping unit utilizado para rastrear inventario. Puedes dejar este campo en blanco si no tienes un SKU para el artículo. Una vez creado el artículo, se asignará automáticamente un OG Code al SKU.
  Un OG Code es un número único de identificación asignado a cada artículo que se crea.
- Category*: Elige la categoría para la agrupación organizativa.
- Tags: Utiliza Item tags para etiquetar artículos y filtrarlos mejor.
- Type*: Selecciona el tipo de artículo para su uso en el almacén (p. ej., Product, Filler, Insert).
- Lot Type*: Elige el tipo de seguimiento:
  - Lot and Expiry: Rastrea códigos de lote y fechas de caducidad.
  - Expiry Only: Rastrea solo fechas de caducidad.
  - Lot Only: Rastrea solo códigos de lote.
  - N/A: Sin seguimiento de lote ni caducidad.
- Temp Type: Selecciona el tipo de temperatura de almacenamiento del artículo (p. ej., Ambient, Chilled, Frozen).
- Controlled Product: Activa el toggle si aplican normativas de manipulación específicas.
- VAT: Especifica si el producto aplica IVA.
- Configuración específica adicional del artículo:
  - Material: Activa ON si el artículo es material. Esto requerirá ingresar Material Cost y Material Price en la sección Material.
  - Pre-packaged weighted: Activa ON si el artículo está pre-empaquetado y es ponderado. Esto requerirá la unidad de peso del artículo y el peso estimado en la sección Weighted.
  - Serial Number: Activa ON si el artículo tiene número de serie. Esto requerirá agregar un formato de número de serie.
  - Security Seal: Activa ON si el artículo tiene sello de seguridad. Esto requerirá agregar un formato de sello de seguridad.
  - Unpurchasable: Activa ON si deseas que el artículo no esté disponible para compra.
Customs Information:
- Manufacturing Country: Selecciona el país de origen del artículo.
- Customs Description*: Descripción breve para aduanas.
UOMs: En esta sección puedes crear múltiples unidades de medida en las que comprarás, recibirás y procesarás los artículos para su fulfillment.
- De forma predeterminada, se agrega la UOM base más pequeña EA al artículo, que contiene los siguientes detalles:
  - UOM: EA
  - Barcode: 000000000000
  - Backup Ean: 000000000000
  - Case qty: 1 (esta cantidad de caja no puede modificarse en la UOM predeterminada)
  - Weight, g*: 1
  - Empty case weight, g*: 1
  - Width, cm*: 1
  - Lenght, cm*: 1
  - Height, cm*: 1
  - Purchase Default: Toggle ON
  - Pick by: Toggle OFF
- Puedes ajustar la UOM EA predeterminada según tus necesidades o agregar UOM adicionales haciendo clic en Add UOM
Planning: Configura los detalles de planificación de inventario. Por defecto, puedes dejar el valor en 0 en los campos obligatorios si no utilizarás esta función.
- Lead Time*: Días necesarios para reabastecer el artículo.
- Min Level*: Nivel mínimo de stock para disparar el reabastecimiento.
- Min Order*: Cantidad mínima requerida para una orden de reposición.
- Stop Ship (days)*: Stop Ship evita que los artículos se recojan si están dentro del período de buffer (stop ship days) antes de la caducidad. El sistema asegura que los artículos solo se elijan si la fecha de picking es anterior o igual a la fecha de caducidad menos el período de Stop Ship.
- Min Shelf Life: Define la vida útil mínima restante para artículos perecederos.
- Partner: Asigna el artículo a un proveedor o distribuidor (requiere para crear una Purchase Order).
Guardar el artículo:
- Después de completar los campos obligatorios, haz clic en Save para finalizar la creación del artículo. Aparecerá un mensaje de confirmación cuando el artículo se cree correctamente.

Para cualquier artículo:

Al menos una UOM debe tener case quantity = 1.
Al menos una UOM debe estar seleccionada como purchase default.

Carga masiva de artículos mediante archivo CSV

Puedes importar varios artículos a la vez usando la función de importación CSV. Para garantizar un proceso fluido, utiliza las plantillas proporcionadas y prepara tu archivo CSV.

Templates

Item Import Template – Contiene instrucciones detalladas sobre los campos obligatorios y el formato correcto de los datos.
Item Import Sample – Plantilla lista para usar donde puedes introducir directamente los datos de los artículos en las filas.

Descarga y completa la plantilla apropiada antes de continuar con el proceso de importación.

Para importar artículos con un archivo CSV, sigue estos pasos:

Navega a Inventory > Items y haz clic en Import Items.
En la pantalla Import Items Sources, selecciona Excel de la lista de integraciones.
Sube tu archivo CSV preparado de una de las siguientes maneras:
- Arrastra y suelta el archivo dentro del cuadro de carga.
- Haz clic dentro del área de carga para buscar y seleccionar el archivo en tu sistema.
En la pantalla Catalog Items Import:
- Selecciona artículos individuales marcando las casillas junto a ellos.
- Para importar todos los artículos, haz clic en Select all items.
Haz clic en Import Items para iniciar el proceso. El estado de cada artículo cambiará de New a Imported una vez procesado correctamente.
Si algún artículo falla la importación, aparecerá en los resultados del CSV con los mensajes de error específicos.
Para resolver los errores, actualiza el archivo CSV según los mensajes y vuelve a intentar la importación.

Importación de artículos a través de API

Si gestionas el inventario mediante plataformas externas, OrderGrid ofrece importaciones basadas en API para sincronizar artículos sin interrupciones. Este método elimina las cargas manuales al sincronizar los datos de los artículos desde aplicaciones conectadas.

Importación de elementos de prueba a través de API

Para probar cómo funciona la importación de artículos usando la API de OrderGrid en SwaggerHub, sigue estos pasos:

Acceda a la documentación de la API
- Abre la documentación de la OrderGrid API en SwaggerHub.
Asegúrate de seleccionar el servidor correcto para el entorno de pruebas.
- Production environment: https://api.ordergrid.com/storeapi/v1 – Production
- Staging environment: https://stagingapi.ordergrid.com/storeapi/v1 – Staging
Localice la sección de artículos del proveedor
- Desplázate hasta Supplier Items y localiza el endpoint POST /item.
Autenticarse usando su clave API
- Obtén tu API key en ≡ > Settings > API Keys dentro de la app.
- Coloca la clave en el campo x-og-access-token para autenticar las solicitudes.
Iniciar una solicitud POST al punto final /item
- En la documentación de la API, ubique el punto final POST /item en Artículos del proveedor.
- Haz clic en Try it out para abrir el formulario de la solicitud.
Ingrese los datos del artículo
- Estructura los datos de tus artículos utilizando el formato de ejemplo proporcionado en la documentación de la API.
- Reemplaza los valores de ejemplo con los detalles específicos de tu artículo.
Ejecutar la solicitud
- Haga clic en Ejecutar para enviar los datos a la API.
- Monitor the Server Response to confirm if the import was successful.
Verificar la importación
- Ve a Inventory > Items y comprueba que los artículos aparezcan correctamente.

Para obtener más ayuda, consulte la documentación de la API o comuníquese con el soporte técnico.

Carga útil de muestra para la importación de API

{
  "data": [
    {
      "sku": "13264767",
      "gridCode": "OG000300201",
      "name": "Basic Wireless Earbuds",
      "description": "High-quality wireless earbuds",
      "manufactureCountry": "CA",
      "isMaterial": false,
      "tempType": "ambient",
      "controlledProduct": false,
      "isSet": false,
      "isWeighted": false,
      "isRawWeighted": false,
      "planning": {
        "leadTime": 2,
        "minLevel": 5,
        "minOrder": 10,
        "stopShip": 0,
        "maxQty": 100
      },
      "active": true,
      "lotType": "Lot and Expiry", //"Lot Only"
      "weighted": {},
      "brand": "My Brand",
      "category": "Default",
      "type": "Product",
      "tags": ["My Tag"],
      "isUnpurchasable": false,
      "UOMs": [
        {
          "packCode": "EA",
          "packSize": 1,
          "barcode": "110000300201",
          "altEans": null,
          "backupEan": "110000300202",
          "width": 5,
          "length": 5,
          "height": 3,
          "weight": 0.2,
          "emptyCaseWeight": 0.2,
          "purchaseDefault": true,
          "menuDefault": false,
          "pickBy": false,
          "isRawWeighted": false,
          "currency": "CAD",
          "price": 89.99
        }
      ],
      "partner": "GP5026",
      "partnerName": "ElectronicsSupplier"
    }
  ]
}

Una vez creados los artículos, ve a Inventory > Items y haz clic en cada artículo para gestionarlo individualmente.

UOM ponderadas (Unidades de medida)

Reescalar elemento ponderado bruto

La función Rescale Base UOM te permite definir una unidad de medida principal basada en peso para artículos que necesitan un seguimiento preciso (productos a granel o sensibles al peso). Activar esta opción garantiza que las mediciones de peso sean coherentes en todas las operaciones de inventario.

Pasos para configurar la unidad de medida base de reescalado

Habilitar reescalar elemento ponderado sin procesar:
- Activa el toggle Rescale Raw Weighted Item en la configuración del artículo; se abrirá el formulario Rescale Base UOM.
Seleccione el tipo de medición:
- Elige entre Metric Unit of Mass, Non Metric Unit of Mass, Metric Unit of Liquid o Non Metric Unit of Liquid.
- Ejemplo: seleccionar Non-Metric Unit of Mass mostrará unidades como “oz” o “lb”.
Seleccione la UOM Base:
- Tras elegir el tipo de medición, selecciona la unidad deseada (“oz”, “lb”…) como UOM primaria basada en peso.
Definir cantidad en UOM Base:
- Introduce la cantidad dentro de la UOM base seleccionada para fijar la medición estándar.
Revisar las UOM existentes:
- El formulario mostrará las UOM actuales que se reescalarán según la UOM base, garantizando compatibilidad.
Confirmar la selección:
- Haz clic en Confirm para guardar la configuración.

⚠️ Nota:

La UOM ponderada seleccionada no puede cambiarse una vez establecida.

Item_import_Template.xlsx

ItemImportSample.csv

Elementos