Ejemplo:

• Cuando Teamplace tiene novedades sobre productos, artículos y sus complementos como marcas o proveedores, entonces es el encargado de enviar esa creación o actualización a Bridge a través de los servicios de integración via SOAP.
• Por su parte, si Bridge tiene tickets, notas de crédito, clientes y otros movimientos de abastecimiento, es quien se encarga de impactar en Teamplace.

Habrá datos o configuraciones para las cuales se requerirá utilizar una codificación común de acuerdo con las necesidades de los proyectos.
Por ejemplo, en los maestros de datos como provincias, localidades, medios de pagos, impuestos, tipos de transacciones, etc.
Esquema general de funcionamiento:

Ejemplo de importaciones desde el ERP a Bridge
 

Ejemplo para las exportaciones de ventas o clientes

A continuación, se detallan los maestros y transacciones a ser integradas entre ambos sistemas:

Considerar que los datos incorporados por Script de Set Up, a posterior de la instalación deben mantenerse manualmente entre ambos sistemas.

A partir de Bridge v7, se implementan nuevos servicios de integración que Bridge consumirá de la API de Teamplace:
URL https://test.teamplace.finneg.com/BSA/api/docs?key=5d5942575f42

Para utilizar los servicios de exportación de transacciones y operaciones al ERP es necesario configurar previamente diversos parámetros en Bridge Manager Central. El objetivo de contar con estos parámetros es realizar la transformación necesaria de datos a fin de generar el formato JSON que espera recibir el ERP.
Los parámetros de exportación se dividen en categorías, de acuerdo con los servicios de salida correspondientes a Ventas, Clientes, Stock, Casos y Tesorería, que también se los denomina 'entidades'.
La configuración de estos parámetros, para cada uno de los grupos, se puede realizar en Bridge Manager Central desde la opción de menú 'Configuración->Sistema-> Exportación' y luego seleccionando la entidad a configurar.
Para identificar un parámetro de manera unívoca, ya que un mismo nombre puede ser utilizado por más de un servicio, se emplea el uso de prefijos para los mismos.

En las secciones siguientes se detallan los prefijos y los parámetros especificados para cada una de las entidades
Nota: Los valores de los parámetros son provistos por Finnegans por proyecto.

Especificación funcional: https://share.linx.com.br/x/vwDyCQ

Mejora de la configuración (a partir de v7.1): https://share.linx.com.br/x/HVhNCw

EJEMPLO DE CONFIGURACIÓN DE PARÁMETROS

Antes:

• teamplace.globalAPI.oauth: https://8.teamplace.finneg.com/BSA/api/oauth/token
• teamplace.puntoVentaAPI.URL: https://8.teamplace.finneg.com/BSA/api/puntoVentaIntegraciones

• Ej.: 

  • URL para obtener token: https://test.teamplace.finneg.com/BSA/api/oauth/token
  • URL para casos: https://test.teamplace.finneg.com/BSA/api/reports/apicasos
  • URL para clientes: https://test.teamplace.finneg.com/BSA/api/cliente
  • El común de todos los parámetros es: *https://test.teamplace.finneg.com/BSA/api/* 

-------------------------

Con la mejora:

Los endpoints no llevan barra al principio y el host principal termina con una barra.

• teamplace.globalAPI.URL: https://8.teamplace.finneg.com/BSA/api/ → parámetro para configurar la URL completa
• teamplace.puntoVentaAPI.URL: puntoVentaIntegraciones → servicio API específico de informe de facturas
• teamplace.globalAPI.oauth: oauth/token → servicio API específico para obtener el token
• teamplace.globalAPI.grant_type: client_credentials → servicio API específico para obtener

Token

Los siguientes parámetros son comunes para todos los servicios y se utilizan para realizar el acceso y la autenticación a cada servicio del ERP, luego de obtenido este token se utiliza el mismo en cada llamado. Si el token expirara, API debería solicitar uno nuevo.

Client ID: 834c10ffc4568026c1ff6d6d09f79937
Secret Key: ca66889088156ee98f8fd077746f4489
Ejemplo para la solicitud del token
https://8.teamplace.finneg.com/BSA/api/oauth/token?grant_type=client_credentials&client_id=e99acd8736d02f29ce41dfe9600e1351&client_secret=bb09e6d751ac509a78688e54a11e97cb

Configuraciones generales

Existen parámetros utilizados por varios servicios de la API, con lo cual los mismos se encuentran definidos en la categoría "Teamplace Configuración global"

Códigos de tienda y depósitos de transito

Estos registros se generan en la instalación del servidor de tienda.

Códigos de moneda

