Conectar Item WMS: enviar pedidos y recepciones, sincronizar productos e inventario

Pida a UNIS su Company ID, Customer ID y Facility ID, complete su usuario y contraseña de Item WMS en Integration, pruebe el inicio de sesión, revise el mapping y active salida, entrada, etiquetas, productos e inventario.

El conector de Item WMS enlaza este sistema con Item WMS (UNIS). Envía pedidos de salida y puede cancelarlos, consulta confirmaciones de pedido y de envío, sube etiquetas de envío, crea y puede cancelar recepciones de entrada, consulta confirmaciones de recepción, importa y busca productos y lee el inventario por artículo (disponible, asignado, dañado, congelado y en mano). Los tres ID que necesita los asigna UNIS: no puede crearlos usted mismo. Una conexión trabaja con los valores de empresa, cliente e instalación que complete.

Requisitos previos#

• Un acceso a Item WMS: un usuario y una contraseña con los que pueda entrar en Item WMS.
• Su Company ID, asignado por un administrador de sistema de UNIS. Pídalo antes de empezar: se envía en casi todas las llamadas a la API.
• Su Customer ID, asignado por Finanzas de UNIS (Finance). Viene de un equipo distinto al del Company ID, así que pídalo a Finanzas por separado.
• Su Facility ID (almacén), asignado por su ITEM CSR. Confirme que es el ID del almacén con el que debe trabajar esta conexión.
• Normalmente no necesita una Base URL: la conexión usa la dirección de producción por defecto. Solo anote una dirección distinta si UNIS le dio un entorno no productivo o especial.

Obtener credenciales#

1. Pida su Company ID a un administrador de sistema de UNIS. Todos los ID de abajo los asigna UNIS: no puede crearlos usted mismo en Item WMS.
2. Pida su Customer ID a Finanzas de UNIS. No reutilice aquí el Company ID: son valores distintos de equipos distintos.
3. Pida a su ITEM CSR su Facility ID, el ID del almacén al que sirve esta conexión.
4. Anote el usuario y la contraseña del acceso a Item WMS para la integración, tal como los usa para entrar en Item WMS.

Completar en Integration#

1. Abra Integration, elija Item WMS e inicie una conexión nueva.
2. username, obligatorio, Username: el usuario de acceso a Item WMS para la integración, por ejemplo your-username.
3. password, obligatorio, Password: la contraseña de ese mismo acceso a Item WMS. Se guarda como secreto.
4. company_id, obligatorio, Company ID: el ID asignado por un administrador de sistema de UNIS, por ejemplo con la forma COMPANY01. Cópielo tal como se lo dio UNIS.
5. customer_id, obligatorio, Customer ID: el ID asignado por Finanzas de UNIS, por ejemplo con la forma CUST001. No es el mismo valor que el Company ID.
6. facility_id, obligatorio, Facility ID (almacén): el ID de almacén asignado por su ITEM CSR, por ejemplo con la forma WH01.
7. base_url, opcional, Base URL: déjelo vacío para usar la dirección de producción por defecto https://wms.item.com/api/public/v1/public. Complételo solo si UNIS le dio una dirección distinta para un entorno no productivo o especial.

Probar la conexión#

Haga clic en Probar la conexión. La prueba inicia sesión de verdad: envía su username y password al endpoint de login de Item WMS y solo aprueba cuando vuelve un token. Aprobar prueba, por tanto, que el usuario y la contraseña son correctos y que la dirección responde. La prueba no hace una llamada de negocio con sus tres ID, así que un Company ID, Customer ID o Facility ID incorrecto puede aprobar la prueba y fallar después, en la primera llamada real de pedido, recepción, producto o inventario. Tras aprobar, verifique los tres ID con una llamada real antes de activar, como se describe en el paso de mapping.

Mapping / elegir plantilla#

