Guía de integración Bridge - ERP


© 2024 Napse. Todos los derechos reservados.

CONTENIDO


IMPORTACIÓN


Importante:

Desde Bridge Manager no se necesita configuración alguna para la recepción de datos de un ERP.

Los envíos según la administración de entidades de BRIDGE se hacen a Bridge Manager Central y luego de ser correctamente importados se replicarán a las tiendas.

1. Bridge Core Server SOAP.

Los servicios de BCore son expuestos vía SOAP definiendo métodos genéricos que reciben el nombre de la interfaz que agrupa servicios relacionados, y un xml como parámetro, el cual tiene nombre de la operación y parámetros de la misma. Dicho servicio retorna un xml como respuesta. Este xml se recibe como un simple string.

Cada uno de los servicios permite crear o actualizar las entidades mediante la operación "createOrUpdate". A continuación se describen los campos relevantes que sirven para todos los casos y cualquier particularidad será descripta en el punto correspondiente.

Los valores de retorno relevantes son:

Propiedad

Tipo de dato

Descripción

ack

String

Código de respuesta. Si es 0, significa que el servicio se ejecutó exitosamente. Cualquier otro valor indica que ocurrió algún error, en cuyo caso se podrá obtener una descripción del mismo desde la propiedad "message".

message

String

Descripción del error que pudiera haber ocurrido.


Para más especificación respecto a la instalación y creación de proyectos de SOAP UI ver: Como ejecutar servicios de Bridge vía SoapUI (Documentación de capacitación interna Napse)


2. Maestros de artículos y sus complementarios.

Nota:

Es importante destacar que el servicio de maestros de artículos cuanta con dependencias de otros maestros. Por lo tanto en se deberá importar previamente los maestros de marca, proveedor, niveles de jerarquía, unidades de medida, impuesto IVA y depósitos.

En caso de que se envíen artículos con datos de los maestros mencionados como dependencias, se debe considerar que esas referencias se hayan informado previamente a Bridge.

2.1 Marca

Ver Marca del artículo para más especificación respecto a los campos de la entidad.

2.2 Proveedor

Ver Proveedores para más especificación respecto a los campos de la entidad.

2.3 Niveles de jerarquía

Ver Niveles de Jerarquía de los artículos para más especificación respecto a los campos de la entidad.

2.4 Unidades de medida

Ver Unidades de medida para más especificación respecto a los campos de la entidad.

2.5 Impuesto IVA

La creación y modificación de Impuestos Iva, deberá de administrarse desde Bridge Manager Central, accediendo desde la opción del menú "Administración > Artículos > Tipos de IVA".

Ver Administración > Artículos sección "Tipo de IVA" para más especificación respecto a la administración de la entidad.

2.6 Depósitos

Ver Depósitos para más especificación respecto a los campos de la entidad.

2.7 Maestros de artículos

Ver Maestros de artículo para más especificación respecto a los campos de la entidad.

2.8 Complementarios

Estos servicios tienen dependencia de otro maestro (ítems). En caso de que se envíen artículos para ser definidos del tipo stock, códigos de barras asociados a artículo, artículos para ser enlazados o linkeados, artículos para ser relacionados, o en caso de que se envíen listas de precios, los artículos se deben haber informado previamente a Bridge. 

  • Artículos de tipo stock

Ver Artículos de tipo stock para más especificación respecto a los campos de la entidad.


  • Códigos de barras

Se validará que el código de barras no exista asociado a otro ítem.

      • Un ítem puede tener N códigos de barra asignados 
      • Un código de barras sólo puede estar asignado a un único ítem (si existe el código se pisa el ítem) 

Ver Códigos de barras para más especificación respecto a los campos de la entidad.


  • Kits/enlazados

Ver Kits/enlazados para más especificación respecto a los campos de la entidad. 


  • Artículos relacionados

Ver: Artículos relacionados para más especificación respecto a los campos de la entidad. 


  • Relación de artículos con proveedores

Ver Relación de artículos con proveedores para más especificación respecto a los campos de la entidad. 


  • Lista de precios de artículos

Ver Lista de precios de artículos para más especificación respecto a los campos de la entidad. 

3. Impuestos.

Ver Impuestos internos por ítem para más especificación respecto a los campos de la entidad. 

4. Stock y abastecimiento.

  • Stock

El servicio de stock tiene dependencias de otros maestros (ítems y depósitos) En caso de que se envíen las unidades en stock, los artículos y depósitos ya se deben haber informado previamente a Bridge.