Es configuración inicial cuando es una instalación con integración Teamplace.

Códigos de impuestos

Estos parámetros son utilizados para informar los impuestos del cliente de IIBB

Códigos de tipo de impuestos

Estos parámetros son utilizados para informar los impuestos del cliente de IIBB

Parámetros generales de api ventas

Parámetros por tipo de documento

Parámetros para informar la partida financiera y centro de costo del artículo

Dependiendo la configuración en Teamplace de la distribución de las partidas financieras y centro de costo de los artículos, se podrá enviar esta información con la configuración de estos dos parámetros para la partida financiera (estos son a nivel compañía)

• dimensiónCodigo
• distribuciónCodigo

Ejemplo:

 "DimensionDistribucion" : [{
                        "dimensionCodigo" : "DIMPARFIN",
                        "distribucionCodigo" : "INGMIN",
                        "tipoCalculo" : "0",
                        "distribucionItems" : [{
                                "codigo" : "INGMIN",
                                "porcentaje" : 100,
                                "importe" : 112.4
                            }]

• El tipo de cálculo 0 indica porcentual (siempre se envía el 100%)
• El código que se informa dentro de distribuciónItems a nivel partida financiera
• La distribución y dimensión para el centro de costo

• La configuración para el centro de costo es por tienda (se genera el parámetro al instalar la nueva tienda) Este es el código que viaja dentro de distribuciónItems del centro de costo junto con el porcentaje e importe

Ejemplo:						{
                        "dimensionCodigo" : "DIMCTC",
                        "distribucionCodigo" : null,
                        "tipoCalculo" : "0",
                        "distribucionItems" : [{
                                "codigo" : "OLIV1",
                                "porcentaje" : 100,
                                "importe" : 112.4
                            }]

Códigos de artículos descuentos

Configuración para postventa

Códigos de iva a nivel producto

Parámetros generales de api movimientoFondo

Para informar las operaciones de caja realizadas desde la tienda (ingresos o egresos) se debe tener configurado el código de la caja de tienda (SAFE) y la cuenta externa a la cual se transfiere o desde la cual se transfiere a tienda.

• Cuenta externa: es la cuenta a la cual se transfiere o desde la cual se recibe fondos. El código de la misma es el enviado al ERP en la exportación de la operación.
• La cuenta externa debe estar configurada como "requiere número de comprobante" ya que es un requerimiento para la operación de parte del ERP.

Parámetros

Parámetros

Parámetros generales de api clientes

Códigos de identificaciones

Códigos de tipo de domicilio y de categorías de IIBB del cliente empresa

Parámetros

Este se podrá acceder desde el menú Monitoreo/Monitor de exportación desde BMC

Filtros de búsqueda para el monitor de exportación

El monitor de exportación cuenta con filtros que facilitarán la búsqueda de registros de exportaciones. En algunos casos son comunes a todas las entidades, otros son para algunas entidades en particular.

El resultado de registros se listará por la columna "Actualización" que indica la fecha y hora de última actualización del registro de exportación.

Filtros y entidades de exportaciones de operaciones del POS

Operaciones de venta, devolución, cambio, cliente, cobranzas, casos, evidencias, operaciones de caja (ingresos y egresos)

• Tienda
• Terminal
• Transacción
• Entidad: según listado
• Destino
• Estado
• Fecha desde y hasta

Las entidades de exportaciones de operaciones generadas en el punto de venta son:

Filtros y entidades de exportaciones de operaciones de caja del BM

Las entidades de exportaciones de operaciones de caja son:

Filtros y entidades de exportaciones de operaciones de inventario

En los tipos de exportaciones de documentos de abastecimiento se podrá identificar a la tienda y el nro. de formulario.
Documentos de abastecimiento:

• Tienda
• Formulario
• Entidad
• Destino
• Estado
• Fecha desde y hasta

Las entidades de exportaciones de operaciones de inventario son:

Estado de las exportaciones

Las exportaciones podrán tener diferentes estados.

En el caso de las entidades que salen hacia Teamplace podrán estar:

• Pendiente: aún no se ha enviado el requerimiento
• Error: se ha enviado el requerimiento o reintentado el envío 3 veces y se dio un error recibido del ERP o interno de la exportación
• Procesado: se envió el requerimiento y el ERP respondió con un ok

Destino de las exportaciones

Hay varios destinos diferentes:

• Teamplace: el ERP hacia el cual se envían operaciones que movilizan fondos y stock
• Promo: envío de catálogos de Bridge para el uso en la definición de promociones
• Queue: colas rabbit
• Mirgor: para envio de pedidos generados

Acciones: Contenido

Para controlar el contenido del requerimiento de exportación hacia el ERP, se podrá utilizar la acción de cada registro "Contenido".

• La cabecera indica la entidad de la exportación y datos generales de la misma.
• El detalle/notas: informa el estado de respuesta del ERP. Cuando se procesa correctamente, el ERP responde con un código de status=200 y el nro de identificación de la operación.

• El detalle/contexto: informa los datos que identifican a la operación en Bridge, como la tienda, terminal, nro de transacción

• El detalle/request: informa todo el requerimiento generado según el tipo de entidad de la exportación.

Contenido de una exportación en error

• Detalle/notas: se informa el error y la fuente que responde el mismo.

En el caso de ser Teamplace se informan los errores con status = 500 y su descripción.

Reproceso

Si el registro de exportación quedara en estado "error", el mismo se podrá "reprocesar" dejando al registro en DataExport como "pendiente" que luego el proceso de exportaciones de Bridge API tomará nuevamente el registro con los valores de parámetros y lo enviará con los 3 reintentos al ERP.
Este proceso podrá ser masivo al indicar con un check más de un registro en error y seleccionando el botón "Reprocesar".

En las exportaciones de las entidades hacia Teamplace se pueden dar diferentes tipos de errores. Se listan los comunes y como analizar el posible problema

Los status recibidos y procesados por Bridge API son:

{
    "id" : "00OLIV0004010122",
    "message" : "created",
    "status" : 200
}

Ejemplos

#	Error	Origen	Detalle	Análisis
1	Sale { "status" : 500, "error" : "Internal Server Error: Se ha producido un error \n\tLa identificacion externa 00OLIV0006009166 ya existe para otra transaccion", "source" : "Teamplace" }	Teamplace	Es una transacción que fue procesada anteriormente ya por Teamplace. Origen: cuando hay problemas de comunicación con el ERP (ej: red) la transacción se reintenta hasta 3 veces. Si en algún momento Teamplace la procesa pero la respuesta no llega a BRIDGE, con el próximo envío se puede recibir este mensaje de que ya fue procesada previamente pero BRIDGE no habia recibido el ok	Si bien en el monitor de exportaciones figurará con "error" ya fue procesada por el ERP Solución: N/A Si se quisiera dejar como "Procesado" en el monitor de exportaciones se debería realizar un update en dataExport.status de "error" a "ok"
2	Sale { "status" : 500, "error" : "Internal Server Error: Parámetro obligatorio \n\tDebe indicar un depósito para el producto BLD ALMOHADON GASA DOBLE 35X50.", "source" : "Teamplace" }	Teamplace	Respuesta del ERP por falta de un dato a informar de un producto. En el ejemplo es un almohadon que dentro de la venta no informa su depósito de origen Origen: API toma del TLOG de la venta la información del depósito del tag Este tag sólo se guarda en TLOG cuando el item es del tipo StockItem.	REQUEST: { "ProductoCodigo": "BLD-LAUREL/ALTS", "Precio": "2148.7603", "Cantidad": 1, "Descripcion": "BLD ALMOHADON GASA DOBLE 35X50", "DepositoDestinoCodigo": null, Transacción: "storeCode" : "OLIV", "terminalCode" : "4", "trxNumber" : 10130, Verficar el TLOG de la venta Al buscar en el tlog, para el articulo BLD-LAUREL/ALTS no se encuentra el tag "itemTIcketListInformationList" Solución: Modificar el TLOG en la tabla transaction (en BMC). Hay que agregar el tag "ItemTIcketListInformationList" de otro artículo de la misma venta al nivel del campo "reserved" : false, Luego reprocesar la venta desde el monitor de exportaciones ABM artículos: Configurar el item como stockItem
3	Customer { "status" : 500, "error" : "Internal Server Error: Error genérico de BSuite \n\tEl número de identificación D.N.I. (ML) 14026145 se encuentra configurado en el Cliente CLAUDIA ELIDA NOCITO.", "source" : "Teamplace" }	Teamplace	Respuesta del ERP de que el cliente ya existe con el nro de identificación informada con otro código de cliente Origen: API envía el código de cliente, tipo y nro de identificación en el request de customer. Si el cliente fue dado de alta con otro código que difiere al que tiene el ERP para el mismo nro de documento lo rechazará.	Solución: modificar el código de cliente en BRIDGE BMC, tabla party.code con el que tiene el ERP cargado. Luego editar el cliente para que sea replicado ese código al resto de las tiendas reprocesar el request customer para que tome el nuevo código detectar la venta asociada a ese cliente y modificar en BMC la transaction en party.code con el mismo código modificado para el party para que la venta pueda ser procesada con el código de cliente esperado po rTeamplace.
4	Sale { "status" : 500, "error" : "Internal Server Error: Error genérico del método prepareSaveFromSerialization de EntidadHLP. \n\tNo se encontró la Secondary Key asociada, con los valores: Tabla: BSOrganizacion, campoPK: OrganizacionID, campoSk: Codigo, valorSk: 0330685281550OLIV.", "source" : "Teamplace" }	Teamplace	Origen: El cliente asociado a la venta no se encuentra en el ERP importado Esto pudiera darse porque dió un error la exportación del cliente enviado previamente	Solución: revisar si la exportación del cliente quedó en error. Reprocesarlo y de exportarse ok, se podrá reprocesar la venta
5	Sale o return { "status" : 500, "error" : "Internal Server Error: Error genérico de BSuite \n\tFalta especificar la operacion bancaria", "source" : "Teamplace" }	Teamplace	Origen: uno de los medios de pago no está informando en el requerimiento el código de operación bancaria API toma este valor del código de medio de pago del TLOG y lo busca en la tabla de medios de pago de exportación. Alli tiene que estar definido el medio de pago con el CODIGO ERP que espera el ERP.	Solución: Verificar en el menú de BMC Configuración/medios de pago de exportación si se encuentra bien configurada la relación Medio de pago, cantidad de cuotas y código ERP Si no existe configurarlo Si existe y es correcto o si fue editado con el valor correcto, reprocesar la venta NOTA: si existe un código ERP particular para una cantidad de cuotas se debe generar el registro con ese nro de cuotas, sino configurar con CUOTAS = 0 que es el default para todo lo que no es particular. En el caso de medios de pago que no tienen plan de cuotas (ej: cupones, giftCard), SIEMPRE debe ir con cuotas = 0
6	Sale o return { "status" : 500, "error" : "Internal Server Error: Error genérico del método prepareSaveFromSerialization de EntidadHLP. \n\tNo se encontró la Secondary Key asociada, con los valores: Tabla: BSOperacionBancaria, campoPK: OperacionBancariaID, campoSk: Codigo, valorSk: OTRO.", "source" : "Teamplace" }	Teamplace	Origen: el ERP valida el código de operación bancaria del medio de pago informado en el request y lo rechaza si no lo tiene definido	Solución: Solicitar el código ERP del medio de pago de Teamplace Actualizar en configuración/medios de pago de exportación con el código que provea Teamplace para el medio de pago Reprocesar la venta
7	{ "error" : "Cannot read property 'startsWith' of undefined", "stack" : ["TypeError: Cannot read property 'startsWith' of undefined", " at TeamplaceTransactionRetail.getTypeTransaction (C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\teamplaceTransactionRetail.js:905:37)", " at TeamplaceTransactionRetail.<anonymous> (C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\teamplaceTransactionRetail.js:865:35)", " at Generator.next (<anonymous>)", " at C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\teamplaceTransactionRetail.js:8:71", " at new Promise (<anonymous>)", " at __awaiter (C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\teamplaceTransactionRetail.js:4:12)", " at TeamplaceTransactionRetail.export (C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\teamplaceTransactionRetail.js:863:16)", " at C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\transactionRetail.export.js:30:87", " at Generator.next (<anonymous>)", " at fulfilled (C:\\napse\\bridge\\bridgeapi\\dist\\services\\export\\teamplace\\transactionRetail.export.js:5:58)", " at runMicrotasks (<anonymous>)", " at processTicksAndRejections (internal/process/task_queues.js:95:5)"] }	API	Origen: algun valor en TLOG que API no puede interpretar. En este caso no tiene el tipo de transacción	Revisar TLOG
8	{ "status" : 500, "error" : "Internal Server Error: Genérico del servicio de cuentas corrientes \n\tNo hay 840.00 disponible para el item de la cuenta DEUD VENTA MINORISTA.", "source" : "Teamplace" }	Teamplace	Origen: Existen diferencias en los montos informados que pueden rechazar la venta. Teamplace no recalcula el iva pero si valida que la suma de productos + iva = o menor a los pagos	Solución: Revisar TLOG con los datos enviados en el request y ver si la suma de los items (producto.precio) + conceptos.conceptoImporte (de cada tipo de iva) = suma de pagos (PuntoVentaItemsTarjeta.ImporteACobrar o PuntoVentaItemsEfectivo.ImporteACobrar)
9	{ "status" : 500, "error" : "Internal Server Error: Error genérico de BSuite \n\tjava.lang.NullPointerException", "source" : "Teamplace" }	Teamplace	Origen: error al procesar Teamplace	Solución: Revisar con equipo de soporte de Teamplace

Para el seguimiento de las importaciones, se cuenta con un monitor. Este será un listado de cada entidad que se importe desde el ERP y desde las tiendas.
Este se podrá acceder desde el menú Monitoreo/Monitor de importación

Por cada instalación nueva se deben considerar las siguientes configuraciones:
Desde Bridge Manager Central

• • URL Teamplace
  • URL Promo
  • URL Bridge Manager
  • URL de Fiscal Flow
  • Directorio de logs
  • ClientID
  • SecretID
  • Crear cuenta externa para las operaciones de caja con el código de cuenta que espera el ERP
  • Configurar los parámetros depósitos en tránsito (parámetros globales)
  • Configurar los parámetros de exportación (URL de TP)
  • Configurar los códigos ERP de los depósitos en BMC (depósitos-tienda)
  • Configurar los códigos de los medios de pago de exportación
  • Configuración de usuarios centralizados

Desde Bridge Manager tienda

• • Crear terminales desde cada tienda
  • Directorio de logs
  • Configurar las URL de los servicios para postventa y comisiones

Depósitos de los artículos

Para configurar el código a enviar para los artículos, se debe definir en BMC desde Administración/artículos/depósitos el código del depósito correspondiente a cada tienda. Esto luego replicará a las tiendas.

• Desde Teamplace deben enviar el depósito asociado al item (ej: DEP 1) Este será el mismo código para toda tienda.

• Al editar un depósito, se podrá definir cual es el código que se utilizará para informar al ERP Teamplace según corresponda a la tienda de la operación generada.
• El campo a configurar es "Codigo ERP"
• Por cada tienda deberá existir un registro con su respectivo código ERP

Caja de tienda – safe

Para las operaciones de caja (ingresos y egresos) se requiere configurar el código de la caja de tienda. Esto es mediante el siguiente parámetro de exportación Teamplace tesorería:

• teamplace.movFondoAPI.CUENTACODSAFE

Categorías Fiscales

Las categorías fiscales asociadas a clientes deben informarse con los códigos del ERP. En el setup de Bridge Manager al indicar que se utilizara el ERP se actualizan en la tabla: TaxJurisdictionTaxTypeCategory por lo que no son manejados desde la configuración de exportación.

• Si se requiere cambiar la configuración del código de categoría impositiva a enviar, se debe ajustar en el menú de Administración/Impuestos/Categorías impositivas de BMC. Esto luego replica a las tiendas.

Configuraciones impositivas

En Bridge se deberán configurar las reglas impositivas de acuerdo a la condición de agente de percepción del retailer/tienda.
En la configuración de la tienda, en el caso en el cual la tienda deba percibir ingresos brutos o IVA, deberá encontrarse habilitada y luego contar con las reglas impositivas para su cálculo (con porcentaje de alícuota por defecto o la informada para el cliente de parte de Teamplace, con el servicio Customer de Bridge o servicio Padrón en el caso de existir el cliente ya en Bridge)

• Parámetros de exportación Teamplace global

Situación IIBB - clientes

Cuentas externas

Para las operaciones de caja (ingresos y egresos) se requiere el alta de la cuenta externa, con el código que requiere recibir Teamplace.
También debe tener configurado "Requiere ingreso del nro de comprobante" ya que es un dato que se debe enviar en la exportación de la operación de tesorería

Descuentos a nivel artículo

Al realizar un descuento a un ítem de la venta, se envía un ítem de descuento al ERP. El código de este ítem lo toma del Parámetro de exportación Teamplace ventas:

• teamplace.puntoVentaAPI.PRODUCTODESCTOTAL

Descuentos a nivel transacción

Al realizar un descuento a nivel transacción se envía en un ítem al ERP. El código de este ítem lo toma del Parámetro de exportación Teamplace ventas:

• teamplace.puntoVentaAPI.PRODUCTODESCUENTO

Identificación

La identificación asociada a clientes debe informarse con los siguientes códigos. Estos valores se encuentran en los parámetros de exportación.

Medios de Pago

Para que el ERP identifique los medios de pago utilizados en las transacciones de Bridge es necesario asociarlos mediante un código de correspondencia entre ambos sistemas.
En el setup de Bridge se crea la tabla "tenderRules" la cual contiene dicha asociación. De esta manera cuando Bridge genere la exportación de una transacción que involucre medios de pagos tomara de esta tabla el código correspondiente que procesará el ERP.
En el caso de agregar un nuevo medio de pago a Bridge es necesario solicitar a Finnegans que creen el mismo en el ERP e informen el código correspondiente al equipo de Bridge para su configuración. Luego se debe generar un nuevo registro en la tabla "tenderRules" para registrarlo.

ABM de medios de pago de exportación

Para poder configurar la asociación del medio de Pago Bridge con el código de medio de pago requerido por Teamplace, se podrá acceder desde el menú Configuración/Medios de pago de Exportación.
Esta configuración debe encontrarse definida en BMC que es desde donde se exportan las ventas/devoluciones.

Nuevo medio de pago de exportación

Se podrá crear una nueva relación, mediante el botón "Nuevo"

Los campos a configurar serán:

• Medio de pago: se listan todos los medios de pago disponibles (tabla "tender")
• Cuotas: indica la cantidad de cuotas (para aquellos medios de pago con planes de cuotas) o se debe configurar en "0" si aplica a todas las cuotas o el medio de pago no lo requiera (ej: pesos).
  • En la exportación para obtener el código del medio de pago se buscará si existe un registro con la cantidad de cuotas específicas. Si no lo hubiera toma el de cuotas = 0.

  • Ejemplo:

    Medio de pago	Cuotas	Código ERP	Observaciones
    Visa	0	VISA	Se enviará este código para el medio de pago con cualquier cantidad de cuotas a excepción que exista una relación específica de una cantidad de cuotas.
    Visa	1	VISA2	Si el medio de pago en la venta tiene 1 cuota enviará este código al ERP.
    Cash	0	EFVOPESOS	Como el medio de pago no contiene cuotas, se define con 0.

    
    Todos los campos son requeridos y se validará la relación única Medio de pago-Cuotas (no podrán ser repetidos)
    Ej: en caso de que se configure una relación ya existente, se informará mediante este mensaje:
    "Código ya existente o tipo de medio de pago ya configurado"
    El medio de pago de exportación se podrá editar o eliminar su relación.

    
    
    

    
    

• Mediante el botón de Acción "Editar" sobre el registro seleccionado:

• Mediante el botón de Acción "Eliminar" se elimina el registro sin solicitar confirmación.

Moneda

Para la configuración de exportación de una nueva moneda, se debe agregar un registro en la tabla systemConfiguration del Bridge Manager Central. Estos registros deben pertenecer a la categoría "Teamplace global", con el prefijo 'teamplace.globalAPI.MONEDA', luego con el punto y el código ISO.
En el siguiente cuadro se puede apreciar cómo se deben configurar los parámetros de exportación de la categoría ventas para la nueva Divisa.

También debe agregarse un registro en la tabla TENDERRULES (relaciona los medios de pago Bridge con los códigos de Teamplace). Los parámetros Installment y ERPCode son definidos por Teamplace.

País, Provincias y Localidades

Los códigos de país, provincias y localidades que espera recibir el ERP se encuentran previamente configurados en las tablas de Bridge al momento del setup o instalación del mismo.
Ver tablas: STATE (provincias) y CITY (localidades)
Estas tablas contienen los códigos de Teamplace

Productos e ítems por default

Los productos o ítems por defecto serán aquellos que son utilizados con propósitos generales en las operaciones entre ambos sistemas. Entre estos productos se pueden mencionar, ítems de redondeo, de recargo, etc.
Estos ítems se utilizan en las operaciones ya se para el cálculo de un redondeo sobre la operación total, el recargo a una operación ya sea por la utilización de un medio de pago en particular u otros factores, el descuento sobre ítems o la misma operación causada por la aplicación de una promoción, un descuento fijo o porcentual.
Estos ítems, se darán de alta en el setup inicial del BM cuando se utilice la opción de integración con Teamplace. No obstante los códigos para identificar a estos productos o ítems deben ser los mismos con lo que el propio ERP lo identifica internamente.
Es importante tener en cuenta que, para la versión actual, estos productos o ítems no deben ser sincronizados via interface WS ya que pueden causar en bridge la desconfiguración de los mismos y por ende un funcionamiento no deseado.
ARTÍCULOS PARTICULARES

Usuarios entre ambos sistemas

La integración para esta entidad es mediante el servicio de integración de Bridge: "user"
Bridge usa SHA-1 Y MD5, esto es configurable por el cliente. Del lado de Teamplace están utilizando SHA-1, por lo que de momento debe utilizarse esta encriptación en la instalación de Bridge Manager.
Para la integración con Teamplace se utilizará la funcionalidad de usuarios centralizados.

Para informar nuevos clientes o actualizaciones. Este request será enviado previo a la venta a la cual se encuentra asociada para que Teamplace lo cree y luego se pueda procesar la venta con el cliente asociado, caso contrario la venta se procesará con error.
En el monitor de exportación, se podrá visualizar un registro del tipo NewCustomer

Ejemplo request JSON de transacción de cliente persona física

{
"url": "https://test.teamplace.finneg.com/BSA/api/cliente?ACCESS_TOKEN=a7cc7730-2b4c-4079-9a35-9445692a0ef6",
"method": "POST",
"params": {
"Nombre": "Nestor Ortigoza",
"Codigo": "01000256895637390",
"Activo": true,
"RazonSocial": "Nestor Ortigoza",
"Descripcion": null,
"Email": null,
"CategoriaFiscalCodigo": "CF",
"IdentificacionTributariaCodigo": "DNI",
"IdentificacionTributariaNumero": "25689563",
"ConceptoClienteCodigo": "CLI",
"CuentaClienteCodigo": "CLI",
"EsProveedor": false,
"RestriccionCondPagos": null,

"CondicionesPago": [

{
"CondicionPagoCodigo": "CE",
"Default": true
}
],
"USR_FechaNacimiento": "",

"Direcciones": [

{
"PaisCodigo": "ARG",
"ProvinciaCodigo": "JJY",
"LocalidadCodigo": "JJY_0049",
"CodigoPostal": "",
"Calle": "Cabildo",
"Numero": "1234",
"Dpto": null,
"Piso": null,
"Tipo": "1",
"Descripcion": null,
"Principal": true
}
],

"Telefonos": [

],
"SituacionIIBB": "",
"NroInscripcionIIBB": "",

"Percepciones": [

]
}
}

Ejemplo request JSON de transacción de cliente empresa

{
"url": "https://test.teamplace.finneg.com/BSA/api/cliente?ACCESS_TOKEN=eaca70f8-c652-4c72-a143-0fe31b4050f0",
"method": "POST",
"params": {
"Nombre": "Percepcionado S.A",
"Codigo": "03305682263877390",
"Activo": true,
"RazonSocial": "Percepcionado S.A",
"Descripcion": null,
"Email": null,
"CategoriaFiscalCodigo": "RI",
"IdentificacionTributariaCodigo": "CUIT",
"IdentificacionTributariaNumero": "30-56822638-7",
"ConceptoClienteCodigo": "CLI",
"CuentaClienteCodigo": "CLI",
"EsProveedor": false,
"RestriccionCondPagos": null,

"CondicionesPago": [

{
"CondicionPagoCodigo": "CE",
"Default": true
}
],
"USR_FechaNacimiento": "",

"Direcciones": [

{
"PaisCodigo": "ARG",
"ProvinciaCodigo": "CAT",
"LocalidadCodigo": "CAT_0026",
"CodigoPostal": "",
"Calle": "alvear",
"Numero": "111",
"Dpto": null,
"Piso": null,
"Tipo": "1",
"Descripcion": null,
"Principal": true
}
],

"Telefonos": [

],
"SituacionIIBB": "0",
"NroInscripcionIIBB": "343434",

"Percepciones": [

{
"TipoRetencionCodigo": "PERCCABA",
"RetencionCodigo": "PIBCABA",
"FechaDesde": "2020-08-01",
"FechaHasta": "2020-08-31",
"Porcentaje": 0,
"Modo": 0,
"MomentoAplicacionCodigo": 1,
"Motivo": null
}
]
}
}

Cuando se venda o devuelva una GiftCard el cual genera un recibo o una devolución de recibo se generará una cobranza hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "Sale" o "Return"

Ejemplo request JSON de transacción de venta o devolución de una gift card cuando se genere un recibo

{
"url": "https://1.teamplace.finneg.com/BSA/api/cobranzaMirgor?ACCESS_TOKEN=fef8c5b5-1c9c-4565-87a0-c2842ed830a3",
"method": "POST",
"params": {
"IdentificacionExterna": "0000010025001508",
"EmpresaCodigo": "1",
"NumeroComprobante": "B-0025-00001508",
"Cliente": "010002636491601",
"TransaccionTipoCodigo": "OPERTESORERIA",
"TransaccionSubtipoCodigo": "COBRANZA",
"Fecha": "2020-08-14",
"Nombre": "",
"DiferenciaCambio": 0,
"UsaCotizacionOrigen": null,
"Descripcion": "",
"CajaCodigo": "",
"CobradorCodigo": "",
"WorkFlowCodigo": "COB",

"Banco": [

],

"Efectivo": [

{
"CuentaCodigo": "11120010",
"DebeHaber": 1,
"ImporteMonTransaccion": "1000.0000",
"MonedaCodigo": "ARS",
"Descripcion": "",

"DimensionDistribucion": [

]
}
],

"Tarjeta": [

],

"Otros": [

],

"Retenciones": [

],

"Cotizaciones": [

],

"CtaCte": [

{
"CuentaCodigo": "CLI",
"DebeHaber": -1,
"ImporteMonTransaccion": 1000,
"ImporteMonPrincipal": 1000,
"MonedaCodigo": "ARS",
"Descripcion": "",
"AplicacionOrigen": "",

"DimensionDistribucion": [

]
}
]
}
}

POS en integración con Teamplace

Bridge POS utiliza una serie de indicadores para habilitar las acciones a ser realizadas:

●Equipo revisado.
●Incluye repuestos.
●Presupuesto aprobado.
●Equipo reparado.

En Teamplace se configura el workflow de actividades que requiera el cliente para la gestión de la reparación, activando los indicadores requeridos para habilitar los pasos a realizar en el POS.

Escenarios cubiertos

Caso 1: Reparación básica (sin repuestos).

Caso 2: Reparación con cobro de repuestos: incluye instancia de facturación de repuestos.

Caso 3: Reparación no realizada: configurable la opción de devolver el costo del servicio.

Caso 4: Reparación artículo en garantía: bonifica servicio y repuestos.

Caso 5: Entrega sin haber iniciado proceso de reparación: reintegra costo de servicio de reparación

Configuración previa

Para utilizar el módulo se requiere contar con dos artículos enlazados entre sí (al menos):

• Artículo en reparación:
  • Representa el ítem recibido a ser reparado.
  • Debe asociarse a un depósito no disponible para la venta.
  • El precio del artículo debe ser: 0.00
    • Ejemplo: “Celular en reparación”.
  
  
• Servicio de reparación:
  • Representa la mano de obra o el costo de utilización del servicio básico.
  • Debe ser de tipo “Reparación”.
  • Debe enlazarse al artículo en reparación que se recibe al cobrar este servicio.
  • Por cada tipo de artículo se puede definir un servicio distinto, con distinto precio.
    • Ejemplo: “Servicio de reparación de celulares”.

Configuración de parámetros

En Bridge Manager, opción Configuración > Sistema> Tienda > Reparaciones se encuentran todos los parámetros utilizados por el módulo.

Operatoria en BRIDGE POS

Acceso a módulo de reparaciones a través de opción: Reparaciones

Submenú

• RECEPCION: Permite recibir un ítem a ser reparado.
• GESTIONAR REPARACION: Permite acceder al listado de ítems recibidos y accionar sobre ellos.

Recepción de un equipo a reparar

Gestion de reparaciones

Permite acceder al listado completo de reparaciones en curso y a las acciones disponibles de acuerdo a los indicadores asociados.

Operatoria en POS

Para esto podrá acceder desde el menú principal a NO VENTA/CONSULTAR OBJETIVOS DE VENTA

Al seleccionar el botón CONSULTAR OBJETIVOS DE VENTA, se solicitará la selección del período a consultar, pudiendo ser:

• MES EN CURSO (desde el inicio de la meta al día actual)

• MESES ANTERIORES (por liquidaciones de meses ya cerrados). Se habilita el selector del calendario para seleccionar la fecha a partir de la cual se desee consultar

La información se mostrará por pantalla solamente. Luego con el botón ACEPTAR volverá al menú de operaciones.

La información detallada y recibida es calculada por Teamplace en base a las ventas informadas desde los diferentes puntos de venta de las tiendas:

• Cabecera
  • Tienda
  • Datos del vendedor
  • Período a informar
  • Acumulado al (fecha consultada)
  • Facturación de la tienda
  • Comisión o bono a cobrar por el vendedor calculado hasta el día de la consulta y proyectada
  • Porcentaje a cobrar y proyectado

Por cada categoría departamental:

• Categoría
• Objetivos por tipo del objetivo (cantidad, monto o porcentaje)
• Objetivo (valor: monto o cantidad)
• % sobre el objetivo total
• Acumulado al día (monto acumulado hasta ese día)
• % acumulado (porcentaje del acumulado respecto al objetivo del mes)
• Proyectado (monto proyectado con respecto al acumulado al día)
• % de proyectado (porcentaje proyectado con respecto al acumulado al día)

En caso de no contar con resultados de comisiones, se informará con el siguiente mensaje:

Configuración de parámetros

En Bridge Manager, opción Configuración > Sistema> Tienda > Comisiones se encuentran todos los parámetros requeridos para esta consulta

• CONSULTAR COMISIONES CON EL ERP = SI
• URL: se debe configurar con la URL de API provista por Teamplace (utiliza mismo token que con el resto de los servicios)