Saltar al contenido principal

Integración e-commerce

La integración une una tienda en línea con Nadigit IMS. Nadigit IMS sigue siendo la referencia de artículos, precios, impuestos y stock; la tienda le envía sus pedidos.

Qué se sincroniza​

SentidoQué circula
Nadigit IMS → tiendaCatálogo del almacén vinculado (nombre, descripción, categoría, precio, impuesto, imágenes, códigos de barras) y cantidades disponibles. Cualquier variación de stock, venga del punto de venta, de una compra, de una baja, de una transferencia o de una devolución, se comunica a la tienda. Un artículo desactivado o agotado se retira de la venta en línea.
Nadigit IMS → tiendaEstado de los pedidos web: en curso, entregado, anulado, devuelto, y el estado del pago.
Tienda → Nadigit IMSPedidos realizados en línea, registrados como ventas, y sus anulaciones.

Requisitos​

  • El plan Enterprise.
  • En el almacén que venderá la tienda: artículos activos, con precio de venta y stock.
  • Una tienda física de Nadigit IMS a la que vincular las ventas en línea. Así quedan separadas de las ventas del punto de venta en los informes.
  • La tienda en línea y Nadigit IMS deben poder llamarse mutuamente en HTTPS.
  • El rol Administrador.
Una tienda en línea, un almacén

Cada tienda en línea está vinculada a un solo almacén y una sola tienda. Para vender en línea el stock de dos almacenes, cree dos integraciones.

Plataformas​

PlataformaConector
BagistoConector suministrado por Nadigit
Shopify, WooCommerce, PersonalizadaUn conector desarrollado sobre la API de integración

Conectar una tienda en línea​

1. Declarar la tienda​

  1. Abra Configuraciones del Sistema → Configuraciones Globales, pestaña Integraciones, y luego Integraciones de e-commerce.
  2. Haga clic en Nueva integración y rellene:
    • la Plataforma y un Nombre;
    • la URL de la tienda, su dirección pública;
    • el Almacén y la Tienda vinculados, obligatorios antes del aprovisionamiento;
    • la Ruta del webhook, la dirección en la tienda que recibe las notificaciones de Nadigit IMS. El valor propuesto sirve para el conector Bagisto;
    • el Secreto del webhook (HMAC): déjelo vacío, el aprovisionamiento lo genera.
  3. Haga clic en Guardar.

2. Aprovisionar el conector​

En la lista, haga clic en Aprovisionar conector en la fila de la tienda. Nadigit IMS crea la identidad del conector: una cuenta técnica que solo accede a la API de integración, y solo para el almacén y la tienda vinculados.

La ventana Configuración del conector muestra entonces:

  • la dirección de Nadigit IMS y la dirección para obtener los tokens;
  • el identificador y el secreto del cliente;
  • el secreto del webhook.
Copie la configuración de inmediato

La ventana avisa de que los dos secretos solo se muestran en ese momento: haga clic en Copiar JSON y guárdelo en un lugar seguro hasta el paso siguiente. El aprovisionamiento puede repetirse sin riesgo: no cambia ni la cuenta del conector ni sus secretos.

3. Instalar el conector en la tienda​

Para Bagisto:

  1. Instale en la tienda el conector suministrado por Nadigit.
  2. En la administración de Bagisto, abra Configure → ERP Connector e importe el JSON copiado en el paso 2.
  3. Guarde y haga clic en Test Connection.
Para el administrador de la tienda Bagisto

La extensión PHP intl debe estar activa. Tras instalar el conector, vacíe la caché de la aplicación (php artisan optimize:clear): si no, los pedidos no se transmiten.

4. Verificar​

De vuelta en Integraciones de e-commerce, la fila de la tienda muestra Aprovisionado. El botón Probar conexión comprueba que Nadigit IMS accede a la tienda, y la columna Última sincro muestra el último intercambio en cada sentido: Entrante (tienda → IMS) y Saliente (IMS → tienda).

Pedidos en línea​

  • Precios e impuestos recalculados. Nadigit IMS recalcula cada pedido con sus propios precios e impuestos. Si el total de la tienda difiere, el pedido se registra igualmente, con un aviso de diferencia de precio. Para evitarlo, alinee los impuestos de la tienda con los de Nadigit IMS.
  • Stock. El pedido descuenta el stock del almacén vinculado.
  • Cliente. El cliente se encuentra por su correo, o se crea.
  • Pago. Un pedido pagado al comprar (tarjeta, billetera o pasarela de pago como Stripe o PayPal, transferencia) se registra pagado. Un pedido contra reembolso queda impagado hasta el cobro.
  • Anulación. Un pedido anulado en la tienda devuelve su stock. El reembolso eventual se hace manualmente.
  • Sin duplicados. Un pedido reenviado por la tienda, por ejemplo tras un corte, nunca se registra dos veces.

Buenas prácticas​

  • Modifique el catálogo en Nadigit IMS, no en la tienda: Nadigit IMS es la referencia, y sus cambios se envían a la tienda.
  • Tras la puesta en marcha, compruebe algunos artículos en la tienda: precio, impuesto, stock e imágenes.
  • Alinee los impuestos de ambos lados antes de abrir la venta en línea.
  • Eliminar una integración detiene de inmediato la sincronización con esa tienda.

Ver también​

Última actualización en