- Criado por Maria Gala Higgins, última alteração em ago 27, 2024
Manual de servicios de integracion Bridge v7 - Teamplace
© 2024 Napse. Todos los derechos reservados.
Fecha | Versión | Descripción | Autor |
01/07/2020 | 1.0 | Creación del documento | Gustavo Morales/Andrea Asato |
18/08/2020 | 1.1 | Actualización: | Andrea Asato |
08/09/2020 | 1.2 | Se actualizan destino de exportaciones | Andrea Asato |
| 1.3 | Se actualiza la configuración de parámetros de exportación | Andrea Asato |
| 1.4 | Se actualiza la configuración de parámetros de exportación para informar a nivel producto la partida/centro de costo (distribución/dimensión) | Andrea Asato |
| 1.5 | Se actualiza agregando anexo de mensajes de errores comunes en las exportaciones (ver ANEXO Errores de exportaciones) |
Objetivo
Especificar las bases generales de funcionamiento para el intercambio de datos y transacciones como así también las configuraciones necesarias para la integración entre el ERP Teamplace de Finnegans y la solución Bridge de Napse.
Alcance - servicios de integración
Se detallará la lógica de intercambio de datos y transacciones entre ambos sistemas. Teamplace informara datos de maestros del sistema y Bridge enviará información sobre transacciones realizadas como ventas/devoluciones, movimientos de inventario en las tiendas y de tesorería.
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:
# | Entidad | Nombre del servicio | Envía | Recibe | ssssProcedencia |
1 | Tiendas | N/A | TP | BMC | Alta manual |
2 | Depósitos | location | TP | BMC | Alta manual |
3 | Provincias | state | TP | BMC | Script Set up |
4 | Localidades | city | TP | BMC | Script Set up |
5 | Impuestos (IVA, IIBB) | N/A | TP | BMC | Alta manual |
6 | Medios de Pago | tender | TP | BMC | Script Set up |
7 | Bancos | N/A | TP | BMC | Script Set up |
8 | Motivo Descuento Transacción | reasonSaleTransactionDiscount | TP | BMC | Script Set up |
9 | Vendedores | user | TP | BMC | Web Service |
10 | Proveedor | supplier | TP | BMC | Web Service |
11 | Marca | brand | TP | BMC | Web Service |
12 | Jerarquías | merchandiseHierarchy | TP | BMC | Web Service |
13 | Atributos de Producto | productAttribute | TP | BMC | Web Service |
14 | Especificación de Producto | specificationAttribute | TP | BMC | Web Service |
15 | Productos | product | TP | BMC | Web Service |
16 | Productos Recargo y Redondeo | N/A | TP | BMC | Script Set up |
17 | Ítems y stockItems | Item, stockItems | TP | BMC | Web Service |
18 | Códigos de Barra | alias | TP | BMC | Web Service |
19 | Tipo de Artículos | N/A | TP | BMC | Script Set up |
20 | Clientes (desde Teamplace) | customer | TP | BMC | Web Service |
21 | Clientes Alícuotas IIBB / padrones | padrones | TP | BMC | Web Service |
22 | Listas de Precio | itemSellingPrices | TP | BMC | Web Service |
23 | ASN | advancedShipmentNotice | TP | BMC | Web Service |
24 | Cuentas externas | N/A | TP | BMC | Alta manual |
25 | Clientes (creados en el POS) | BMC | TP | API Rest | |
26 | Ticket de Ventas y NC | /api/puntoVentaIntegracion | BMC | TP | API Rest |
27 | Cobranzas | BMC | TP | API Rest | |
28 | Movimientos de tesorería (ingresos y egresos) | BMC | TP | API Rest | |
29 | Consulta de stock por tienda/depósito | /api/reports/stockEmpresa | POS | TP | API Rest |
30 | Consulta de comisiones | POS | TP | API Rest | |
31 | Consulta de casos post venta | POS | TP | API Rest | |
Consulta del detalle de casos post venta | POS | TP | API Rest | ||
32 | Envío de imágenes asociadas a casos post venta | BMC | TP | API Rest | |
33 | Documentos de inventario:
| BMC | TP | API Rest | |
34 | Documentos de inventario:
| /api/pedidocompramirgor | BMC | TP | API Rest |
35 | Documentos de inventario:
| BMC | TP | API Rest |
Considerar que los datos incorporados por Script de Set Up, a posterior de la instalación deben mantenerse manualmente entre ambos sistemas.
Servicios de integración con Teamplace (exportaciones)
En el presente documento se detallan los servicios que Bridge consumirá de Teamplace:
- Servicios de exportación de ventas.
- Servicios de exportación de clientes.
- Servicios de exportación de tesorería.
- Servicios de exportación de documentos de abastecimiento
- Servicios de consulta de objetivos de venta y comisiones.
- Servicios de creación y consulta de casos por reparaciones de postventa.
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
Módulo | Funcionalidad | Nombre del servicio | Especificación del servicio (LinxShare) |
Documentos de abastecimiento/stock |
|
| Servicio de Teamplace/stock: pedidoCompra
|
Movimientos de fondos de la caja de tienda |
|
| Servicio de Teamplace/tesorería: movimientoFondo |
Consultas de stock a Teamplace |
|
| Servicio de Teamplace/stock: /reports/stockDeposito y /reports/stockEmpresa |
Clientes |
|
| |
Comisiones |
|
| Servicio de Teamplace/comisiones: reporteVendedor |
Ventas |
|
| Servicio de Teamplace/ventas: puntoVentaIntegraciones |
Cobranzas |
|
| Servicio de Teamplace/cobranzas: cobranzaMirgor |
Casos – post venta |
| Servicio de Teamplace/casos: listado | |
| Servicio de Teamplace/casos: detalle | ||
| Servicio de Teamplace/casos: filesUpload |
Servicios de integración de Bridge (importaciones)
Documento de referencia: Manual de servicios de integración Bridge v7.0
Teamplace agregará nuevos servicios de integración que expone Bridge:
- Documentos de abastecimiento/stock:
- Recepción por ASN
- Maestros y configuración
- Motivos de cancelación
- Motivos de descuento
- Padrones (para actualización de alícuotas)
Módulo | Funcionalidad | Nombre del servicio |
Documentos de abastecimiento/stock |
|
|
Maestros y configuración |
|
|
Instalación de Bridge POS
Para la instalación de Bridge POS, se debe tomar el instalador de producto compatible con la versión de Bridge Manager que se haya instalado.
Funcionalidad de Bridge POS
Documento de referencia:
B7 - MANUAL DE USUARIO - Bridge POS v7.0
Funcionalidad de Bridge Manager
Documento de referencia:
Configuración general de servicios de exportación
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.
Exportaciones
Parámetros globales
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
Nombre del parámetro | Tipo de dato | Descripción | Valor por defecto |
teamplace.globalAPI.tokenTimeout | integer | Tiempo expresado en milisegundos para validar si se expiró el token | 5000 |
teamplace.globalAPI.URL | string | URL Finneg API oauth | Pedir configuración a Finnegans (por proyecto) |
teamplace.globalAPI.grant_type | string | Tipo de autenticación para obtener el token | default: client_credentials |
teamplace.globalAPI.client_id | string | ID cliente para obtener el token | Pedir configuración a Finnegans (por proyecto) |
teamplace.globalAPI.client_secret | string | Key secreta para el ID cliente para obtener el token | Pedir configuración a Finnegans (por proyecto) |
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.
Nombre del parámetro | Tipo de dato | Descripción | Valor por defecto |
teamplace.globalAPI.CODIGOEMPRESA.N | string | Código de la empresa que espera Teamplace, donde N es el número o código identificador de tienda. (se reemplaza al instalarse la tienda. Habrá un parámetro por tienda) | Pedir configuración a Finnegans (por proyecto) |
teamplace.globalAPI.DepositoTransito.N | tipo string | Deposito de tránsito: tienda N (se reemplaza al instalarse la tienda. Habrá un parámetro por tienda) | Pedir configuración a Finnegans (por proyecto) |
teamplace.globalAPI.DepositoTransitoCD | tipo string | Depósito de tránsito de centro de distribución (se reemplaza al instalarse la tienda. Habrá un parámetro por tienda) | Pedir configuración a Finnegans (por proyecto) |
Códigos de moneda
Es configuración inicial cuando es una instalación con integración Teamplace.
Nombre del parámetro | Tipo de dato | Descripción | Valor por defecto |
teamplace.globalAPI.MONEDA.ARS | string | Código de la moneda que corresponde a la moneda ISO ARS | ARS |
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
Exportación ventas: Configuración de parámetros para informar ventas, devoluciones y cambios
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace ventas tal cual se describe en la figura, se listan los parámetros para la exportación de ventas:
Especificación del servicio: Servicio de Teamplace/ventas: puntoVentaIntegraciones
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
Exportación de tesorería: Configuración de parámetros para informar ingresos y egresos
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace tesorería tal cual se describe en la figura, se listan los parámetros a configurar con la información provista por Finnegans:
Especificación del servicio: Servicio de Teamplace/tesorería: movimientoFondo
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.
Exportación de stock: Configuración de parámetros para informar movimientos de inventario
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace stock, se listan los parámetros a configurar con la información provista por Finnegans:
Especificación del servicio:
Servicio de Teamplace/stock: pedidoCompra
Servicio de Teamplace/stock: movimientoInterno (transferencia entre tiendas)
Servicio de Teamplace/stock: movimientoInterno
Servicio de Teamplace/stock: ajusteStock
Parámetros
Exportación de cobranzas_ Configuración de parámetros para informar movimientos de cobranzas
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace cobranzas, se listan los parámetros a configurar con la información provista por Finnegans:
Especificación del servicio: Servicio de Teamplace/cobranzas: cobranzaMirgor
Parámetros
Exportación de clientes: Configuración de parámetros para informar clientes persona y empresas
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace clientes tal cual se describe en la figura, se listan los parámetros del servicio de clientes:
Especificación del servicio: Servicio de Teamplace/clientes: customer
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
Exportación de casos_ Configuración de parámetros para consulta de casos de postventa
Accediendo a la opción Configuración/Sistema/Exportación/Teamplace casos, se listan los parámetros a configurar con la información provista por Finnegans:
Especificación del servicio: Integración Reparaciones (servicio Post-Venta)
Parámetros
Monitoreo de exportaciones
Para el seguimiento de las exportaciones, se cuenta con un monitor. Este será un listado de cada entidad que se exporte hacia el ERP.
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:
# | Entidad | Exportación de |
---|---|---|
1 | Sale | Ventas, casos de postventa y cobranzas de gift card |
2 | Return | Devoluciones y devoluciones de cobranzas de gift card |
3 | Exchange | Cambios |
4 | NewCustomer | Nuevo cliente o actualización de cliente |
5 | SaleEvidence | Evidencias de postventa (fotos adjuntas a los casos) |
Filtros y entidades de exportaciones de operaciones de caja del BM
Las entidades de exportaciones de operaciones de caja son:
Entidad | Exportación de |
---|---|
TenderInflow | Ingreso |
TenderOutflow | Egreso |
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:
Entidad | Exportación de |
---|---|
InventoryOrder | Pedido de compra o abastecimiento |
InventoryReception | Recepción de ASN |
InventoryReturn | Devolución a proveedor o centro de distribución |
InventoryTransfer | Transferencia entre tiendas |
InventoryAdjustment | Ajuste de inventario |
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".
ANEXO Errores de exportaciones
Se detallan algunos errores comunes y sus posibles soluciones
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:
Respuesta | |
---|---|
Error |
|
Ok |
{ "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
|
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. |
{ "ProductoCodigo": "BLD-LAUREL/ALTS", "Precio": "2148.7603", "Cantidad": 1, "Descripcion": "BLD ALMOHADON GASA DOBLE 35X50", "DepositoDestinoCodigo": null,
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:
ABM artículos:
|
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:
|
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:
|
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:
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:
|
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:
|
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:
|
Monitoreo de importaciones
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
Anexo Implementació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
Configuración de nueva tienda para la exportación de datos
Registros de configuración para una nueva tienda
Para la configuración de exportación de una nueva Tienda, al instalarse se agregará el registro en la tabla systemConfiguration de BridgeManager Central el parámetro para configurar el código de la tienda y de su depósito de tránsito.
El código del depósito de tránsito tomará el mismo código de la tienda. De requerir, se deberá reconfigurar.
Maestros de Datos Generales
A continuación se listan los catálogos donde se configuran códigos comunes entre sistemas (Bridge-Teamplace)
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.
Nombre | Código Finnegans |
Responsable Inscripto | RI |
Exento | EX |
Monotributista | MO |
Consumidor Final | CF |
Del Exterior | DEX |
- 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
Nombre | Descripción | Código Finnegans |
CM | Conv. Multilateral | 1 |
L | Local | 0 |
IBBEX | Exento | 2 |
IBBAR | Alto Riesgo | |
IBBNA | No Acredita | |
NI | Responsable No Inscripto | 3 |
IBBMT | Régimen Simplificado (Monotributo) | 4 |
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.
Nombre | Código Finnegans | Parámetro Bridge |
C.U.I.T. | CUIT | Tipo de identificación 3: CUIT |
DNI | DNI | Tipo de identificación 1: DNI |
C.U.I.L. | CUIL | Tipo de identificación 4: CUIL |
Pasaporte | PAS | Tipo de identificación 2: PAS |
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
Código item | Nombre | IVA |
---|---|---|
RNDIVA0 | REDONDEO | 0 |
RNDIVA105 | REDONDEO | 10,5 |
RNDIVA21 | REDONDEO | 21 |
RNDIVA27 | REDONDEO | 27 |
998877 | RECARGO | 0 |
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.
Ejemplos de exportaciones
Servicio ClienteMirgor
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
}
]
}
}
Servicio CobranzaMirgor
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": [
]
}
]
}
}
Servicio Files_upload
Ejemplo request JSON de envío de imágenes asociadas a un caso postventa
{
"url": "http://test.teamplace.finneg.com/BSA/api/custom/files/upload",
"method": "POST",
"file": "..."
}
En el monitor de exportación, se podrá visualizar un registro por la venta, tipo "Sale" y luego con el mismo número de transacción, pero del tipo "SaleEvidence" se podrá ver el registro que corresponde a la exportación de las imágenes asociadas a la venta generada por la creación del caso postventa.
Servicio MovimientoFondo
Cuando se realice una operación de caja en BMT de ingreso de una cuenta externa hacia la caja de la tienda (safe), en el monitor de exportación, se podrá visualizar un registro del tipo "TenderInflow".
En el monitor de exportación, se podrá visualizar un registro del tipo "TenderOutflow" para los egresos, cuando se realiza una operación de caja desde BMT.
Ejemplo request JSON de operaciones de caja/Ingresos
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoFondoMirgor?ACCESS_TOKEN=3207b7db-53f5-4db0-ac5f-83b5124b39bc",
"method": "POST",
"params": {
"IdentificacionExterna": "MOVFONDOS - 12",
"Fecha": "2020-07-22",
"Nombre": "MOVFONDOS - 12",
"TransaccionTipoCodigo": "MOVFONDOS",
"TransaccionSubtipoCodigo": "INGRFONDO",
"MonedaCodigo": "ARS",
"Descripcion": "Prueba Gus",
"EmpresaSucursalCodigo": "7390",
"AsientoGenericoCotizaciones": [
],
"AsientoItemsAjuste": null,
"AsientoItems": [
{
"CuentaCodigo": "11110001",
"DebeHaber": 1,
"FechaVto": "",
"Descripcion": "Cuenta del debe",
"OperacionBancariaCodigo": "DEPOSEFECT",
"ImporteMonTransaccion": 1500,
"MonedaCodigo": "ARS",
"FechaVencimientoDocumentoFisico": "2020-07-22",
"FechaDocumentoFisico": "2020-07-22",
"NumeroDocumentoFisico": "2207202001"
},
{
"CuentaCodigo": "11120011",
"DebeHaber": -1,
"FechaVto": "",
"Descripcion": "Cuenta haber",
"OperacionBancariaCodigo": "DEPOSEFECT",
"ImporteMonTransaccion": 1500,
"MonedaCodigo": "ARS",
"FechaVencimientoDocumentoFisico": "2020-07-22",
"FechaDocumentoFisico": "2020-07-22",
"NumeroDocumentoFisico": "2207202001"
}
]
}
}
Ejemplo request JSON de operaciones de caja/Egresos
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoFondoMirgor?ACCESS_TOKEN=c65cee55-49b2-4c67-8430-46d895c0aff5",
"method": "POST",
"params": {
"IdentificacionExterna": "MOVFONDOS - 13",
"Fecha": "2020-07-23",
"Nombre": "MOVFONDOS - 13",
"TransaccionTipoCodigo": "MOVFONDOS",
"TransaccionSubtipoCodigo": "EGREFONDO",
"MonedaCodigo": "ARS",
"Descripcion": "Extraccion de Prueba2",
"EmpresaSucursalCodigo": "7390",
"AsientoGenericoCotizaciones": [
],
"AsientoItemsAjuste": null,
"AsientoItems": [
{
"CuentaCodigo": "11120011",
"DebeHaber": -1,
"FechaVto": "",
"Descripcion": "",
"OperacionBancariaCodigo": "DEPOSEFECT",
"ImporteMonTransaccion": 15500,
"MonedaCodigo": "ARS",
"FechaVencimientoDocumentoFisico": "2020-07-23",
"FechaDocumentoFisico": "2020-07-23",
"NumeroDocumentoFisico": "23072020"
},
{
"CuentaCodigo": "11110001",
"DebeHaber": 1,
"FechaVto": "",
"Descripcion": "",
"OperacionBancariaCodigo": "DEPOSEFECT",
"ImporteMonTransaccion": 15500,
"MonedaCodigo": "ARS",
"FechaVencimientoDocumentoFisico": "2020-07-23",
"FechaDocumentoFisico": "2020-07-23",
"NumeroDocumentoFisico": "23072020"
}
]
}
}
Servicio MovimientoInterno
Ejemplo request JSON de transacción de inventario/recepción asn
Cuando se recepcione una ASN o documento fiscal recibido de un ERP se generará un documento de recepción hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryReception"
- RECEPCION DE ASN (subtipo de transacción: RECSUC)
DepositoOrigen: Transito_Tienda_Destino (parámetro de configuración global)
DepositoDestino: Depo_Tienda_Receptora
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoInternomirgor?ACCESS_TOKEN=e3f07cf0-cd36-46a3-bb3b-b3889c9938b9",
"method": "POST",
"params": {
"IdentificacionExterna": "1788000118",
"Fecha": "2020-08-13",
"FechaBaseVencimiento": "2020-08-13",
"Descripcion": "",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "RECINT",
"Nombre": "RECINT - OPER - 1788000118",
"WorkflowCodigo": "MOV-FLOW",
"EmpresaCodigo": "7135",
"OperacionItems": [
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130800",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130801",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130802",
"PartidaNumero": "",
"vinculacionOrigen": null
}
]
}
}
Ejemplo request JSON de transacción de inventario/Envío de transferencia entre tiendas (tienda origen)
Cuando se genere una transferencia entre tiendas desde la tienda origen se generará un documento de transferencia hacia el ERP desde el depósito de la tienda origen hacia el depósito en tránsito de la tienda destino.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryTransfer"
- TRANSFERENCIA ENTRE TIENDAS
Tienda Emisora (subtipo de transacción: MISD)
DepositoOrigen: Depo_Tienda_Emisora
DepositoDestino: Transito_Tienda_Destino (parámetro de configuración global)
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoInternomirgor?ACCESS_TOKEN=4f509d3a-f815-4c02-a0dc-597211b733ae",
"method": "POST",
"params": {
"IdentificacionExterna": "7389000051",
"Fecha": "2020-08-13",
"FechaBaseVencimiento": "2020-08-13",
"Descripcion": "",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "MISD",
"Nombre": "MISD - OPER - 7389000051",
"WorkflowCodigo": "MOV-FLOW",
"EmpresaCodigo": "7135",
"OperacionItems": [
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7136",
"DepositoCodigoDestino": "7390T",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130800",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7136",
"DepositoCodigoDestino": "7390T",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130801",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7136",
"DepositoCodigoDestino": "7390T",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130802",
"PartidaNumero": "",
"vinculacionOrigen": null
}
]
}
}
Ejemplo request JSON de transacción de inventario/recepción de transferencia (tienda destino)
Cuando se recepcione una transferencia en la tienda destino se generará un documento de recepción hacia el ERP moviendo el stock del depósito en tránsito de la tienda destino al depósito a la venta.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryReception"
Tienda Receptora: confirma (subtipo de transacción: RECINT)
DepositoOrigen: Transito_Tienda_Destino (parámetro de configuración global)
DepositoDestino: Depo_Tienda_Receptora
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoInternomirgor?ACCESS_TOKEN=e3f07cf0-cd36-46a3-bb3b-b3889c9938b9",
"method": "POST",
"params": {
"IdentificacionExterna": "1788000118",
"Fecha": "2020-08-13",
"FechaBaseVencimiento": "2020-08-13",
"Descripcion": "",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "RECINT",
"Nombre": "RECINT - OPER - 1788000118",
"WorkflowCodigo": "MOV-FLOW",
"EmpresaCodigo": "7135",
"OperacionItems": [
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130800",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130801",
"PartidaNumero": "",
"vinculacionOrigen": null
},
{
"ProductoCodigo": "TABLET100",
"Descripcion": "TABLET CJT560B BLANCO.3",
"Cantidad": 1,
"DepositoCodigoOrigen": "7390T",
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "SERIES130802",
"PartidaNumero": "",
"vinculacionOrigen": null
}
]
}
}
Ejemplo request JSON de transacción de inventario/transferencia entre depósitos
Cuando se transfiera productos de un depósito a otro de la misma tienda, se generará un documento de movimiento interno hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryTransfer"
- TRASNFERENCIA ENTRE DEPOSITOS MISMA TIENDA
Tienda Emisora (subtipo de transacción: MIS)
DepositoOrigen: Depo_Tienda_Emisora
DepositoDestino: Depo_Tienda_Emisora X
{
"url": "https://1.teamplace.finneg.com/BSA/api/movimientoInternomirgor?ACCESS_TOKEN=4c641a31-3757-4935-879c-f30450553bb9",
"method": "POST",
"params": {
"IdentificacionExterna": "3055000102",
"Fecha": "2020-08-03",
"FechaBaseVencimiento": "2020-08-03",
"Descripcion": "",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "MIS",
"Nombre": "MIS - OPER - 3055000102",
"WorkflowCodigo": "MOV-FLOW",
"EmpresaCodigo": "1",
"OperacionItems": [
{
"ProductoCodigo": "TV65A",
"Descripcion": "TV 65 QLED ale s/serie",
"Cantidad": 10,
"DepositoCodigoOrigen": "7391",
"DepositoCodigoDestino": "7397",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "",
"PartidaNumero": "",
"vinculacionOrigen": null
}
]
}
}
Ejemplo request JSON de transacción de inventario/ajuste de stock
Cuando se realice un ajuste de stock (positivo o negativo) se generará un documento de ajuste hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryAdjustment"
- AJSTOCK
Tienda Emisora (subtipo de transacción: AJSTOCK)
DepositoOrigen: null
DepositoDestino: Depo_Tienda_Emisora X
{
"url": "https://test.teamplace.finneg.com/BSA/api/ajusteStockmirgor?ACCESS_TOKEN=110de115-7d49-4cef-851a-ce9eb4fcdcf2",
"method": "POST",
"params": {
"IdentificacionExterna": "1788000086",
"Fecha": "2020-07-23",
"TransaccionTipoID": "OPER",
"TransaccionSubtipoID": "AJSTOCK",
"NumeroDocumento": null,
"EmpresaID": "7390",
"OperacionItems": [
{
"ProductoCodigo": "SM-T560NZWPARO",
"Descripcion": "TABLET SAMSUNG GALAXY TAB E 9.6" 8/1.5GB WIFI PEA",
"Cantidad": 1,
"DepositoCodigoDestino": "7391",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "JA-23072023",
"PartidaNumero": ""
}
]
}
}
Ejemplo request JSON de transacción de inventario/devolución al proveedor
Cuando se realice una devolución al proveedor o al centro de distribución se generará un documento de devolución hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryReturn"
- DEVOLUCIONES A CD (subtipo de transacción: DEVCD)
DepositoOrigen: Depo_Tienda_Emisora
DepositoDestino: Transito_Centro_Distribución
Para definir el depósito del centro de distribución, se debe configurar el sig. parámetro global:
{
"url": "https://test.teamplace.finneg.com/BSA/api/movimientoInternomirgor?ACCESS_TOKEN=4aef3ba4-2690-41d7-a987-4bcb02ed9a12",
"method": "POST",
"params": {
"IdentificacionExterna": "1788000122",
"Fecha": "2020-08-13",
"FechaBaseVencimiento": "2020-08-13",
"Descripcion": "",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "DEVCD",
"Nombre": "DEVCD - OPER - 1788000122",
"WorkflowCodigo": "MOV-FLOW",
"EmpresaCodigo": "7390",
"OperacionItems": [
{
"ProductoCodigo": "HELADERA01",
"Descripcion": "No Frost Samsung Rt32k5930sl Digital Inverter Ino",
"Cantidad": 1,
"DepositoCodigoOrigen": "7391",
"DepositoCodigoDestino": "7011",
"OrganizacionCodigo": null,
"ProvinciaCodigoDestino": null,
"USR_ProductoIdDescontado": null,
"USR_Promocion": null,
"NumeroSerie": "HELA202000",
"PartidaNumero": "HELA2020",
"vinculacionOrigen": null
}
]
}
}
Servicio PedidoCompra
Cuando se realice un pedido de abastecimiento u orden de compra se generará un documento de pedido de compra hacia el ERP.
En el monitor de exportación, se podrá visualizar un registro del tipo "InventoryOrder"
Ejemplo request JSON de transacción de inventario/pedido de compra:
- PEDIDO DE ABASTECIMIENTO
Tienda Emisora (subtipo de transacción: SOLCOMP)
{
"url": "https://1.teamplace.finneg.com/BSA/api/pedidocompramirgor?ACCESS_TOKEN=7b741a90-370c-4a1a-b371-055ed45b3f61",
"method": "POST",
"params": {
"IdentificacionExterna": "3055000148",
"Fecha": "2020-08-17",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "SOLCOMP",
"WorkflowCodigo": "CPRA-PROD",
"Descripcion": "",
"EmpresaCodigo": "1",
"Nombre": "SOLCOMP - 3055000148",
"MonedaCodigo": "ARS",
"Items": [
{
"ProductoCodigo": "TV65A",
"Cantidad": 2,
"Precio": 175667
}
],
"Conceptos": null
}
}
Servicio PuntoVentaIntegraciones
Exportación del tipo sale, exchange, return
Desde el monitor de exportaciones se podrá acceder a las exportaciones que se realizan a partir del servicio "puntoVentaIntegración". Estas serán del tipo "Sale", "Exchange" y "Return"
Sólo se informarán las operaciones finalizadas, no se informarán las canceladas, en modo entrenamiento o suspendidas
COMPONENTES DEL REQUEST
Tipo de ítem | Cantidad de elementos dentro de la transacción | Observaciones | |||||
Encabezado | 1 por transacción | Se informan los datos de la cabecera de la transacción | |||||
Producto | Productos | 1 a N por transacción | Se informa el neto del ítem (sin incluir descuentos ni descuentos al total) | ||||
Descuentos | Productos | 1 o N por producto | Productos (con particularidades) | ||||
Descuento a la transacción | Productos. | 1 o N por transacción | Productos (con un código de ítem particular) | ||||
Retenciones | ItemsRetencionCobranza | 0 o N por transacción | Se informan las percepciones de ingresos brutos o de iva | ||||
Conceptos | Conceptos | 1 lista por transacción, con | Se informa los montos netos gravados y los montos de iva según tipo de iva de la transacción | ||||
Medios de pago | 1 lista por transacción | lista de pagos realizados | |||||
PuntoVentaItemsBanco | 0 o N dentro de medios de pago | Medios de pago del tipo CHECK (tipo 2), COUPON (tipo 3) | |||||
PuntoVentaItemsTarjeta | 0 o N dentro de medios de pago | Medios de pago del tipo CARD, Wallet, GiftCard y ChargeCard
| |||||
PuntoVentaItemsEfectivo | 0 o N dentro de medios de pago | Medios de pago del tipo CASH (tipo 1) | |||||
Cotizaciones | Cotizaciones | 0 o 1 por transacción | Cotización del cambio de la moneda extranjera con respecto a la moneda base |
Ejemplo request JSON de transacción de venta
{
"url": "https://8.teamplace.finneg.com/BSA/api/puntoVentaIntegraciones?ACCESS_TOKEN=d1dd8e11-b032-429f-9789-2c99829b23e3",
"method": "POST",
"params": {
"IdentificacionExterna": "0000010030001030",
"Fecha": "2020-06-25",
"FechaBaseVencimiento": "2020-06-25",
"ClienteCodigo": "010001765789001",
"CondicionPagoCodigo": "CE",
"MonedaCodigo": "ARS",
"ComprobanteTipoImpositivoID": "006",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "FVPTOVTA-ELEC",
"WorkflowCodigo": "VTASYNTH",
"Descripcion": "",
"NumeroComprobante": "B-0030-00001030",
"EmpresaCodigo": "1",
"CAINumero": "70267845208662",
"CAIFechaVto": "2020-07-04",
"USR_HoraVenta": "08:06:28",
"USR_CAJA": "30",
"TotalRetenciones": "0.0",
"TotalConceptos": "25323.1",
"Total": "145909.0",
"Productos": [
{
"ProductoCodigo": "GTV48",
"Precio": 120585.95041322314,
"Cantidad": 1,
"Descripcion": "TV 65 QLED 4k",
"DepositoOrigenCodigo": "VENTA2",
"DepositoDestinoCodigo": "",
"DimensionDistribucion": [
],
"vinculacionOrigen": "",
"Importe": 120585.95041322314,
"USR_ImporteNormal": 145909,
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "gmorales",
"USR_NroSerie": "",
"USR_PartidaNumero": "",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null
}
],
"Conceptos": [
{
"ConceptoCodigo": "VENTA_IVA 21",
"ConceptoImporte": 25323.05,
"ConceptoImporteGravado": 120585.95,
"TasaImpositiva": "21.00"
}
],
"PuntoVentaItemsEfectivo": [
{
"CuentaCodigo": "EFVOPESOS",
"ImporteACobrar": "145909.0",
"MonedaCobroCodigo": "ARS"
}
],
"PuntoVentaItemsBanco": [
],
"PuntoVentaItemsTarjeta": [
],
"ItemsRetencion": [
],
"Cotizaciones": [
]
}
}
Ejemplo request JSON de transaccion de cambio
A diferencia de una venta, se informa según el tipo de comprobante, este dependerá según el saldo de la operación. Si es a favor del cliente se genera una nota de crédito sino una factura.
Se envía un flag adicional que indica que es una operación de cambio.
- "USR_IncluyeCambio": true,
- "USR_EsProductoDeCambio": true, – a nivel item, el item devuelto también se lo diferencia
{
"url": "https://1.teamplace.finneg.com/BSA/api/puntoVentaIntegraciones?ACCESS_TOKEN=d3ef9da5-bb3c-4d11-9f0a-97b1beb1d3cc",
"method": "POST",
"params": {
"IdentificacionExterna": "0000010025000093",
"Fecha": "2020-08-03",
"FechaBaseVencimiento": "2020-08-03",
"ClienteCodigo": "010003012345601",
"CondicionPagoCodigo": "CE",
"MonedaCodigo": "ARS",
"ComprobanteTipoImpositivoID": "006",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "FVPTOVTA-ELEC",
"WorkflowCodigo": "VTASYNTH",
"Descripcion": "",
"NumeroComprobante": "B-0025-00000093",
"EmpresaCodigo": "1",
"CAINumero": "30307932468368",
"CAIFechaVto": "2020-08-14",
"USR_HoraVenta": "10:26:14",
"USR_CAJA": "25",
"USR_IncluyeCambio": true,
"TotalRetenciones": "0.0",
"TotalConceptos": "0.0",
"Total": "0.0",
"Productos": [
{
"ProductoCodigo": "TABLET4",
"Precio": -17925.7919,
"Cantidad": -1,
"Descripcion": "Core 2 Duo",
"DepositoOrigenCodigo": null,
"DepositoDestinoCodigo": "VENTA2",
"DimensionDistribucion": [
],
"vinculacionOrigen": "FC B-0025-00000092",
"Importe": -17925.7919,
"USR_ImporteNormal": -19808,
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "venUnicenter",
"NumeroSerie": "1507220008",
"PartidaNumero": "duo2core",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null,
"USR_EsProductoDeCambio": true,
"USR_TasaImpositiva": "TASA10.5",
"USR_ImporteIVA": -1882.2099999999991
},
{
"ProductoCodigo": "TABLET1",
"Precio": 17925.7919,
"Cantidad": 1,
"Descripcion": "TABLET core i5 8th gen",
"DepositoOrigenCodigo": "7391",
"DepositoDestinoCodigo": null,
"DimensionDistribucion": [
],
"vinculacionOrigen": "FC B-0025-00000092",
"Importe": 17925.7919,
"USR_ImporteNormal": 19808,
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "venUnicenter",
"NumeroSerie": "3",
"PartidaNumero": "",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null,
"USR_EsProductoDeCambio": false,
"USR_TasaImpositiva": "TASA10.5",
"USR_ImporteIVA": 1882.2099999999991
}
],
"Conceptos": [
{
"ConceptoCodigo": "VENTA_IVA 10,50",
"ConceptoImporte": 0,
"ConceptoImporteGravado": 0,
"TasaImpositiva": "10.50"
}
],
"PuntoVentaItemsEfectivo": [
],
"PuntoVentaItemsBanco": [
],
"PuntoVentaItemsTarjeta": [
],
"ItemsRetencion": [
],
"Cotizaciones": [
]
}
}
Ejemplo request JSON de transacción de una devolución
A diferencia de una venta, se envía como un tipo de documento específico y con los datos adicionales de la referencia de compra original cuando la misma se haya ingresado.
- "vinculacionOrigen": "TK B-0025-00001509",
{
"url": "https://1.teamplace.finneg.com/BSA/api/puntoVentaIntegraciones?ACCESS_TOKEN=b112d215-76bd-485e-9de3-56b3f627dec9",
"method": "POST",
"params": {
"IdentificacionExterna": "0000010025001510",
"Fecha": "2020-08-17",
"FechaBaseVencimiento": "2020-08-17",
"ClienteCodigo": "CF",
"CondicionPagoCodigo": "CE",
"MonedaCodigo": "ARS",
"ComprobanteTipoImpositivoID": "008",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "NCPTOVTA-ELEC",
"WorkflowCodigo": "VTASYNTH",
"Descripcion": "",
"NumeroComprobante": "B-0025-00001510",
"EmpresaCodigo": "1",
"CAINumero": "70337856561304",
"CAIFechaVto": "2020-08-27",
"USR_HoraVenta": "10:24:55",
"USR_CAJA": "25",
"USR_IncluyeCambio": false,
"TotalRetenciones": "0.0000",
"TotalConceptos": "1882.2100",
"Total": "19808.0000",
"Productos": [
{
"ProductoCodigo": "TABLET500",
"Precio": "17925.7919",
"Cantidad": 1,
"Descripcion": "'Core" 2 " Duo PRO + CARGADOR",
"DepositoOrigenCodigo": null,
"DepositoDestinoCodigo": "VENTA2",
"DimensionDistribucion": [
],
"vinculacionOrigen": "TK B-0025-00001509",
"Importe": "17925.7919",
"USR_ImporteNormal": "19808.0000",
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "venUnicenter",
"NumeroSerie": "TABLET507",
"PartidaNumero": "TABLET2020",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null,
"USR_EsProductoDeCambio": false,
"USR_TasaImpositiva": "TASA10.5",
"USR_ImporteIVA": "1882.2100"
}
],
"Conceptos": [
{
"ConceptoCodigo": "VENTA_IVA 10,50",
"ConceptoImporte": 1882.21,
"ConceptoImporteGravado": 17925.79,
"TasaImpositiva": "10.50"
}
],
"PuntoVentaItemsEfectivo": [
{
"CuentaCodigo": "11120010",
"ImporteACobrar": "19808.0000",
"MonedaCobroCodigo": "ARS"
}
],
"PuntoVentaItemsBanco": [
],
"PuntoVentaItemsTarjeta": [
],
"ItemsRetencion": [
],
"VendedorCodigo": "venUnicenter"
}
}
Ejemplo request JSON de creación de un caso de postventa
A diferencia de una venta, se envía como un tipo de documento específico de postventa y con los datos adicionales que se ingresan durante la recepción del equipo y la mano de obra.
- "numeroOrden": "554412", – nro de tracking
- "opLogistico": "12556", – nro del operador
- "idCaso": "0073900010000231" – caso generado
- "Descripcion": "Reparacion 001", – notas ingresadas
{
"url": "https://test.teamplace.finneg.com/BSA/api/puntoVentaIntegraciones?ACCESS_TOKEN=79af1bed-c082-4f7c-8d22-b6f5518a4272",
"method": "POST",
"params": {
"IdentificacionExterna": "0073900010000231",
"Fecha": "2020-07-24",
"FechaBaseVencimiento": "2020-07-24",
"ClienteCodigo": "01000178529637390",
"CondicionPagoCodigo": "CE",
"MonedaCodigo": "ARS",
"ComprobanteTipoImpositivoID": "006",
"TransaccionTipoCodigo": "OPER",
"TransaccionSubtipoCodigo": "PVMDO",
"WorkflowCodigo": "VTASYNTH",
"Descripcion": "Reparacion 001",
"NumeroComprobante": "B-0010-00000231",
"EmpresaCodigo": "7390",
"CAINumero": "70306850505823",
"CAIFechaVto": "2020-08-02",
"USR_HoraVenta": "07:46:21",
"USR_CAJA": "10",
"USR_IncluyeCambio": false,
"TotalRetenciones": "0.0",
"TotalConceptos": "0.0",
"Total": "1000.0",
"Productos": [
{
"ProductoCodigo": "REP-MDOR",
"Precio": 1000,
"Cantidad": 1,
"Descripcion": "Mano de obra reparacion ",
"DepositoOrigenCodigo": null,
"DepositoDestinoCodigo": null,
"DimensionDistribucion": [
],
"vinculacionOrigen": "",
"Importe": 1000,
"USR_ImporteNormal": 1000,
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "cajauni",
"NumeroSerie": "",
"PartidaNumero": "",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null,
"USR_EsProductoDeCambio": false
},
{
"ProductoCodigo": "REP-AREP",
"Precio": 0,
"Cantidad": 1,
"Descripcion": "Articulo en reparacion NOTEII",
"DepositoOrigenCodigo": null,
"DepositoDestinoCodigo": "7397",
"DimensionDistribucion": [
],
"vinculacionOrigen": "",
"Importe": 0,
"USR_ImporteNormal": 0,
"USR_ListaPrecioCodigo": "",
"USR_VendedorCodigo": "cajauni",
"NumeroSerie": "SERIE-001",
"PartidaNumero": "",
"USR_NroPoliza": "",
"USR_ProductoCodigoAsegurado": "",
"USR_MontoPrima": null,
"USR_EsProductoDeCambio": false
}
],
"Conceptos": [
{
"ConceptoCodigo": "VENTA_IVA 0",
"ConceptoImporte": 0,
"ConceptoImporteGravado": 1000,
"TasaImpositiva": "0.00"
}
],
"PuntoVentaItemsEfectivo": [
{
"CuentaCodigo": "11120010",
"ImporteACobrar": "1000.0",
"MonedaCobroCodigo": "ARS"
}
],
"PuntoVentaItemsBanco": [
],
"PuntoVentaItemsTarjeta": [
],
"ItemsRetencion": [
],
"Cotizaciones": [
],
"numeroOrden": "554412",
"opLogistico": "12556",
"idCaso": "0073900010000231"
}
}
Servicio postventa: Reparaciones
Módulo para gestionar la recepción, reparación y entrega de ítems a ser reparados, que involucra a:
- BPOS: Recepción de ítem a repararPunto de venta Bridge.
- Facturación inicial de servicio de reparación.
- Facturación adicional de repuestos, según revisión técnica.
- Entrega del producto reparado.
- Bridge Manager (backoffice)
- Gestión del stock de los ítems en reparación.
- Gestión del stock de los ítems en reparación.
- Teamplace (ERP Finnegans).
- Workflow de actividades de reparación.
- Workflow de actividades de reparación.
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
BPOS: Recepción de ítem a reparar
Resultado de la recepción:
1)Genera el comprobante por el servicio abonado, comprobante del ítem recibido.
2)Ingresa el ítem recibido en el stock, en el depósito configurado.
3)Da de alta un “Caso” en Teamplace, desde donde se gestionan los distintos pasos de la reparación.
Resultado: Emisión de comprobante
- Incluye información de la recepción para identificar el ítem recibido y la gestión asociada:
- Identificación del artículo a reparar
- Número de serie
- Número de caso (Teamplace)
- Permite incluir una leyenda configurable (parámetros del sistem)
Resultado: Ingresa al stock el ítem a ser reparado.
Resultado: Nuevo Caso registrado (Teamplace)
Registro de un caso identificado con el nro informado en el comprobante.
Opción: WS > Procesos > Gestión de casos
Incluye toda la información registrada en la recepción y las imágenes (evidencias) adjuntadas.
Gestion de reparaciones
Permite acceder al listado completo de reparaciones en curso y a las acciones disponibles de acuerdo a los indicadores asociados.
Al hacer doble click sobre un caso, permite ver la información registrada al inicio de la gestión y la información registrada desde Teamplace (repuestos, indicadores).
Configuración:
Leyenda comprobante repuestos para reparación.
Facturación de repuestos
- Se habilita cuando se activan los indicadores:
- Incluye repuestos
- Presupuesto aprobado.
- Puede habilitarse la facturación de repuestos desde todas las tiendas o solamente desde donde se haya realizado la recepción.
- Esta operación se encuentra desacoplada de la entrega, para permitir el cobro de los repuestos durante el proceso de reparación, sin estar el cliente en forma presencial en la tienda.
Genera una venta con el cliente asociado al caso y los repuestos seleccionados desde Teamplace.
Al finalizar la facturación de repuestos:
- Emite el comprobante con el detalle de los repuestos y dónde se puede incluir una leyenda configurable.
- Se realiza la baja del stock de los repuestos en Teamplace.
- Permite acceder a realizar la entrega del ítem inmediatamente, en caso de estar realizando ambas operaciones en forma conjunta (cuando el cliente acude a retirar su ítem).
Entrega de ítem
- Se habilita cuando no se hayan indicado repuestos o ya se encontraran facturados.
- Se valida que el ítem se encuentre en el stock de la tienda (en caso de reparaciones en distinta tienda de recepción).
- Mientras no se indique en Teamplace que el ítem fue revisado se realizará la devolución del servicio de reparación.
- Si se indica en Teamplace que el ítem fue NO pudo ser reparado, según configuración se permite seleccionar si se reintegra el costo del servicio
Configuración:
Reintegra costo de servicio si no fue reparado el artículo.
Entrega de ítem: sin reintegro de servicio
Genera una venta seleccionando el cliente asociado y el artículo a entregar con un costo simbólico de $0,01.
Entrega de ítem: con reintegro de servicio
Genera una devolución seleccionando el cliente asociado, el servicio a reintegrar y el artículo a entregar.
Resultado de la entrega:
1)Genera el comprobante (venta/devolución) de la entrega ítem, que incluye los datos del ítem y opcionalmente una leyenda configurable.
2)Da de baja el ítem del stock.
3)Cierra el caso en Teamplace.
Configuración:
Leyenda comprobante entrega producto para reparación.
Comisiones
En integración con Teamplace, se podrán consultar desde BridgePOS las comisiones del vendedor que se encuentra logueado en el punto de venta.
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)
- Sem rótulos