Elija el mapping estándar de Item WMS para pedidos, recepciones, productos e inventario, y mantenga los valores de empresa, cliente e instalación de la conexión como los valores enviados en cada llamada. Después verifique antes de activar: envíe o consulte un pedido real y compare número de pedido, líneas y cantidades; haga una consulta de inventario de un producto conocido y compare las cantidades disponible y en mano con Item WMS. Esta comprobación es también la forma de confirmar los tres ID: la prueba de inicio de sesión no puede revisarlos, así que un resultado correcto aquí significa que los ID van juntos y apuntan al almacén correcto.

Activar#

Tras activar, la conexión envía pedidos de salida a Item WMS, manda cancelaciones de pedido, crea recepciones de entrada y cancelaciones de recepción, sube etiquetas y sigue trayendo confirmaciones, confirmaciones de envío y confirmaciones de recepción, mientras las importaciones de productos, las búsquedas y las lecturas de inventario corren por la misma conexión. Vigile los primeros pedidos y recepciones en Runs / Logs y compárelos con Item WMS antes de dejar la conexión sin supervisión.

Tenga presente el alcance: esta conexión cubre el trabajo de salida, entrada, etiquetas, productos e inventario listado arriba, con el alcance de empresa, cliente e instalación que completó. El trabajo de otra instalación u otro cliente necesita sus propios valores: no cambie los ID de una conexión en marcha para cambiar de almacén; cree una conexión separada.

Preguntas frecuentes#

La prueba falla con AUTH_FAILED

El inicio de sesión fue rechazado: Item WMS respondió la llamada de login pero no devolvió ningún token. Eso significa que el usuario, la contraseña o la dirección en uso no coincide: el par de acceso debe ser el propio acceso a Item WMS y base_url, cuando se completa, debe apuntar a la dirección API de Item WMS.

Entre directamente en Item WMS con el mismo usuario y contraseña para confirmar que el par funciona, vuelva a copiar ambos valores sin espacios extra y vacíe base_url salvo que UNIS le haya dado otra dirección. Después pruebe de nuevo.

La prueba aprueba, pero la primera llamada real de pedido o recepción falla

Es el comportamiento esperado cuando un ID está mal: la prueba solo inicia sesión con usuario y contraseña, mientras que las llamadas reales también envían el Company ID, el Customer ID y el Facility ID. Un ID incorrecto o que no combina aprueba la prueba y falla en la primera llamada de negocio.

Compare los tres ID carácter por carácter con lo que emitió UNIS: Company ID de un administrador de sistema de UNIS, Customer ID de Finanzas de UNIS, Facility ID de su ITEM CSR. Corrija el valor incorrecto en la conexión, repita la misma llamada real y confirme que funciona antes de activar.

¿Dónde consigo el Company ID, el Customer ID y el Facility ID?

Los tres ID los asigna UNIS: no puede crearlos usted mismo y vienen de tres fuentes distintas. Buscar en Item WMS una página donde generarlos no funcionará.

Pida a cada fuente su propio ID: a un administrador de sistema de UNIS el Company ID, a Finanzas de UNIS el Customer ID y a su ITEM CSR el Facility ID. Reúna los tres y complételos en la conexión tal como fueron emitidos.

¿Debo completar base_url?

En la mayoría de los casos, no. base_url es opcional: cuando se deja vacío, la conexión usa la dirección de producción por defecto https://wms.item.com/api/public/v1/public. Completarlo con una dirección copiada o adivinada es una causa frecuente de fallos de inicio de sesión.

Deje base_url vacío para el entorno de producción. Complételo solo cuando UNIS le haya dado una dirección distinta para un entorno no productivo o especial, y copie esa dirección tal cual.

Las cantidades de inventario en este sistema no coinciden con Item WMS

La conexión lee el inventario por artículo desde Item WMS: disponible, asignado, dañado, congelado y en mano son cantidades separadas. Una diferencia suele significar que se comparó otro tipo de cantidad, o que el alcance de producto o de instalación difiere entre las dos vistas.

Elija un producto conocido en la misma instalación, compare el mismo tipo de cantidad en ambos lados (por ejemplo disponible contra disponible) y verifique que el código de producto coincide con el artículo de Item WMS. Si ese producto coincide, vuelva a revisar la lista más amplia con el mismo tipo de cantidad.