Consideraciones:

    • Si se trata de una tienda Bridge, la misma debe estar cerrada para que el stock se actualice. 
    • Las reservas realizadas serán dadas de baja
    • Si hubieran artículos serializables o que requieren lote, se deberá enviar el listado completo de series / lotes con stock. 
      • Si hubiera diferencias entre la lista de series / lotes y las cantidades informadas, el stock de ese artículo no será actualizado.
    • No se actualizará el stock de los ítems no informados. Es decir, si la relación entre la tienda/depósito/SKU/estado no fuera enviada en el servicio, el stock de la base de datos no será actualizado

Ver Stock por depósito para más especificación respecto a los campos de la entidad. 

  • Abastecimiento

Servicios que permiten el envío a Bridge de documentos de inventario que luego se podrán acceder desde el menú Inventario.  

    • Documento fiscal

Ver Documento fiscal para más especificación respecto a los campos de la entidad. 


    • Orden de compra

Ver Orden de compra para más especificación respecto a los campos de la entidad. 


    • Pedido de transferencia

Ver Pedido de transferencia para más especificación respecto a los campos de la entidad. 


    • Transferencia

Ver Transferencia para más especificación respecto a los campos de la entidad. 

5. Pagos. 

  • Tender

La creación y modificación de monedas, deberá de administrarse desde Bridge Manager Central, accediendo desde la opción del menú "Administración > Medios de pago > Moneda".

Ver Moneda para más especificación respecto a la administración de la entidad.


  • Cotización de monedas

Este servicio tiene dependencia de otro maestro (tender)

Ver Cotización de moneda para más especificación respecto a los campos de la entidad.

6. Clientes.

  • Cliente de tipo persona

Ver Clientes para más especificación respecto a los campos de la entidad.


  • Cliente de tipo empresa

Ver Tipo de cliente empresa para más especificación respecto a los campos de la entidad.

7. Configuraciones.

  • Usuarios

Ver Usuarios para más especificación respecto a los campos de la entidad.

  • Tienda

Ver Configuración por Tienda para más especificación respecto a los campos de la entidad.

8. Verificación de los envíos del servicio 

Desde el monitor de importación de Bridge Manager Central se podrá revisar si el requerimiento fue importado y su estado.

  • Procesado: todos los registros enviados en el requerimiento se procesaron ok
  • Parcial: de los registros enviados en el requerimiento, algunos pudieran no requerir procesamiento o estar con algún error
  • Error: el requerimiento no se procesa por algún error detectado en el envío


  • Al verificar en Acciones/contenido se podrá ver el requerimiento recibido por Bridge API.
  • Al verificar en Acciones/detalle se podrá ver lo referido al procesamiento del requerimiento.




EXPORTACIÓN


Bridge cuenta con exportación de maestros o entidades. Estos se exportan a colas RabbitMQ y lo que se postea, posee formato JSON.

1. Instalación y configuración de RabbitMQ

1.1. Instalación de RabbitMQ

Ver Bridge v7 - BRIDGE API REST - RabbitMQ - Instalación  para más especificación respecto al proceso de instalación de RabbitMQ sobre Windows.

1.2 Configuración de RabbitMQ

Ver Bridge v7 - BRIDGE API REST - RabbitMQ - Configurar servidor RabbitMQ para manejar conexiones TLS para más especificación respecto a los pasos requeridos para que un servicio RabbitMQ instalado en un server maneje conexiones TLS,

1.3 Exportación de transacciones

Ver Bridge v7 - BRIDGE API REST - RabbitMQ - Exportación de transacciones para más especificación respecto a la exportación de entidades desde BRIDGE mediante el uso de colas RabbitMQ.

1.4 Habilitación de envío de novedades desde Bridge Manager Central.

  • La habilitación del envío de entidades se podrá configuras desde el módulo de Configuración > Colas de exportación. Para cada una de las entidades deseadas, se deberá habilitar la exportación.


  • Se podrá indicar si se envía todo el catálogo o solo novedades desde el módulo de Configuración > Sistema > Exportación.

2. Ventas, devoluciones y cambios.

Ver Detalle de los campos de una transactionRetail para más especificación respecto a los campos de la transacción. 

3. Clientes.

Ver Detalle de los campos de un newCustomer para más especificación respecto a los campos de la entidad.



Check list complementario

Se adjunta un archivo de ayuda para llevar un control de los pasos realizados durante el proceso de integración de Bridge con un ERP

  • Sem rótulos