Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 7 Próxima »


PLUGIN BRIDGE2SQL

Documentación y Modelo de Datos SQL





Contenido


INTRODUCCIÓN


Este documento tiene como finalidad describir en detalle el modelo de datos utilizado en la integración del Plugin Bridge2SQL con SQL Server. La finalidad del documento es proporcionar una referencia técnica para el diseño, implementación y mantenimiento de la base de datos, asegurando la correcta estructuración de las transacciones procesadas desde el sistema Bridge Manager Central hasta su almacenamiento en SQL Server.

El objetivo principal es establecer un marco de referencia claro para la gestión de datos en el entorno de integración, facilitando la interoperabilidad entre los distintos sistemas involucrados. Se incluyen detalles sobre la arquitectura del sistema, el flujo de procesamiento de datos, la estructura de las tablas en la base de datos y el mapeo de información entre los formatos JSON y SQL.

Este documento está dirigido a desarrolladores, arquitectos de sistemas y administradores de bases de datos que requieran comprender el funcionamiento interno del Plugin Bridge2SQL y su impacto en la estructura de datos.


NOMENCLATURA


  • ARG: Argentina
  • IIBB: ingresos brutos. Son impuestos que se aplican a los clientes en Argentina
  • IVA: impuesto al valor agregado (VAT)
  • Impuestos internos: impuestos sobre los artículos pudiendo ser llamados suntuosos en algunas regiones (TAX)
  • MX: México
  • N/A: No aplica 



DIAGRAMA DE ARQUITECTURA


El sistema se conforma de cuatro componentes principales:

  • Bridge Manager Central: Sistema exportador.

  • Sistema de Colas RabbitMQ: Para encolar los datos exportados.

  • Plugin Bridge2Sql: Lee las colas RabbitMQ y escribe los datos en SQL.

  • Servidor SQL: Almacena los datos procesados.

Todos los componentes pueden convivir en el mismo servidor si fuera necesario.





DESCRIPCIÓN DE LOS COMPONENTES


Bridge Manager Central

Actúa como BackOffice complementando la operación en tienda de los puntos de venta. La solución cuenta con un conjunto de módulos que contemplan las operaciones reducidas de Cash Office, su módulo de abastecimiento y provee una serie de interfaces de integración con sistemas externos como ERP, sistemas legacy, etc.

Cuenta con una "Consola de administración", encargada de brindar una herramienta centralizada de administración. Esta consola es Web y funciona sobre un servidor de aplicaciones. Permite configurar qué tipos de transacciones se pueden exportar y hacía donde se expone la información por ejemplo “rabbit”.


Colas RabbitMQ

Sistema de mensajería que almacena datos encolados para procesamiento. Actúa como intermediario confiable entre sistemas distribuidos.

Su principal responsabilidad es almacenar los datos encolados para su procesamiento. RabbitMQ facilita la comunicación entre aplicaciones distribuidas al actuar como un intermediario confiable que encola, enruta y entrega mensajes de manera eficiente y flexible. Su uso permite la creación de sistemas robustos y escalables que pueden manejar grandes volúmenes de mensajes de manera confiable.

Las colas en RabbitMQ son puntos de almacenamiento temporales para los mensajes y actúan como buffers donde los mensajes son encolados hasta que son consumidos por los consumidores, en nuestro caso el plugin Bridge2Sql.


Plugin Bridge2Sql

Es un componente más de la solución Bridge que actua como el consumidor de los mensajes encolados en RabbitMQ y los procesa para insertarlos en el servidor de base de datos SQL. Una de las responsabilidades de este sistema es determinar a qué tablas se realizarán las inserciones de los registros dependiendo del valor de los campos de control.

Si bien realiza algunas operaciones de procesamiento, la mayor prioridad de este sistema será la lectura y escritura de la información.

Componentes:

  1. Configuración Inicial: Configurar conexión a RabbitMQ y a SQL Server

  2. Conexión a RabbitMQ: Configurar canales y declaración de colas a leer.

  3. Consumo de Mensajes: Recibe un mensaje, lo procesa extrayendo la información relevante para insertar en SQL.

  4. Procesamiento de Mensajes: Implica la deserialización del mensaje (si está en un formato específico, como JSON o XML), la validación de los datos y la preparación para la inserción en la base de datos.

  5. Conexión a la Base de Datos SQL Server: Abrir una conexión con SQL de forma segura.

  6. Inserción de Registros en la Base de Datos: Ejecutar los scripts de SQL

  7. Manejo de Errores y Reintentos: El plugin debe implementar mecanismos de manejo de errores y reintentos para garantizar la fiabilidad y la integridad de los datos.

  8. Cierre de Conexiones: Una vez que el plugin ha terminado de procesar los mensajes o se detiene su ejecución, debe cerrar todas las conexiones abiertas con RabbitMQ y la base de datos SQL Server de manera adecuada para liberar recursos y garantizar una terminación limpia.


SQL Server

Es un sistema de gestión de bases de datos relacional (RDBMS) desarrollado por Microsoft. Proporciona un entorno robusto y seguro para almacenar, administrar y recuperar datos de manera eficiente. Es ampliamente utilizado en empresas de todos los tamaños y sectores para almacenar y gestionar datos críticos de negocio.




FLUJO DE DATOS

El Plugin Bridge2SQL procesa transacciones marcadas como pendientes y determina el flujo de procesamiento según los siguientes criterios:

Transactions

Evalúa el campo trxType y si es "Sale", "Return" o "Exchange", inserta en:

  • transactionRetail (cabecera de la transacción).

  • transactionRetailItem (detalle de ítems).

  • transactionRetailPayment (detalle de pagos).

  • transactionRetailDiscount (detalle de descuentos).


New Customer

Si el campo typeCode es "NewCustomer", "PRS" o "OGN", inserta en:

  • party (cabecera del cliente).

  • partyContactMethod (métodos de contacto).


Tender Transaction

Si el campo typeCode es "TenderLoan", "TenderPickup" o "TenderWithdrawal", inserta en:

  • tenderTransaction (cabecera de la transacción).

  • tenderTransactionDetail (detalle de ítems).


Control Transaction

Si el campo trxType es "BusinessEOS" o "BusinessSOS", inserta en:

  • controlTransaction (cabecera).


Safe Transaction

Si el campo trxType es "TenderInflow" o "TenderOutflow", inserta en:

  • safeTransaction (cabecera).

  • safeTransactionDetail (detalle).



MARTI BOLIVAR 

MAPEO DE LA INFORMACIÓN JSON - SQL

Una de las ideas del diseño de esta solución es que los nombres de los campos entre el JSON y SQL Sea el mismo y represente la misma información. En las tablas se mostrarán las correspondencias y se destacarán los casos en los que existe diferencia.

Tabla: transactionRetail

Entidad Bridge: TransactionRetail

Tabla SQL: transactionRetail

Descripción:  Cabecera de una venta, devolución o cambio. detalle de una venta, devolución o cambio

Tabla

ClavePrimaria

ClavesForaneas

transactionRetail

transactionObjectId

–

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo de valor

transactionObjectId

transactionObjectId

(PK) ID de objeto de transacción

varchar(256)

NO

66d2272c0a5da115b22a532f

_id

_id

Identificador único (ID del registro. Uso interno Bridge)

varchar(256)

NO

66d227900f4bc528ec6db1bc

baseCurrencyCode

baseCurrencyCode

Código ISO de moneda base

  • MXN: PESO MEXICANO
  • USD: Dolar
  • EUR: EURO
  • CLP: PESO CHILENO
  • PPEN: SOL
  • ARS: PESO ARGENTINO

varchar(256)

SI

MXN

beginDateTime

beginDateTime

Fecha y hora de inicio de la transacción 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2024-08-27 09:17:30.000

beginDateTimeAsInt

beginDateTimeAsInt

Fecha y hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

20241108

beginDateTimeHour

beginDateTimeHour

Hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

8

billTotalAmount

billTotalAmount

Monto total del comprobante (incluye impuestos)

  • En devoluciones, se informa en negativo

numeric(18,4)

NO

649.0000

billType

billType

Tipo de comprobante:

  • ARG: FC A, FC B, NC A, NC B, Remito: RM A, RM B 

(Uso interno de BRIDGE)

varchar(256)

SI

N/A

businessDayDate

businessDayDate

Día contable o de negocio.

Formato: YYYY-MM-DD HH:MM:SS

varchar(256)


SI

2024-08-04 00:00:00.000

cancelFlag

cancelFlag

Indica si la transacción fue cancelada (si es true, no contabiliza ni mueve stock) 

bit

NO

0

contingencyFlag

contingencyFlag

Indica si la transacción fue ingresada al sistema en modalidad contingencia (por algún motivo no puede generarse la venta en línea y se emite factura impresa. Luego se ingresa al sistema para actualizar contabilidad de la tienda) 

bit

NO

0

createdAt

createdAt

Fecha de creación del registro (cuando se distribuye la venta en la tienda) 

(Uso interno de BRIDGE) 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2024-08-27 09:17:30.000

currencyDescription

currencyDescription

Descripción de la moneda base

  • MXN: PESO MEXICANO
  • USD: Dolar
  • EUR: EURO
  • CLP: PESO CHILENO
  • PPEN: SOL
  • ARS: PESO ARGENTINO

varchar(256)

SI

Peso Mexicano

denomination

denomination

Nombre del cliente. Para personas físicas Nombre + Apellidos. Para empresas, razón social.

Si la transacción no tiene un cliente asociado, se guarda como "CONSUMIDOR FINAL" 

varchar(256)

SI

Pedro Gonzalez

diasCredito

diasCredito

Días de crédito

(Uso interno de BRIDGE) 

varchar(256)

SI


endDateTime

endDateTime

Fecha y hora de finalización de la transacción

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2024-08-27 09:17:30.000

fiscalCAENumber

fiscalCAENumber

ARG: Número de CAE (Nro de autorización  de facturación electrónica) 
MX: UUID de la factura. Solo estará presente si invoiceRequired es 1 (true)

varchar(256)

SI

A6AE12A1-B96-11F0-9956-0F90B16BAE25

fiscalMode

fiscalMode

ARG: Modo Fiscal de autorización de factura electrónica: CAE (online), CAEA (offline)

MX: Tipo de documento con respecto a la facturación.

Valores posibles:

  • FI - Para ventas sin factura en el POS. Solo se emitió ticket.
  • FE - Factura Electrónica para ventas facturadas en línea en desde el POS. 

varchar(256)

SI

FI

fiscalPosNumber

fiscalPosNumber

ARG: Número de Punto de Venta Fiscal o centro emisor 

MX: Serie del documento. Se define en FiscalFlow para los diferentes tipos de comprobantes y puede ser por terminal o tienda. Para una transacción con factura electrónica desde el POS este valor se envía en el campo Serie  del CFDI.

varchar(256)

SI

1

billNumber

billNumber

ARG: Número de comprobante fiscal

MX: Número de folio del comprobante. Valor generado por Fiscal Flow y es secuencial por serie (ver campo fiscalPosNumber). Para una transacción con factura electrónica desde el POS, este valor se envía en el campo Folio del CFDI.

varchar(256)

SI

00000727

folio

folio

Folio de la factura 

(campo DEPRECADO)

varchar(256)

SI

N/A

folioDelivery

folioDelivery

Folio de entrega

(campo DEPRECADO)

varchar(256)

SI

N/A

folioInternet

folioInternet

Folio de Internet

(campo DEPRECADO)

varchar(256)

SI

N/A

foreignCurrencyInvoice

foreignCurrencyInvoice

Indica si es una Factura que se genera en moneda extranjera (cuando difiere de la moneda base del sistema) 

bit

NO

0

foreignCurrencySellingQuote

foreignCurrencySellingQuote

Cotización de la moneda (aplica si fue facturado en moneda extranjera e informa la cotización con respecto a la moneda base)

---------

Configurable por medio de pago

numeric(18,4)

NO

0.0000

grossAmount

grossAmount

Monto bruto de la transacción, incluye impuestos (IVA e impuestos internos) 

  • NO incluye percepciones de ingresos brutos (impuestos de ARG)
  • NO se restan los descuentos que la transacción pudiera tener.

Ni los items anulados

En transacciones de "Return" se informa en: 0

numeric(18,4)

NO

649.0000

grossNegativeAmount

grossNegativeAmount

Monto bruto negativo 

a) Monto negativo de la venta que puede ser por los siguientes conceptos

1- descuentos 2- productos anulados (voiding=true) 3- item de extra cash y de redondeo (returned=true)

b) Monto de la devolución (productos)

numeric(18,4)

NO

0.0000

grossPositiveAmount

grossPositiveAmount

Monto bruto positivo (productos vendidos)

a) venta: items vendidos

b) devolución: items anulados, descuentos, redondeo

numeric(18,4)

NO

649.0000

hasCustomer

hasCustomer

Indica si la transacción tiene un cliente asociado

bit

NO

1

internalTaxAmount

internalTaxAmount

Monto de impuestos internos o suntuarios (TAX)

numeric(18,4)

NO

0.0000

invoiceCurrencyCode

invoiceCurrencyCode

Código ISO de la moneda de facturación  

  • MXN: PESO MEXICANO
  • USD: Dolar
  • EUR: EURO
  • CLP: PESO CHILENO
  • PPEN: SOL
  • ARS: PESO ARGENTINO

varchar(256)

SI

MXN

invoiceRequired

invoiceRequired

MX: Indica si la transacción fue facturada desde el POS. 

bit

NO

0

invoiceUUID

invoiceUUID

UUID de la factura

(campo DEPRECADO)

varchar(256)

SI

N/A

itemCount

itemCount

Cantidad de ítems de la venta/devolución (no se contabilizan aquellos ítems anulados) 

numeric(18,4)

NO

1.0000

iva0Amount

iva0Amount

Monto de IVA al 0%

Monto imponible o gravado con impuestos al 0% (en las devoluciones se informa en negativo) 

numeric(18,4)

NO

0.0000

iva105Amount

iva105Amount

Monto imponible o gravado de IVA al 10.5% (NO SE UTILIZA EN MEXICO)

numeric(18,4)

NO

0.0000

iva21Amount

iva21Amount

Monto imponible o gravado de IVA al 21% (NO SE UTILIZA EN MEXICO)

numeric(18,4)

NO

0.0000

iva27Amount

iva27Amount

Monto imponible o gravado de IVA al 27% (NO SE UTILIZA EN MEXICO)

numeric(18,4)

NO

0.0000

ivaTaxAmount

ivaTaxAmount

Monto acumulado total de IVA (VAT)

numeric(18,4)

NO

89.5200

manualDiscountAmount

manualDiscountAmount

Monto acumulado de descuento manual + descuento por listas promocionales

(tanto de item como a nivel transacción con impuestos incluidos: IVA e impuestos internos)

numeric(18,4)

NO

0.0000

nccProcessedFlag

nccProcessedFlag

Indica si fue procesada la transacción como  medio de pago nota de crédito

(de uso interno de BRIDGE, para las devoluciones) 

bit

NO

0

netSalesAmount

netSalesAmount

Monto neto de ventas

Monto neto de descuentos de la transacción (grossAmount + perceptionAmount - discounts)

En las siguientes transacciones, se informa en 0: Return 

  • Si la configuración es sin impuestos

Monto neto de descuentos de la transacción (grossAmount + perceptionAmount - discounts) sin IVA

numeric(18,4)

NO

649.0000

offlineFlag

offlineFlag

Indica si la transacción fue realizada fuera de línea (el POS estaba offline de la tienda) 

bit

NO

0

operatorCode

operatorCode

Código de operador o usuario que generó la transacción

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

ver tabla SQL "User"

varchar(256)

SI

lperez

operatorName

operatorName

Nombre del operador o usuario que generó la transacción 

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

ver tabla SQL "User"

varchar(256)

SI

Liliana Perez

originalBillNumber

originalBillNumber

ARG: Número original de factura. Aplica sólo a las transacciones de devoluciones o cambios, número de comprobante fiscal de la transacción original de la venta

MX: Número de folio original de la venta. Aplica sólo a las transacciones de devoluciones o cambios. Es el número enviado en el campo Folio del CFDI de la transacción original de la venta

varchar(256)

SI

2315

originalFiscalPOSNumber

originalFiscalPOSNumber

ARG: Número original de punto de venta fiscal. Aplica sólo a las transacciones de devoluciones o cambios, número de punto de venta fiscal de la transacción original de la venta

MX: Serie original de la venta. Aplica sólo a las transacciones de devoluciones o cambios. Es el número enviado en el campo Serie del CFDI de la transacción original de la venta

varchar(256)

SI

1230

originalSerieOfficialBill

originalSerieOfficialBill

Serie original de factura

Aplica sólo a las transacciones de devoluciones o cambios, serie o letra del comprobante fiscal de la transacción original de la venta

varchar(256)

SI

B

originalStoreCode

originalStoreCode

Código original de tienda

Aplica sólo a las transacciones de devoluciones o cambios, código de la tienda de la transacción original de la venta

varchar(256)

SI

T10

originalTerminalCode

originalTerminalCode

Código original de terminal

Aplica sólo a las transacciones de devoluciones o cambios, número de la terminal o punto de venta de la transacción original de la venta

varchar(256)

SI

35

originalTrxNumber

originalTrxNumber

Número original de transacción 

Aplica sólo a las transacciones de devoluciones o cambios con referencia a una compra original donde el  numero original de la transacción es el "trxNumber" de la venta

int

SI

1235

party

party

Id de cliente

(Id de DB. De uso interno de BRIDGE) 

varchar(256)

SI

N/A

partyAddressCity

partyAddressCity

Nombre de la ciudad de la dirección del cliente

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

ver: tabla SQL "City" 

varchar(256)

SI

Xalapa

partyAddressCountry

partyAddressCountry

Nombre del país de la dirección del cliente

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

ver: tabla SQL "Country" 

varchar(256)

SI

Mexico

partyAddressFirstLine

partyAddressFirstLine

Dirección del cliente

varchar(256)

SI

AVENIDA LAZARO CARDENAS

partyAddressPostalCode

partyAddressPostalCode

Código postal de la dirección del cliente

varchar(256)

SI

91180

partyAddressState

partyAddressState

Nombre del estado o provincia de la dirección del cliente

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

ver: tabla SQL "State" 

varchar(256)

SI

Veracruz

partyCode

partyCode

Código de cliente

El código se genera en BRIDGE según configuración del sistema o es asignado por algún sistema externo

  • por nro de documento
  • por tipo + nro de documento
  • por tipo + nro de documento + tienda
  • nro telefónico

varchar(256)

SI

5514785698

partyEmail

partyEmail

Correo electrónico de cliente

varchar(256)

SI

[email protected]

partyFirstName

partyFirstName

Nombre de cliente 

Solo presente cuando el cliente es tipo persona física.

varchar(256)

SI

Juan

partyIdentificationNumber

partyIdentificationNumber

Número de identificación de cliente (sin guiones, ni puntos) 

Este número dependerá del tipo de documento o identificación 

varchar(256)

SI

XAXX010101000

partyIdentificationType

partyIdentificationType

Tipo de identificación de cliente
Valores posibles para México:

  • 8(INE)

  • 9(RFC)

  • 10(CURP)

  • 26 (RFC Genérico Nacional)

  • 27(RFC Genérico rico Extranjero)

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

ver: tabla SQL 'PartyIdentificationType'

varchar(256)

SI

INE

partyLastName

partyLastName

Apellido de cliente.

Solo presente cuando el cliente es tipo persona física.

varchar(256)

SI

Gonzalez

partyOrganization

partyOrganization

Indicador si el cliente es del tipo empresa u organización 

bit

SI

0

partyPerson

partyPerson

Indicador si el cliente es del tipo persona física 

bit

SI

1

partyTaxCategory

partyTaxCategory

Categoría fiscal de cliente ante el IVA. Valores posibles según región.

Si es cliente persona se le asigna "CF"

Ejemplos ARG: 

  • CF: Consumidor final
  • RI: IVA Responsable Inscripto
  • EX: IVA Exento

(NO SE UTILIZA PARA MX)

varchar(256)

SI

CF

partyTelephone

partyTelephone

Nro de teléfono del cliente

varchar(256)

SI


partyType

partyType

Tipo de cliente. Valores posibles: 

  • PRS (persona física) 
  • OGN (organización o empresa) 

varchar(256)

SI

PRS

perceptionAmount

perceptionAmount

Monto de percepciones de IIBB e IVA (impuesto a clientes de ARG)

numeric(18,4)

NO

0.0000

periodNumber

periodNumber

Número de período 

(Período o día de negocio de la tienda donde se genera la transacción)

int

NO

1

promoDiscountAmount

promoDiscountAmount

Monto de descuento por promociones aplicadas (cuando se encuentra integrado con PROMO)

numeric(18,4)

NO

0.0000

returnAmount

returnAmount

Monto de devolución 

En las transacciones de cambio, se informa sólo si esta genera una devolución o nota de crédito por ser mayor el monto devuelto que el que se compra

En una venta (sale) se informa = 0

numeric(18,4)

NO

0.0000

sbPeriodNumber

sbPeriodNumber

Número de subperíodo (SB)

(Turno o subperíodo de la tienda, donde se genera la transacción) Este puede ser secuencial al nro de período o no (según configuración) 

int

NO

4

sellerID

sellerID

ID del vendedor

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

ver tabla SQL: "User"

varchar(256)

SI

carlosp

sellerName

sellerName

Nombre del vendedor

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

ver tabla SQL: "User"

varchar(256)

SI

Carlos Perez

seq_export

seq_export

Identificador secuencial de exportación (con IDENTITY(1,1))

bigint

NO


serieOfficialBill

serieOfficialBill

Serie o letra asociada al comprobante

ARG: A o B de acuerdo a si es un comprobante emitido a una persona física o a un cliente empresa con condición impositiva ante el IVA como Responsable Inscripto. 

varchar(256)

SI

B

store

store

Id de la Tienda

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

NO

665e4c7812f0503cc8d9b5fe

storeCode

storeCode

Código de tienda 

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

  • ver tabla SQL: "Store" 

varchar(256)

NO

4118

storeName

storeName

Nombre de la tienda

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

  • ver tabla SQL: "Store"

varchar(256)

NO

MARTI BOLIVAR

supervisorCreditTrx

supervisorCreditTrx

Supervisor que autoriza un pago de crédito

(Uso interno de BRIDGE)

varchar(256)

SI

N/A

suspendedFlag

suspendedFlag

Indica si es una transacción suspendida: pendiente de recuperación. Las transacciones suspendidas se cancelan al cierre de período (si es true, no contabiliza ni mueve stock ya que aún no fue finalizada o cancelada) 

bit

NO

0

taxAmount

taxAmount

Monto de impuestos (IVA, impuestos internos y percepciones de IIBB)

IIBB: ingresos brutos, impuesto al cliente de ARG

numeric(18,4)

NO

89.5200

tenderRepository

tenderRepository

Id de la cuenta contable del operador o terminal (según configuración)

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

NO

665e4d6912f0503cc8d9b7ac

terminal

terminal

Id de la terminal

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

NO

665fc391a583a744909a4d59

terminalCode

terminalCode

Código de terminal o punto de venta donde se origina la transacción 

varchar(256)

NO

1

timbrado

timbrado

Indica si la transacción fue timbrada

(De uso interno de BRIDGE)

bit

SI

0

trainingModeFlag

trainingModeFlag

Indica si fue una transacción realizada en  modalidad entrenamiento del operador (no contabiliza fondos de dinero ni movimientos de stock) 

bit

NO

0

transactionDiscountAmount

transactionDiscountAmount

Monto de descuento de la transacción

Importe acumulado de descuentos de la transacción (descuentos por promociones + descuentos manuales) sólo los que son a nivel transacción

numeric(18,4)

NO

0.0000

trxCornerShop

trxCornerShop

Indicador de transacción CornerShop

(de uso interno de BRIDGE) 

bit

SI

N/A

trxNumber

trxNumber

Número de transacción asignado por la terminal (es un nro secuencial que le asigna Bridge a toda operación generada en la terminal) 

int

NO

727

trxRappi

trxRappi

Indicador de Transacción Rappi

(de uso interno de BRIDGE) 

bit

SI

N/A

trxType

trxType

Tipo de transacción. Valores posibles:

  • Sale (Venta)

  • Return (Devolución)

  • Exchange (Cambio con referencia a la compra original)

  • ManualExchange (Cambio sin referencia)

varchar(256)

NO

Sale

trxTypeLang

trxTypeLang

Tipo de transacción: descripción en castellano

  • Venta
  • Devolución
  • Cambio

varchar(256)

SI

Venta

updatedAt

updatedAt

Fecha de actualización del registro en la base de datos origen: MongoDB

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2024-08-27 09:17:30.000

version

version

Versión (de uso interno de BRIDGE) 

int

NO

1

voidedFlag

voidedFlag

Indica si la transacción fue anulada (campo DEPRECADO)

bit

NO

0

xmlTimbrado

xmlTimbrado

XML Timbrado 

(campo DEPRECADO)

text

SI

N/A

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Inserción Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Indicador de procesamiento. Valores posibles:  

N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N


Tabla: transactionRetailItem

Entidad Bridge: TransactionRetailItem

Tabla SQL: transactionRetailItem

Descripción:  Detalle de los artículos incluidos en una venta, devolución o cambio.

Tabla

ClavePrimaria

ClavesForaneas

transactionRetailItem

_id

transactionObjectId (transactionRetail)

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo de valor

transactionObjectId

transactionObjectId

(PK) ID de Objeto de Transacción

varchar(256)

NO

66d2272c0a5da115b22a532f

_id

_id

(PK) Identificador único 

varchar(256)

NO

66d227900f4bc528ec6db1b9

beginDateTime

beginDateTime

Fecha y Hora de Inicio de la transacción 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2025-05-08 13:07:44.977

beginDateTimeAsInt

beginDateTimeAsInt

Fecha y Hora de Inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

20241108

beginDateTimeHour

beginDateTimeHour

Hora de Inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

8

billTotalAmount

billTotalAmount

Monto total del comprobante (incluye impuestos)

numeric(18,4)

NO

649.0000

cancelFlag

cancelFlag

Indica si la transacción fue cancelada (si es true, no contabiliza ni mueve stock) 

bit

NO

0

createdAt

createdAt

Fecha de creación del registro (cuando se distribuye la venta en la tienda) 

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

description

description

Descripción o nombre del producto

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

ver tabla SQL "item"

varchar(256)

SI

Short Nike entrenamiento Bike

extendedPrice

extendedPrice

Precio Extendido

Precio total del producto (precio unitario x cantidad)

Precio total del producto con descuentos aplicados. Incluye impuestos.

Unidad de medida no es fraccionable (property packagePrice = true):

  • extendedPrice = UnitPrice x Quantity  – Descuentos del item

Unidad de medida no es fraccionable (property packagePrice = false):

  • extendedPrice = UnitPrice x Units x Quantity  – Descuentos del item

Unidad de medida fraccionable (nota: no se admite cantidad en un articulo fraccionable)

  • extendedPrice = UnitPrice x Units x Quantity  – Descuentos del item

Nota: el campo Units trae la cantidad de artículos del código de barras en un artículo no fraccionable y la magnitud en un artículo fraccionable


Nota*: La propiedad extendedPrice no excluye los ítems anulados dentro del lineItem. Por ejemplo, se registran 5 unidades vendidas, de las cuales 1 fue anulada. Sin embargo, el extendedPrice refleja el valor correspondiente a las 5 unidades sin tener en cuenta la anulación. 

numeric(18,4)

NO

649.0000

giftCardBalance

giftCardBalance

Saldo de Tarjeta de Regalo

numeric(18,4)

NO

0.0000

giftCardRechargeAmount

giftCardRechargeAmount

Monto Recargado de Tarjeta de Regalo

numeric(18,4)

NO

0.0000

internalCode

internalCode

Código Interno o SKU del producto 

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

ver: tabla SQL "Item"

varchar(256)

SI

2003

itemType

itemType

Tipo de Ítem

Valores posibles: 

  • CONT(Envase)

  • MISC(Miscelaneos)

  • CHRG(Recargos)

  • NORM(Normal)

  • DEPT(Departamental)

  • GRAL(Generico)

  • WRTY(Garantias)

  • SERV(Servicios)

  • GFCD(GiftCard)

  • FUEL(Combustible)

  • ADJM(Ajuste)

  • TAE(Tiempo Aire)

  • EXTRACASH(Adelanto en efectivo)

  • GFCDTY(GiftCard por Tipo)

  • GRALVAT(Genérico para reintegro por tipo IVA)

  • RND(Redondeo)

  • REPAIR(Reparaciones)

  • LUBR(Lubricantes)

  • ANTI(Anticipo)

  • BOL(Bolsas)

  • REFUND(Reembolsos)

  • ADJFINANCE(Ajuste Financiero)

  • PPDCARD(Tarjetas Prepagas)

  • TIP(Propinas)

  • CARRE (Carrera) campo utilizado para Emoción Deportiva (México)

varchar(256)

SI

NORM

locationCode

locationCode

Código de depósito


varchar(256)

SI

DEP1

manualDiscountAmount

manualDiscountAmount

Monto acumulado de descuento manual a nivel item

numeric(18,4)

NO

0.0000

merchandiseHierarchyGroupCode

merchandiseHierarchyGroupCode

Código del Grupo de Jerarquía de Mercancía

varchar(256)

SI

Shorts Bike

merchandiseHierarchyGroupName

merchandiseHierarchyGroupName

Nombre del Grupo de Jerarquía de Mercancía

varchar(256)

SI

Shorts Bike

netAmount

netAmount

Monto Neto. Importe final o neto del producto

Es igual a la base imponible para el cálculo del IVA (es igual al campo taxableAmount dentro del taxType = VAT en TaxDetail)

numeric(18,4)

NO

559.4800

operatorCode

operatorCode

Código Operador o usuario que generó la transacción

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

  • ver tabla SQL "User" (campo "name")

varchar(256)

SI

llopez

operatorName

operatorName

Nombre del Operador o usuario que generó la transacción

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

  • ver tabla SQL "User" (campo "userName")

varchar(256)

SI

Liliana Perez

perceptionTotal

perceptionTotal

Total acumulado de percepciones a nivel item (de IIBB e IVA, impuestos del cliente para ARG)

numeric(18,4)

NO

0.0000

periodNumber

periodNumber

Número de Período (Período o día de negocio de la tienda donde se genera la transacción)

int

NO

1

promoDiscountAmount

promoDiscountAmount

Monto de descuento por promociones aplicadas (cuando se encuentra integrado con PROMO) a nivel ítem

numeric(18,4)

NO

0.0000

prorratedTxDiscount

prorratedTxDiscount

Descuento a nivel transacción prorrateado por cada item 

numeric(18,4)

NO

0.0000

quantity

quantity

Cantidad de items 

Cuando el ítem tiene como unidad de medida una fraccionable, entonces la cantidad por defecto es 1 y se combina con el campo "Units"

numeric(18,4)

NO

1.0000

returned

returned

Indicador de si el item es devuelto (en venta aplicaría para los casos de envases, redondeos. etc) 
Idem en el caso de los items que son devueltos dentro de una transacción d cambio

En true cuando el ítem se está devolviendo (si la transacción es una venta, false / si la transacción es una devolución, true / si la transacción es un cambio, true para el artículo que se devuelve, y false para el nuevo artículo que el cliente se lleva)

También está en true cuando se trata de un ítem de ExtraCash (itemType: EXTRACASH) o de Redondeo (itemType: RND) o de envases (itemType: CONT)

bit

NO

0

sbPeriodNumber

sbPeriodNumber

Número de Período (SB)

(Turno o subperíodo de la tienda, donde se genera la transacción) Este puede ser secuencial al nro de período o no (según configuración) 

int

NO

4

sellerID

sellerID

ID del Vendedor

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

  • ver tabla SQL "User" (campo "name")

varchar(256)

SI

carlosp

sellerName

sellerName

Nombre del Vendedor

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

  • ver tabla SQL "User" (campo "userName")

varchar(256)

SI

Carlos Perez

sequenceNumber

sequenceNumber

Número de Secuencia

int

NO

1

store

store

Id de Tienda

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

665e4c7812f0503cc8d9b5fe

storeCode

storeCode

Código de Tienda

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

  • ver tabla SQL: "Store" (campo "code")

varchar(256)

SI

4118

storeName

storeName

Nombre de la Tienda

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

  • ver tabla SQL: "Store" (campo "name")

varchar(256)

SI

MARTI BOLIVAR

suspendedFlag

suspendedFlag

Indica si es una transacción suspendida: pendiente de recuperación. Las transacciones suspendidas se cancelan al cierre de período (si es true, no contabiliza ni mueve stock ya que aún no fue finalizada o cancelada) 

bit

NO

0

taxTotal

taxTotal

Total de Impuestos

Monto de impuestos (IVA, impuestos internos y percepciones de IIBB)

numeric(18,4)

NO

0.0000

terminal

terminal

Id de la Terminal

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

665fc391a583a744909a4d59

terminalCode

terminalCode

Código de terminal o punto de venta donde se origina la transacción 

varchar(256)

SI

1

trainingModeFlag

trainingModeFlag

Indica si fue una transacción realizada en  modalidad entrenamiento del operador (no contabiliza fondos de dinero ni movimientos de stock) 

bit

NO

0

trxNumber

trxNumber

Número de transacción asignado por la terminal (es un nro secuencial que le asigna Bridge a toda operación generada en la terminal) 

numeric(18,4)

NO

727

trxType

trxType

Tipo de Transacción

Valores posibles:

  • Sale (Venta)

  • Return (Devolucion)

  • Exchange (Cambio)

varchar(256)

SI

Sale

unitOfMeasureCode

unitOfMeasureCode

Código de Unidad de Medida

Lista de valores posibles: ver tabla 'UnitOfMeasure'

Ejemplos: 

  • u (Unidad)
  • kg (Kilogramo)
  • g (Gramo)
  • l (litro)
  • m (Metro)
  • c3 (Centímetro Cúbico)

varchar(256)

SI

u

unitOfMeasureDecimals

unitOfMeasureDecimals

Decimales de Unidad de Medida del artículo

(Si la cantidad de decimales es mayor a 0, se considera fraccionable. Ejemplo: litros, kilos) 

numeric(18,4)

NO

0.0000

unitPrice

unitPrice

Precio Unitario

numeric(18,4)

NO

649.0000

units

units

Unidades

Unidad de venta (si es por código de barras por defecto es 1).

Cuando la unidad de medida es fraccionable, se informa la magnitud (litros, kilos, gramos, etc) vendidos

numeric(18,4)

NO

1.0000

updatedAt

updatedAt

Fecha de actualización del registro en la base de datos origen: MongoDB (Uso interno de BRIDGE)

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

vatTotal

vatTotal

Total de IVA del item

numeric(18,4)

NO

89.5200

version

version

Versión

(Uso interno de BRIDGE) 

numeric(18,4)

NO

0

voidedQuantity

voidedQuantity

Cantidad Anulada del item

numeric(18,4)

NO

0.0000

voidFlag

voidFlag

Indica si es una Anulación de un item 

voidFlag = true sólo cuando el artículo original está anulado por completo

bit

NO

0

voiding

voiding

Indica si es una Anulación de un item

voiding = true indica que la cantidad se resta de la transacción. Es un lineItem de anulación

bit

NO

0

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Campos discontinuados

Los siguientes campos han sido eliminados de la estructura de datos de transactionRetailItem en la última actualización:

  • folio: Relacionado con la facturación.

  • idsat: Campo vinculado a la facturación electrónica en México.

  • itemSerialNumber: Número de Serie del Ítem.

  • pedimento: Información aduanera o de importación.

  • totalAmount: Se ha eliminado el campo de monto total.

Tabla: transactionRetailDiscount

Entidad Bridge: TransactionRetailDiscount

Tabla SQL: transactionRetailDiscount

Descripción:  Detalle de los descuentos de las transacciones.

Tabla

ClavePrimaria

ClavesForaneas

transactionRetailDiscount

_id

transactionObjectId (transactionRetail)

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

transactionObjectId

transactionObjectId

(FK) ID de Objeto de Transacción 

varchar(256)

NO

66b252eac969441ce1e748c9

_id

_id

(PK) Identificador único del registro. 

varchar(256)

NO

66b25366b33e780e1459603e

action

action

Acción: si suma o resta (SB= resta, AD=suma)

Valores posibles:

  • SB (resta) 
  • AD (suma) 

varchar(256)

SI

SB

beginDateTime

beginDateTime

Fecha y hora de inicio de la transacción 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2025-05-08 13:07:44.977

beginDateTimeAsInt

beginDateTimeAsInt

Fecha y hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

20241108

beginDateTimeHour

beginDateTimeHour

Hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

8

benefitClass

benefitClass

Clase de Beneficio. Valores posibles:

  • "monetary"

varchar(256)

NO

monetary

benefitNumber

benefitNumber

Número de Beneficio

(dato de la promoción)

varchar(256)

SI

669700bb451ed803dadbe2b8

benefitPercent

benefitPercent

Porcentaje de Beneficio

numeric(18,4)

NO

10.0000

benefitValue

benefitValue

Valor del Beneficio

numeric(18,4)

NO

64.9000

cancelFlag

cancelFlag

Indica si la transacción fue cancelada (si es true, no contabiliza ni mueve stock) 

bit

NO

0

createdAt

createdAt

Fecha de creación del registro (cuando se distribuye la venta en la tienda) 

(Uso interno de BRIDGE) 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2025-05-08 13:07:44.977

description

description

Descripción o nombre del producto

varchar(256)

NO

Short Nike entrenamiento Bike

internalCode

internalCode

Código Interno o SKU del producto 

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

ver: tabla SQL "Item"

varchar(256)

NO

2003

message

message

Mensaje definido en la promoción – solo si es por promoción (no para descuento manual)

(dato de la promoción)

varchar(256)

SI

WS - PROMO 10%

operatorCode

operatorCode

Código de operador o usuario que generó la transacción

  • ver tabla SQL "User" (campo "name")

varchar(256)

NO

lperez

operatorName

operatorName

Nombre del operador o usuario que generó la transacción 

  • ver tabla SQL "User" (campo "userName")

varchar(256)

NO

Liliana Perez

periodNumber

periodNumber

Número de Período

(Período o día de negocio de la tienda donde se genera la transacción)

int

NO

1

promoDescription

promoDescription

Descripción de la promoción – solo si es por promoción (no para descuento manual)

(dato de la promoción)

varchar(256)

SI

WS - PROMO 10%

promotionNumber

promotionNumber

Nro de promoción – solo si es por promoción (no para descuento manual)

varchar(256)

SI

669700bb451ed803dadbe2ba

reason

reason

Código del motivo del descuento

varchar(256)

SI

PM

sbPeriodNumber

sbPeriodNumber

Número de Período (SB)

(Turno o subperíodo de la tienda, donde se genera la transacción) Este puede ser secuencial al nro de período o no (según configuración) 

int

NO

4

sequenceNumber

sequenceNumber

Número de Secuencia

Secuencia del item al que aplica

varchar(256)

NO

1

store

store

Id de la Tienda

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

NO

665e4c7812f0503cc8d9b5fe

storeCode

storeCode

Código de Tienda

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

  • ver tabla SQL: "Store" (campo "code")

varchar(256)

NO

4118

storeName

storeName

Nombre de la Tienda

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

  • ver tabla SQL: "Store" (campo "name")

varchar(256)

NO

MARTI BOLIVAR

terminal

terminal

Id de la terminal

(Id de MongoDB. De uso interno de BRIDGE) 

varchar(256)

NO

665fc391a583a744909a4d59

terminalCode

terminalCode

Código de terminal o punto de venta donde se origina la transacción 


varchar(256)

NO

1

trxNumber

trxNumber

Número de transacción asignado por la terminal (es un nro secuencial que le asigna Bridge a toda operación generada en la terminal) 

int

NO

691

trxType

trxType

Tipo de Transacción

Valores posibles:

  • Sale (Venta)

  • Return (Devolucion)

  • Exchange (Cambio)

varchar(256)

NO

Sale

type

type

Tipo de descuento o beneficio

Valores posibles:

  • PER(por porcentaje)

  • AMT(por monto)

varchar(256)

SI

PER

updatedAt

updatedAt

Fecha de actualización del registro 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2025-05-08 13:07:44.977

version

version

Versión (dato de uso interno de BRIDGE) 

numeric(18,4)

NO

0

Datos personalizados

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N


Tabla: transactionRetailPayment


Entidad Bridge: TransactionRetailPayment

Tabla SQL: transactionRetailPayment

Descripción:  Detalle de los pagos de las transacciones.

Tabla

ClavePrimaria

ClavesForaneas

transactionRetailPayment

_id

transactionObjectId (transactionRetail)


Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

transactionObjectId

transactionObjectId

(FK) ID de Objeto de Transacción 

varchar(256)

SI

66d2272c0a5da115b22a532f

_id

_id

(PK) Identificador único (ID de BD)

varchar(256)

NO

66d227900f4bc528ec6db1bb

amount

amount

Monto del pago 

numeric(18,4)

NO

649.0000

BankNameTransfer

BankNameTransfer

Nombre de la entidad financiera

varchar(256)

SI


beginDateTime

beginDateTime

Fecha y hora de inicio de la transacción 

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2024-08-27 09:17:30.000

beginDateTimeAsInt

beginDateTimeAsInt

Fecha y hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

20241108

beginDateTimeHour

beginDateTimeHour

Hora de inicio como valor entero

(Uso interno de BRIDGE para reportes) 

int

NO

8

billNumber

billNumber

Número de comprobante fiscal o de factura electrónica

varchar(256)

SI

00000727

billType

billType

Tipo de comprobante:

  • ARG: FC A, FC B, NC A, NC B, Remito: RM A, RM B 
  • MX

varchar(256)

SI

TK B

cancelFlag

cancelFlag

Indica si la transacción fue cancelada (si es true, no contabiliza ni mueve stock) 

bit

NO

0

card

card

Indica si el pago es de una Tarjeta (bancaria) o no

bit

NO

1

cardAuthorizationCode

cardAuthorizationCode

Código de Autorización de Tarjeta (bancaria)

varchar(256)

SI


cardCouponNumber

cardCouponNumber

Número de Cupón de Tarjeta 

varchar(256)

SI


cardCouponNumberOff

cardCouponNumberOff

Cupón de Tarjeta Alternativo

varchar(256)

SI


cardNumber

cardNumber

Número de Tarjeta (se guarda enmascarado)

varchar(256)

SI


change

change

Cambio o vuelto (sólo en caso de ser un pago en efectivo) 

numeric(18,4)

NO

0.0000

createdAt

createdAt

Fecha de creación del registro (cuando se distribuye la venta en la tienda) 

(Uso interno de BRIDGE) 

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2024-08-27 09:17:30.000

currencyISOCode

currencyISOCode

Código de Moneda ISO asociado al pago 

  • MXN: PESO MEXICANO
  • USD: Dolar
  • EUR: EURO
  • CLP: PESO CHILENO
  • PPEN: SOL
  • ARS: PESO ARGENTINO

varchar(256)

SI

MXN

extraCashAmount

extraCashAmount

Monto de adelanto de Efectivo (extraCash)

numeric(18,4)

SI

0.0000

extraCashCupon

extraCashCupon

Cupón de la operación de adelanto de Efectivo (extraCash)

varchar(256)

SI

0.0000

fiscalPosNumber

fiscalPosNumber

Número de Punto de Venta Fiscal o centro emisor 

varchar(256)

SI

1

foreignAmount

foreignAmount

Monto en Moneda Extranjera (para cuando es un pago en efectivo) 

numeric(18,4)

NO

0.0000

foreignChange

foreignChange

Vuelto o Cambio en Moneda Extranjera (para cuando es un pago en efectivo)

numeric(18,4)

NO

0.0000

foreignCurrencyQuote

foreignCurrencyQuote

Cotización de Moneda Extranjera (con respecto a la moneda base) 

Configuración del medio de pago 

numeric(18,4)

NO

1.0000

installments

installments

Cantidad  de Cuotas del pago (aplica cuando es tarjeta bancaria y tiene planes de pago con cuotas

Definido como parte del plan de pagos 

varchar(256)

SI

3

lotNumber

lotNumber

Número de Lote (cuando es un pago con tarjeta bancaria) 

varchar(256)

SI

-

netAmount

netAmount

Monto Neto del pago 

numeric(18,4)

NO

649.0000

operatorCode

operatorCode

Código de operador o usuario que generó la transacción

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

ver tabla SQL: "User" (campo "name")

varchar(256)

SI

lperez

operatorName

operatorName

Nombre del operador o usuario que generó la transacción 

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

ver tabla SQL: "User" (campo "UserName")

varchar(256)

SI

Liliana Perez

periodNumber

periodNumber

Número de Período de la tienda

(Período o día de negocio de la tienda donde se genera la transacción)

int

NO

1

planDescriptor

planDescriptor

Descripción del Plan de pagos (para tarjetas bancarias) 

Configuración de planes 

varchar(256)

SI

Meses sin interés VISA

provider

provider

Proveedor


varchar(256)

SI

999

referenceNumber

referenceNumber

Número de Referencia

varchar(256)

SI

-

sbPeriodNumber

sbPeriodNumber

Número de subperíodo (SB)

(Turno o subperíodo de la tienda, donde se genera la transacción) Este puede ser secuencial al nro de período o no (según configuración) 

int

NO

4

sellerName

sellerName

Nombre del Vendedor

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

ver tabla SQL: 'User'

varchar(256)

SI

Carlos Perez

serieOfficialBill

serieOfficialBill

Serie o letra asociada al comprobante

ARG: A o B de acuerdo a si es un comprobante emitido a una persona física o a un cliente empresa con condición impositiva ante el IVA como Responsable Inscripto. 

varchar(256)

SI

B

store

store

Id de la Tienda

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

665e4c7812f0503cc8d9b5fe

storeCode

storeCode

Código de Tienda

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

  • ver tabla SQL: "Store" (campo "code")

varchar(256)

SI

4118

storeName

storeName

Nombre de la Tienda

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

  • ver tabla SQL: "Store" (campo "name")

varchar(256)

SI

MARTI BOLIVAR

surcharge

surcharge

Monto de recargo (aplica a planes de pago con recargo financiero) 

numeric(18,4)

NO

0.0000

suspendedFlag

suspendedFlag

Indica si es una transacción suspendida: pendiente de recuperación. Las transacciones suspendidas se cancelan al cierre de período (si es true, no contabiliza ni mueve stock ya que aún no fue finalizada o cancelada) 

bit

NO

0

tender

tender

Id del Medio de Pago

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

5ea5565d5604c8593c60841f

tenderCode

tenderCode

Código del medio de Pago

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

ver tabla SQL: tender (campo code) 

varchar(256)

SI

Peso

tenderName

tenderName

Nombre del medio de Pago

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

ver tabla SQL: tender (campo descriptor) 

varchar(256)

SI

EFECTIVO

tenderRepository

tenderRepository

Id de la cuenta contable del operador o terminal (según configuración)

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

665e4d6912f0503cc8d9b7ac

terminal

terminal

Id de la Terminal

(Id de BD. De uso interno de BRIDGE) 

varchar(256)

SI

665fc391a583a744909a4d59

terminalCode

terminalCode

Código de terminal o punto de venta donde se origina la transacción 

varchar(256)

SI

1

trainingModeFlag

trainingModeFlag

Indica si fue una transacción realizada en  modalidad entrenamiento del operador (no contabiliza fondos de dinero ni movimientos de stock) 

bit

NO

0

trxNumber

trxNumber

Número de transacción asignado por la terminal (es un nro secuencial que le asigna Bridge a toda operación generada en la terminal) 

int

NO

727

trxType

trxType

Tipo de Transacción

Valores posibles:

  • Sale (Venta)

  • Return (Devolucion)

  • Exchange (Cambio con referencia a compra original)

  • ManualExchante (Cambio)

varchar(256)

SI

Sale

updatedAt

updatedAt

Fecha de actualización del registro 

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2024-08-27 09:17:30.000

version

version

Versión (dato de uso interno de BRIDGE) 

numeric(18,4)

NO

0

voided

voided

Indica si el pago fue anulado o no

bit

NO

0

voiding

voiding

Indica si el pago es anulación de otro pago

bit

NO

0

vtolStore

vtolStore

Código de la tienda de Vtol (si la validación del medio de pago es con VTOL)

varchar(256)

SI

-

vtolTerminal

vtolTerminal

Código de la terminal de Vtol (si la validación del medio de pago es con VTOL)

varchar(256)

SI

-

walletPaymentId

walletPaymentId

Identificador de Pago con Billetera Digital

  • ARG: Identificador del número de pago informado por el Autorizador de la billetera electrónica (ejemplo: para Mercado Pago)

varchar(64)

SI


Datos personalizados

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Campos discontinuados

Los siguientes campos han sido eliminados de la estructura de datos de transactionRetailPayment en la última actualización:

  • BankNameTransfer (Nombre del banco en transferencias, ya no requerido en la nueva estructura)

  • bankdescription (Descripción del banco para transferencias, eliminado por redundancia)

  • prochemex (Registro relacionado con Prochemex en Cheques MEX, removido por actualización de procesos)

  • transferNumber (Número de referencia de transferencias, eliminado debido a cambios en la gestión de pagos)


Tabla: party


JSON NewCustomer – SQL party

Entidad Bridge: Party

Tabla SQL: party

Descripción:  Detalle de los clientes.

Tabla

ClavePrimaria

ClavesForaneas

party

_id

–

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) Identificador único del registro en la base de datos - De uso interno de Bridge

varchar(256)

NO

665f60a5a583a744909a4d41

_class

_class

Clase del objeto o entidad

(De uso interno de BRIDGE)

  • Person
  • Organization

varchar(256)

SI

Person

apiProcessed

apiProcessed

Indica si el cliente fue procesado por api  (De uso interno de Bridge)

bit

NO

1

birthCountryCode

birthCountryCode

Código de País de Nacimiento

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

ver tabla SQL: Country (campo "code")

varchar(256)

SI

MEX

birthDayNumber

birthDayNumber

Día de Nacimiento

(sino tiene el dato, se guarda como 0)

int

NO

24

birthMonthNumber

birthMonthNumber

Mes de Nacimiento

(sino tiene el dato, se guarda como 0)

int

NO

05

birthYearNumber

birthYearNumber

Año de Nacimiento

(sino tiene el dato, se guarda como 0)

int

NO

1983

code

code

Código interno de la persona o entidad generado por Bridge

varchar(256)

SI

JUML6404287V4

createdAt

createdAt

Fecha y hora de Creación del registro.

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

creditBillAvailable

creditBillAvailable

Indica si puede facturar a crédito    

bit

SI

0

disabled

disabled

Indica el estado del cliente, las opciones son habilitado o deshabilitado

bit

NO

0

email

email

Dirección de correo electrónico del cliente

varchar(256)

SI

[email protected]

exemptFlag

exemptFlag

Indica si es exento de impuestos

bit

NO

0

firstName

firstName

Nombre del cliente

varchar(256)

SI

Juan 

genderType

genderType

Género de la persona: 'F' para mujer y 'M' para hombre. 'NB' para no binario

(sino lo tiene registrado = NULL)

varchar(256)

SI

M

identificationType

identificationType

ID de BD del tipo de documento (identificación del cliente)

ver: tabla SQL 'PartyIdentificationType' (para obtener el Código)

varchar(256)

SI

61dd9ac34123d1da4867938d

identifier

identifier

Número de identificación personal asociado al tipo de documento seleccionado.

varchar(256)

SI

0000000000123

lastName

lastName

Apellido del cliente

varchar(256)

SI

Martinez

middleNames

middleNames

Segundo nombre del cliente

varchar(64)

SI

Jose

name

name

Nombre y apellido del cliente concatenados (firstName lastName)

varchar(256)

SI

Juan Jose Martinez

store

store

Código de la Tienda Bridge

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

  • ver tabla SQL: "Store" (campo "code")

varchar(256)

SI

1

typeCode

typeCode

Define el tipo de cliente

  • PRS (Persona) 
  • OGN (Empresa u organización)

varchar(256)

SI

PRS

updatedAt

updatedAt

Fecha de última actualización del registro del cliente

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

version

version

Versión del registro (para control de cambios - Uso Interno Bridge)

int

NO

0

Campos de control Martí - Tabla: party

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:15:00.137

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Estado de procesamiento 

  • N=Nuevo
  • Y=Procesado
  • E=Error

varchar(3)

NO

N

Campos discontinuados

Los siguientes campos han sido eliminados de la estructura de datos de party en la última actualización:

  • isCredit (Bandera que indicaba si el cliente tenía crédito, eliminada en la nueva versión).

  • membership (Número de membresía del cliente, ya no se almacena en esta tabla).

  • middleNames (Campo de segundos nombres, removido de la estructura de datos).

  • partyCRSegment (Segmento de cliente, eliminado por cambios en la segmentación de datos).

  • partyRoleAssignment (Asignación de rol de cliente, ya no se gestiona en esta tabla).



Tabla: partyContactMethod


JSON NewCustomer.contactMethods – SQL partyContactMethod

Entidad Bridge: PartyContactMethod

Tabla SQL: partyContactMethod

Descripción:  Detalle de los metodos de contacto de los clientes.

Tabla

ClavePrimaria

ClavesForaneas

partyContactMethod

_id

party (party)

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) Identificador único del registro en la base de datos

(De uso interno de BRIDGE)

varchar(256)

NO

665f6239a583a744909a4d46

areaCode

areaCode

Código de área de la ciudad

varchar(256)

SI

55

betweenStreets

betweenStreets

Calles entre las que se ubica el domicilio del cliente.    

varchar(256)

SI


city

city

ID de la ciudad correspondiente a la dirección de contacto.

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

ver: tabla SQL "City" (para  obtener el campo "Code")

varchar(256)

SI

61dd8ac44123d1da485c0551

code

code

Código del cliente asociado (uso interno de BRIDGE) 

varchar(256)

SI

JPC123202408K_Personal

country

country

ID del país del domicilio del cliente.    

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

ver: tabla SQL "Country" (para obtener el campo "Name")

varchar(256)

SI

60a2cd97cef5bbf0aad4a629

countryCode

countryCode

Código del país del domicilio del cliente. 

varchar(256)

SI

52

disabled

disabled

Indica si el método de contacto está deshabilitado

bit

NO

0

effectiveDate

effectiveDate

Fecha de inicio de vigencia del contacto

Formato: YYYY-MM-DD HH:MM:SS

varchar(256)

SI

2024-10-07T11:50:10

emailAddress

emailAddress

Dirección de correo electrónico asociada al contacto.

varchar(256)

SI

[email protected]

expirationDate

expirationDate

Fecha de vencimiento ó expiración del contacto

Formato: YYYY-MM-DD HH:MM:SS

varchar(256)

SI

9999-12-31T11:42:00

extensionNumber

extensionNumber

Número de extensión telefónica si corresponde.

varchar(256)

SI


firstLine

firstLine

Primera línea del domicilio, generalmente utilizada para calle y número.

varchar(256)

SI

25 de mayo 456

fourthLine

fourthLine

Cuarta línea del domicilio (uso libre para información adicional como barrio, referencia, etc.).

varchar(256)

SI


name

name

Nombre asignado al método de contacto.

varchar(256)

SI

Personal

party

party

(FK) Id Cliente asociado al método de contacto.

(Id de BD)

varchar(256)

NO


partyCode

partyCode

Código del cliente al cual está asociado el método de contacto.    

varchar(256)

SI

JPC123202408K

postalCode

postalCode

Código postal correspondiente al domicilio.

varchar(256)

SI

05000

principalForBilling

principalForBilling

Indica si esta dirección o contacto es el principal para facturación (1 = sí, 0 = no).

bit

NO

1

principalForDelivery

principalForDelivery

Indica si esta dirección o contacto es el principal para entregas (1 = sí, 0 = no).

bit

NO

1

secondLine

secondLine

Segunda línea del domicilio (por ejemplo, departamento, piso o unidad).

varchar(256)

SI


state

state

ID de la provincia o estado correspondiente al domicilio.

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

ver: tabla SQL "State" (para obtener el campo "Code")

varchar(256)

SI

61dd819c4123d1da48562058

telephoneNumber

telephoneNumber

Número telefónico de contacto.    

varchar(256)

SI

23214567

thirdLine

thirdLine

Tercera línea del domicilio (uso adicional para observaciones o referencias específicas).

varchar(256)

SI


version

version

Número de versión del registro para control de cambios.

Uso interno de Bridge

numeric(18,4)

NO

0

Campos de control Martí - Tabla: partyContactMethod

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

Ejemplo

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

2025-05-08 13:15:00.137

datetime

SI

2025-05-08 13:15:00.137

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

2025-05-08 13:15:00.137

datetime

SI

2025-05-08 13:15:00.137

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Campos discontinuados

Los siguientes campos han sido eliminados de la estructura de datos de partyContactMethod en la última actualización:

  • telephone.areaCode (Ahora reemplazado por areaCode en la nueva estructura).

  • address.betweenStreets. Campo eliminado.

  • address.city (Ahora se usa simplemente city).

  • telephone.countryCode (Ahora se usa simplemente countryCode).

  • address.country (Ahora se usa simplemente country).

  • address.extensionNumber (Eliminado de la nueva estructura).

  • address.firstLine (Ahora se usa simplemente firstLine).

  • address.fourthLine (Ahora se usa simplemente fourthLine).

  • address.postalCode (Ahora se usa simplemente postalCode).

  • address.secondLine (Ahora se usa simplemente secondLine).

  • address.thirdLine (Ahora se usa simplemente thirdLine).

  • telephone.telephoneNumber (Ahora se usa simplemente telephoneNumber).


Tabla: tenderTransaction


Entidad Bridge: TenderTransaction

Tabla SQL: tenderTransaction

Descripción:  Cabecera de Operaciones de no venta

Tabla

ClavePrimaria

ClavesForaneas

tenderTransaction

transactionObjectId

–

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

beginDateTime

beginDateTime

Fecha y Hora de Inicio

datetime

SI

businessDayDate

businessDayDate

Fecha del Día de Negocio

datetime

SI

createdAt

createdAt

Fecha de Creación

varchar(256)

SI

endDateTime

endDateTime

Fecha y Hora de Finalización

datetime

SI

isAutomatic

isAutomatic

Bandera Es Automático

bit

SI

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

period

period

Período

int

NO

rsUser

rsUser

Usuario

varchar(256)

SI

safe

safe

Caja Fuerte

varchar(256)

SI

sequenceNumber

sequenceNumber

Número de Secuencia

numeric(18,4)

NO

store

store

Tienda

varchar(256)

SI

storeCode

storeCode

Código de Tienda

varchar(256)

SI

storeSafeCode

storeSafeCode

Código de Caja Fuerte de Tienda

varchar(256)

SI

subperiod

subperiod

Subperíodo

numeric(18,4)

NO

tenderTransactionStatus

tenderTransactionStatus

Estado de la Transacción de Pago

varchar(256)

SI

terminalCode

terminalCode

Código de Terminal

varchar(256)

SI

till

till

Caja

varchar(256)

SI

tillCode

tillCode

Código de Caja

varchar(256)

SI

tillTo

tillTo

Caja Destino

varchar(256)

SI

tillType

tillType

Tipo de Caja

varchar(256)

SI

totals

totals

Totales

numeric(18,4)

NO

transactionObjectId

transactionObjectId

ID de Objeto de Transacción

varchar(256)

NO

trxOrigin

trxOrigin

Transacción Origen

varchar(256)

SI

typeCode

typeCode

Código de Tipo

Valores posibles:

  • tenderOutflow(Egresos) 

  • tenderInflow(Ingresos)

  • tenderLoan(Dotación)

  • tenderPickup(Retiro)

  • tenderWithDrawal(Rendición)

varchar(256)

SI

updatedAt

updatedAt

Fecha de Actualización

varchar(256)

SI

userName

userName

Nombre de Usuario

varchar(256)

SI

userNameDescription

userNameDescription

Descripción del Nombre de Usuario

varchar(256)

SI

version

version

Versión

numeric(18,4)

NO

workStation

workStation

Estación de Trabajo

varchar(256)

SI


Tabla: tenderTransactionDetail


JSON TenderTransaction.tenderTranItems – SQL tenderTransactionDetail

Entidad Bridge: TenderTransaction.tenderTranItems

Tabla SQL: tenderTransactionDetail

Descripción:  Detalle de operacions de no venta

Tabla

ClavePrimaria

ClavesForaneas

tenderTransactionDetail

_id

transactionObjectId (tenderTransaction)

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

_id

_id

Identificador

int

NO

amount

amount

Monto

numeric(18,4)

NO

externalDepository

externalDepository

Depósito Externo

varchar(256)

SI

foreignCurrencyQuoteFactor

foreignCurrencyQuoteFactor

Factor de Cotización de Moneda Extranjera

numeric(18,4)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

qty

qty

Cantidad

numeric(18,4)

NO

tender

tender

Forma de Pago

varchar(256)

NO

tenderCode

tenderCode

Código de Forma de Pago

varchar(256)

SI

tenderName

tenderName

Nombre de Forma de Pago

varchar(256)

SI

transactionObjectId

transactionObjectId

ID de Objeto de Transacción

varchar(256)

NO


Tabla: safeTransaction


JSON TenderInflow – SQL safeTransaction

Entidad Bridge: SafeTransacion

Tabla SQL: safeTransaction

Descripción:  Operaciones de caja

Tabla

ClavePrimaria

ClavesForaneas

safeTransaction

_id

–

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

SI

bagNumber

bagNumber

Número de Bolsa

varchar(256)

SI

beginDateTime

beginDateTime

Fecha y Hora de Inicio

datetime

SI

businessDayDate

businessDayDate

Fecha del Día de Negocio

datetime

SI

cancelFlag

cancelFlag

Bandera de Cancelación

bit

NO

contigencyFlag

contigencyFlag

Bandera de Contingencia

bit

NO

docNumber

docNumber

Número de Documento

varchar(256)

SI

endDateTime

endDateTime

Fecha y Hora de Finalización

datetime

SI

note

note

Nota

varchar(256)

SI

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

offlineFlag

offlineFlag

Bandera Fuera de Línea

bit

NO

originalTransaction

originalTransaction

Transacción Original

varchar(256)

SI

periodCode

periodCode

Código de Período

int

NO

periodNumber

periodNumber

Número de Período

int

NO

safeId

safeId

ID de Caja Fuerte

varchar(256)

SI

sbPeriodNumber

sbPeriodNumber

Número de Subperíodo

int

NO

storeCode

storeCode

Código de Tienda

varchar(256)

SI

subPeriodCode

subPeriodCode

Código de Subperíodo

numeric(18,4)

NO

suspendedFlag

suspendedFlag

Bandera de Suspensión

bit

NO

terminalCode

terminalCode

Código de Terminal

varchar(256)

SI

tillCode

tillCode

Código de Caja

varchar(256)

SI

tillType

tillType

Tipo de Caja

varchar(256)

SI

totals

totals

Totales

numeric(18,4)

SI

trainingModeFlag

trainingModeFlag

Bandera de Modo de Entrenamiento

bit

NO

trxNumber

trxNumber

Número de Transacción

numeric(18,4)

NO

trxOrigin

trxOrigin

Origen de Transacción

varchar(256)

SI

trxStatus

trxStatus

Estado de Transacción

varchar(256)

SI

typeCode

typeCode

Tipo de Transacción

Valores posibles:

  • TenderInflow(Ingreso)

  • TenderOutflow(Egreso)

  • TenderReceipt(Entrega de valores)

  • TenderDeposit(Reposición de valores)

  • TenderSafeTransfer(Transferencia de caja)

varchar(256)

SI

trxTypeCode

trxTypeCode

Código de Tipo de Transacción

numeric(18,4)

NO

updatedAt

updatedAt

Actualizado en

datetime

SI

userName

userName

Nombre de Usuario

varchar(256)

SI

voidedFlag

voidedFlag

Bandera de Anulado

bit

NO

Campos discontinuados

Los siguientes campos han sido eliminados de la estructura de datos de safeTransaction en la última actualización:

  • tenderControlTransaction.TenderInflow.bagNumber (Ahora reemplazado por bagNumber directamente).

  • tenderControlTransaction.TenderInflow.docNumber (Ahora es docNumber directamente).

  • tenderControlTransaction.TenderInflow.totals (Ahora es simplemente totals).

  • tenderControlTransaction.TenderInflow.note (Ahora es simplemente note).


Tabla: safeTransactionDetail


JSON TenderInFlow.tenderControlTransactionTenderLineItems – SQL safeTransactionDetail

Entidad Bridge: SafeTranItem

Tabla SQL: safeTransactionDetail

Descripción:  Detalle de operaciones de Caja

Tabla

ClavePrimaria

ClavesForaneas

safeTransactionDetail

IdSafeTransactionDetail

safeId (safeTransaction)

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

amount

amount

Monto

numeric(18,4)

NO

comments

comments

Comentarios

varchar(256)

SI

count

count

Cantidad

int

NO

exchangeRate

exchangeRate

Tasa de Cambio

numeric(18,4)

NO

externalDepositoryCode

externalDepositoryCode

Código de Depósito Externo

varchar(256)

SI

externalDepositoryId

externalDepositoryId

ID de Depósito Externo

varchar(256)

SI

foreignCurrencyAmount

foreignCurrencyAmount

Monto en Moneda Extranjera

numeric(18,4)

NO

IdSafeTransactionDetail

IdSafeTransactionDetail

ID de Detalle de Transacción Segura

int

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

retailStoreId

retailStoreId

ID de Tienda Minorista

varchar(256)

SI

safeId

safeId

ID de Transacción

varchar(256)

SI

sequenceNumber

sequenceNumber

Número de Secuencia

int

NO

tenderDescription

tenderDescription

Descripción de Forma de Pago

varchar(256)

NO

tenderId

tenderId

ID de Forma de Pago

varchar(256)

NO

tenderTypeCode

tenderTypeCode

Tipo de Forma de Pago

varchar(256)

NO


Tabla: controlTransaction


JSON BusinessEOD – SQL controlTransaction

Entidad Bridge: 

Tabla SQL: controlTransaction

Descripción:  Transacciones de validación de cierre

Tabla

ClavePrimaria

ClavesForaneas

controlTransaction

_id

–

Campo JSON

Campo SQL

Descripción

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

beginDateTime

beginDateTime

Fecha y Hora de Inicio

datetime

NO

businessDayDate

businessDayDate

Fecha del Día de Negocio

datetime

NO

cancelFlag

cancelFlag

Indicador si la transaccion esta cancelada

bit

NO

contigencyFlag

contigencyFlag

Indicador de la transaccion es de contingencia

bit

NO

createdAt

createdAt

Fecha de creación

datetime

SI

endDateTime

endDateTime

Fecha y Hora de Finalización

datetime

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

offlineFlag

offlineFlag

Bandera Fuera de Línea

bit

NO

originalTransaction

originalTransaction

Transacción Original

varchar(256)

SI

periodCode

periodCode

Código de Período

int

NO

periodNumber

periodNumber

Número de Período

int

NO

sbPeriodNumber

sbPeriodNumber

Número de Subperíodo

int

NO

storeCode

storeCode

Código de Tienda

varchar(256)

SI

subPeriodCode

subPeriodCode

Código de Subperíodo

numeric(18,4)

NO

suspendedFlag

suspendedFlag

Bandera de Suspensión

bit

NO

terminalCode

terminalCode

Código de Terminal

varchar(256)

SI

trainingModeFlag

trainingModeFlag

Bandera de Modo de Entrenamiento

bit

NO

trxNumber

trxNumber

Número de Transacción

numeric(18,4)

NO

trxOrigin

trxOrigin

Origen de Transacción

varchar(256)

SI

trxStatus

trxStatus

Estado de Transacción

varchar(256)

SI

trxType

trxType

Tipo de Transacción

varchar(256)

SI

trxTypeCode

trxTypeCode

Código de Tipo de Transacción

numeric(18,4)

NO

updatedAt

updatedAt

Fecha de Actualización

datetime

SI

voidedFlag

voidedFlag

Bandera de Anulado

bit

NO


Tabla: newOrder


Tabla SQL: newOrder

Descripción:  Transacciones de validación de cierre

Tabla

ClavePrimaria

ClavesForaneas

newOrder

_id

–

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

externalNumber

externalNumber

Código de la orden del originante

varchar(256)

NO

internalNumber

internalNumber

Nro de pedido interno de BRIDGE

varchar(256)

NO

notes

notes

Comentarios sobre la orden

varchar(256)

SI

creationDate

creationDate

Fecha de creación

datetime

NO

channelCode

channelCode

Canal de Origen

varchar(256)

NO

terminalCode

terminalCode

Código de la terminal donde se crea el pedido

varchar(256)

NO

company

company

Código de la compañía

varchar(256)

NO

currencyCode

currencyCode

Moneda

varchar(256)

NO

netAmount

netAmount

Monto final del pedido, incluyendo el costo de entrega, menos los descuentos.

numeric(18,4)

NO

manualDiscountAmount

manualDiscountAmount

Importe de descuentos a la transacción

numeric(18,4)

SI

orderTypeCode

orderTypeCode

Codigo del tipo de orden

varchar(256)

NO

isPaid

isPaid

Indicador de cobrado

bit

NO

externalSellerID

externalSellerID

ID del vendedor externo (no es un usuario BRIDGE) 

varchar(256)

SI

externalSellerName

externalSellerName

Nombre del vendedor externo (no es un usuario de BRIDGE) 

varchar(256)

SI

perceptionAmount

perceptionAmount

Monto de percepciones del pedido 

numeric(18,4)

SI

storeCode

storeCode

Código de la tienda

varchar(256)

NO

storeName

storeName

Nombre de la tienda

varchar(256)

NO

party

party

Id del cliente

varchar(256)

NO

party.code

partyCode

Código del cliente

varchar(256)

NO

party.taxCategory

partyTaxCategory

Categoría impositiva del cliente ante el IVA

varchar(256)

NO

party.firstName

partyFirstName

Nombre del Cliente

varchar(256)

NO

party.lastName

partyLastName

Apellido del cliente

varchar(256)

SI

party.email

partyEmail

Correo del cliente

varchar(256)

SI

party.identificationType

partyIdentificationType

Tipo de documento

varchar(256)

NO

party.identifier

partyIdentifier

Número de documento

varchar(256)

NO

party.birthYearNumber

partyBirthYearNumber

Año de nacimiento

int

SI

party.birthMonthNumber

partyBirthMonthNumber

Mes de nacimiento

int

SI

party.birthDayNumber

partyBirthDayNumber

Día de nacimiento

int

SI

party.person

partyPerson

Si es del tipo persona

varchar(256)

SI

party.organization

partyOrganization

Si es del tipo empresa u organización

varchar(256)

NO

party.genderType

partyGenderType

Sexo del cliente

varchar(256)

SI

party.typeCode

partyTypeCode

Tipo de cliente

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: newOrderDetail


JSON NewOrder.detail  – SQL newOrderDetail

Tabla SQL: newOrderDetail

Descripción:  Detalle de las transacciones de pedidos de OMNI

Tabla

ClavePrimaria

ClavesForaneas

newOrderDetail

_id

newOrderId(newOrder)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

itemCode

itemCode

SKU del producto

varchar(256)

NO

description

description

Descripción del producto

varchar(256)

NO

orderedQty

orderedQty

Cantidad pedida

int

NO

unitPrice

unitPrice

Precio unitario

numeric(18,4)

NO

deliveryOrPickup

deliveryOrPickup

Si la linea será con retiro en tienda o envío

varchar(256)

NO

pickupLocationCode

pickupLocationCode

Código de la locación en donde retirará

varchar(256)

SI

pickupInformation

pickupInformation

Descripción de quien hará el retiro

varchar(256)

SI

requiredDate

requiredDate

Fecha de envío requerida o de retiro en tienda

dateTime

SI

partyContactMethodName

partyContactMethodName

Dirección de envío del cliente

varchar(256)

SI

barcode

barcode

Código de barras del articulo (si fue ingresado con ese dato)

int

SI

magnitude

magnitude

Magnitud (peso, longitud, etc) del item si su  unidad de medida asociada tiene manejo de decimales

int

SI

units

units

Cantidad de unidades de la presentación (asociado al código de barras) 

varchar(256)

SI

storeCode

storeCode

Código de Tienda 

varchar(256)

NO

locationCode

locationCode

Código del depósito

varchar(256)

SI

netAmount

netAmount

Monto neto 

numeric(18,4)

NO

itemSerialNumber

itemSerialNumber

Serie del item

varchar(256)

SI

newOrderId

newOrderId

ID de la newOrder

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: newOrderDetailPriceModifiers

JSON NewOrder.detail.priceModifiers  – SQL newOrderDetailPriceModifiers

Tabla SQL: newOrderDetailPriceModifiers

Descripción:  Detalle de precios de las transacciones de pedidos de OMNI

Tabla

ClavePrimaria

ClavesForaneas

newOrderDetailPriceModifiers

_id

newOrderDetailId(newOrderDetail)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

percent

percent

Porcentaje de descuento

int

NO

amount

amount

Monto de descuento

numeric(18,4)

NO

reasonText

reasonText

Razón del descuento

varchar(256)

SI

newOrderDetailId

newOrderDetailId

Identificador newOrderDetail

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: newOrderPayments


JSON NewOrder.payments   – SQL newOrderPayments

Tabla SQL: newOrderPayments

Descripción:  Detalle de los pagos de las transacciones de pedidos de OMNI

Tabla

ClavePrimaria

ClavesForaneas

newOrderPayments

_id

newOrderId(newOrder)

 

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

tender

tender

Código del medio de pago

varchar(256)

NO

amount

amount

Monto del pago

numeric(18,4)

NO

planDescriptor

planDescriptor

Descripción del plan de pagos elegido

varchar(256)

SI

sellerName

sellerName

Nombre de la entidad

varchar(256)

SI

authorizationCode

authorizationCode

Codigo de autorización de la tarjeta

varchar(256)

SI

couponNumber

couponNumber

Número de cupón

varchar(256)

SI

lotNumber

lotNumber

Número de Lote

varchar(256)

SI

installments

installments

Cuotas

varchar(256)

SI

referenceNumber

referenceNumber

Referencia de la tarjeta

int

SI

newOrderId

newOrderId

Id de la NewOrder

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: newOrderTransactions

JSON NewOrder.transactions   – SQL newOrderTransactions

Tabla SQL: newOrderTransactions

Descripción:  Detalle de la factura asociado a pedidos de OMNI

Tabla

ClavePrimaria

ClavesForaneas

newOrderTransactions

_id

newOrderId(newOrder)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

varchar(256)

NO

storeCode

storeCode

El código de tienda BRIDGE

varchar(256)

NO

terminalCode

terminalCode

El código de terminal BRIDGE

varchar(256)

NO

operatorCode

operatorCode

El código de operador BRIDGE

varchar(256)

SI

trxNumber

trxNumber

El número de transacción BRIDGE

int

NO

trxDate

trxDate

La fecha de la transacción BRIDGE

dateTime

NO

newOrderId

newOrderId

Id de la NewOrder

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: tillConciliation


JSON tillConciliation   – SQL tillConciliation  

Entidad Bridge: 

Tabla SQL: tillConciliation

Descripción:  Tabla de conciliaciones

Tabla

ClavePrimaria

ClavesForaneas

tillConciliation

_id

–

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

uniqueidentifier

NO

beginDateTime

beginDateTime

Fecha y hora en que inicia la transacción

datetime

SI

businessDayDate

businessDayDate

Fecha contable

datetime

SI

contigencyFlag

contigencyFlag

no utilizado en la conciliación

bit

SI

endDateTime

endDateTime

Fecha y hora en que finaliza la transacción

datetime

SI

excessesMissing

excessesMissing

Indica los montos de sobrante / faltante

decimal(18,5)

SI

negativeTenderTotalAmount

negativeTenderTotalAmount

Indica el monto de las devoluciones

decimal(18,5)

SI

offlineFlag

offlineFlag

no utilizado en la conciliación

bit

SI

originalTransaction

originalTransaction

NO SE UTILIZA

varchar(MAX)

SI

othersExpenditure

othersExpenditure

Indica el monto de las devoluciones de cobranzas

decimal(18,5)

SI

othersIncome

othersIncome

Indica el monto de las cobranzas

decimal(18,5)

SI

periodCode

periodCode

Código del periodo de la conciliación

int

SI

periodConciliationFlag

periodConciliationFlag

Identifica sí el período / turno está conciliado

bit

SI

periodNumber

periodNumber

Número de período de la conciliación

int

SI

positiveTenderTotalAmount

positiveTenderTotalAmount

Indica el monto de las ventas

decimal(18,5)

SI

presented

presented

monto de los arqueos

decimal(18,5)

SI

sbPeriodNumber

sbPeriodNumber

Número de subperíodo o turno de la conciliación

int

SI

storeCode

storeCode

código de la tienda

varchar(32)

SI

subPeriodCode

subPeriodCode

Código del subperiodo de la conciliación

int

SI

subTypeCode

subTypeCode

Indica el subtipo de transacción

varchar(64)

SI

suspendedFlag

suspendedFlag

no utilizado en la conciliación

bit

SI

tenderDepositoryTotalAmount

tenderDepositoryTotalAmount

No utilizado

decimal(18,5)

SI

tenderLoanTotalAmount

tenderLoanTotalAmount

indica el monto de las dotaciones

decimal(18,5)

SI

tenderPickupAmount

tenderPickupAmount

#N/D

decimal(18,5)

SI

tenderPickupTotalAmount

tenderPickupTotalAmount

Indica el monto de los retiros 

decimal(18,5)

SI

tenderWithdrawalAmount

tenderWithdrawalAmount

#N/D

decimal(18,5)

SI

tenderWithdrawalTotalAmount

tenderWithdrawalTotalAmount

Indica el monto de las rendiciones

decimal(18,5)

SI

terminalCode

terminalCode

código de la terminal

varchar(32)

SI

trainingModeFlag

trainingModeFlag

no utilizado en la conciliación

bit

SI

trxExecutedQty

trxExecutedQty

#N/D

int

SI

trxNumber

trxNumber

número de la transacción

int

SI

trxOrigin

trxOrigin

Origen de la transacción

varchar(32)

SI

trxStatus

trxStatus

Estatus de la transacción

varchar(32)

SI

trxType

trxType

Tipo de transacción, en este caso es TillConciliation

varchar(32)

SI

trxTypeCode

trxTypeCode

Código del tipo de transacción

int

SI

typeCode

typeCode

Indica el tipo de transacción: TillConciliation (conciliación)

varchar(64)

SI

typeId

typeId

ID del tipo de transacción (uso interno)

int

SI

updatedAt

updatedAt

Fecha en que fue actualizado la transacción

datetime

SI

userName

userName

Nombre de usuario que realiza la transacción

varchar(64)

SI

voidedFlag

voidedFlag

no utilizado en la conciliación

bit

SI

othersIncome

othersIncome

Indica el monto de las cobranzas

int

SI

othersExpenditure

othersExpenditure

Indica el monto de las devoluciones de cobranzas

int

SI

presented

presented

monto de los arqueos

int

SI

excessesMissing

excessesMissing

Indica los montos de sobrante / faltante

int

SI

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: tillConciliationTenderAdditionalData


JSON tillConciliation.tenderAdditionalData   – SQL tillConciliationTenderAdditionalData 

Tabla SQL: tillConciliationTenderAdditionalData 

Descripción:  Tabla de informarcion adicional de conciliaciones

Tabla

ClavePrimaria

ClavesForaneas

tillConciliationTenderAdditionalData 

_id

tillConciliationId(tillConciliation)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

uniqueidentifier

NO

tenderCode

tenderCode

Codigo medio de pago

varchar(256)

NO

tenderName

tenderName

Nombre medio de pago

varchar(256)

NO

tillConciliationId

tillConciliationId

id de la tillConciliationId

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: tillConciliationSubperiods


JSON tillConciliation.subperiods   – SQL tillConciliationSubperiods

Tabla SQL: tillConciliationSubperiods

Descripción:  Tabla de informarcion de periodos de las conciliaciones

Tabla

ClavePrimaria

ClavesForaneas

tillConciliationSubperiods

_id

tillConciliationId(tillConciliation)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

uniqueidentifier

NO

sbPeriodNumber

sbPeriodNumber

Número de subperíodo o turno de la conciliación

varchar(256)

NO

subPeriodCode

subPeriodCode

Código del subperiodo de la conciliación

varchar(256)

NO

tillConciliationId

tillConciliationId

id de la tillConciliationId

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: controlTransactionTillLineItems


JSON tillConciliation.controlTransaction.TillConciliation.controlTransactionTillLineItems – SQL controlTransactionTillLineItems

Tabla SQL: controlTransactionTillLineItems

Descripción:  Detalle de las conciliaciones

Tabla

ClavePrimaria

ClavesForaneas

controlTransactionTillLineItems

id

controlTransactionId (controlTransaction)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

conciliatedFlag

conciliatedFlag

Identifica si la cuenta esta conciliada

bit

SI

conciliationComments

conciliationComments

Comentarios adicionales de la conciliación

varchar(512)

SI

conciliationDate

conciliationDate

Indica la fecha y hora en que se concilió la cuenta

datetime

SI

conciliationOperator

conciliationOperator

operador que concilió la cuenta

varchar(64)

SI

conciliationReason

conciliationReason

Identifica el motivo de diferencia

varchar(64)

SI

controlTransactionId

controlTransactionId

#N/D

varchar(256)

NO

excessesMissing

excessesMissing

Indica los montos de sobrante / faltante

decimal(18,5)

SI

id

id

identitficador

int

NO

negativeTenderTotalAmount

negativeTenderTotalAmount

Indica el monto de las devoluciones

decimal(18,5)

SI

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

othersExpenditure

othersExpenditure

Indica el monto de las devoluciones de cobranzas

decimal(18,5)

SI

othersIncome

othersIncome

Indica el monto de las cobranzas

decimal(18,5)

SI

positiveTenderTotalAmount

positiveTenderTotalAmount

Indica el monto de las ventas

decimal(18,5)

SI

presented

presented

Indica el monto de los arqueos

decimal(18,5)

SI

sequence

sequence

Secuencia de la transacción

int

NO

tenderLoanTotalAmount

tenderLoanTotalAmount

indica el monto de las dotaciones

decimal(18,5)

SI

tenderPickupAmount

tenderPickupAmount


decimal(18,5)

SI

tenderPickupTotalAmount

tenderPickupTotalAmount

Indica el monto de los retiros

decimal(18,5)

SI

tenderRepository

tenderRepository

Indica la cuenta primaria (operador / terminal / categoría de terminal) 

varchar(64)

SI

tenderRepositoryName

tenderRepositoryName

Nombre del repositorio

varchar(64)

SI

tenderWithdrawalAmount

tenderWithdrawalAmount

Monto del retiro

decimal(18,5)

SI

tenderWithdrawalTotalAmount

tenderWithdrawalTotalAmount

Indica el monto de las rendiciones

decimal(18,5)

SI


Tabla: controlTransactionTillTenderLineItems


JSON tillConciliation.controlTransaction.TillConciliation.controlTransactionTillLineItems.controlTransactionTillTenderLineItems –

SQL controlTransactionTillTenderLineItems

Tabla SQL: controlTransactionTillTenderLineItems

Descripción:  Agrupado por medio de pago de operador

Tabla

ClavePrimaria

ClavesForaneas

controlTransactionTillTenderLineItems

_id

controlTransactionId(controlTransaction)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

Identificador

uniqueidentifier

NO

controlTransactionId

controlTransactionId

#N/D

varchar(256)

NO

excessesMissing

excessesMissing

Indica los montos de sobrante / faltante

decimal(18,5)

SI

externalId

externalId

Numero externo

varchar(64)

SI

lineItemSequence

lineItemSequence

Numero de item

int

NO

negativeTenderTotalAmount

negativeTenderTotalAmount

Indica el monto de las devoluciones

decimal(18,5)

SI

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

othersExpenditure

othersExpenditure

Indica el monto de las devoluciones de cobranzas

decimal(18,5)

SI

othersIncome

othersIncome

Indica el monto de las cobranzas

decimal(18,5)

SI

positiveTenderTotalAmount

positiveTenderTotalAmount

Indica el monto de las ventas

decimal(18,5)

SI

presented

presented

Indica el monto de los arqueos

decimal(18,5)

SI

sequence

sequence

Secuencia de transacción

int

NO

tender

tender

Indica el medio de pago

varchar(64)

SI

tenderCode

tenderCode

código de medio de pago

varchar(32)

SI

tenderLoanTotalAmount

tenderLoanTotalAmount

indica el monto de las dotaciones

decimal(18,5)

SI

tenderPickupAmount

tenderPickupAmount

Importe de medio de pago

decimal(18,5)

SI

tenderPickupTotalAmount

tenderPickupTotalAmount

Indica el monto de los retiros

decimal(18,5)

SI

tenderWithdrawalAmount

tenderWithdrawalAmount

Monto de retiro

decimal(18,5)

SI

tenderWithdrawalTotalAmount

tenderWithdrawalTotalAmount

Indica el monto de las rendiciones

decimal(18,5)

SI


Tabla: controlTransactionTillLineItems


SON tillConciliation.controlTransaction.TillConciliation.controlTransactionTillLineItems.controlTransactionSecondaryTillLineItems –

SQL tillConciliationSecondaryTillLineItems

Tabla SQL: controlTransactionTillLineItems

Descripción:  Detalle de las conciliaciones de las cuentas secundarias

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

identificador

varchar(256)

NO

sequence

sequence

Secuencia de la transacción

int

NO

tenderRepository

tenderRepository

Identifica la cuenta base

varchar(256)

NO

amounts.tenderLoanTotalAmount.numberDecimal

tenderLoanTotalAmount

indica el monto de las dotaciones

decimal(18,5)

NO

amounts.tenderPickupTotalAmount.numberDecimal

tenderPickupTotalAmount

Indica el monto de los retiros

decimal(18,5)

NO

amounts.tenderWithdrawalTotalAmount.numberDecimal

tenderWithdrawalTotalAmount

Indica el monto de las rendiciones

decimal(18,5)

NO

amounts.positiveTenderTotalAmount.numberDecimal

positiveTenderTotalAmount

Indica el monto de las ventas

decimal(18,5)

NO

amounts.negativeTenderTotalAmount.numberDecimal

negativeTenderTotalAmount

Indica el monto de las devoluciones

decimal(18,5)

NO

amounts.othersIncome.numberDecimal

othersIncome

Indica el monto de las cobranzas

decimal(18,5)

NO

amounts.othersExpenditure.numberDecimal

othersExpenditure

Indica el monto de las devoluciones de cobranzas

decimal(18,5)

NO

amounts.presented.numberDecimal

presented

Indica el monto de los arqueos

decimal(18,5)

NO

amounts.excessesMissing.numberDecimal

excessesMissing

Indica los montos de sobrante / faltante

decimal(18,5)

NO

tillConciliationTillLineItemsId

tillConciliationTillLineItemsId

ID tillConciliationTillLineItems

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO


Tabla: tillConciliationSecondaryTillTenderLineItems


JSON tillConciliation.controlTransaction.TillConciliation.controlTransactionTillLineItems.controlTransactionSecondaryTillLineItems.controlTransactionSecondaryTillTenderLineItems– SQL tillConciliationSecondaryTillTenderLineItems

Tabla SQL: tillConciliationSecondaryTillTenderLineItems

Descripción:  Agrupado por medio de pago de operador

Tabla

ClavePrimaria

ClavesForaneas

tillConciliationSecondaryTillTenderLineItems

_id

tillConciliationSecondaryTillLineItemsId(controlTransactionTillTenderLineItems)

Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

_id

_id

identificador

varchar(256)

NO

sequence

sequence

Secuencia de transacción

int

NO

tender

tender

Indica el medio de pago

varchar(256)

NO

tenderCode

tenderCode

código de medio de pago

varchar(256)

NO

tenderLoanTotalAmount

tenderLoanTotalAmount

indica el monto de las dotaciones

decimal(18,5)

NO

tenderPickupTotalAmount

tenderPickupTotalAmount

Indica el monto de los retiros

decimal(18,5)

NO

tenderWithdrawalTotalAmount

tenderWithdrawalTotalAmount

Indica el monto de las rendiciones

decimal(18,5)

NO

positiveTenderTotalAmount

positiveTenderTotalAmount

Indica el monto de las ventas

decimal(18,5)

NO

negativeTenderTotalAmount

negativeTenderTotalAmount

Indica el monto de las devoluciones

decimal(18,5)

NO

othersIncome

othersIncome

Indica el monto de las cobranzas

decimal(18,5)

NO

othersExpenditure

othersExpenditure

Indica el monto de las devoluciones de cobranzas

decimal(18,5)

NO

presented

presented

Indica el monto de los arqueos

decimal(18,5)

NO

excessesMissing

excessesMissing

Indica los montos de sobrante / faltante

decimal(18,5)

NO

tillConciliationSecondaryTillLineItemsId

tillConciliationSecondaryTillLineItemsId

id de tillConciliationSecondaryTillLineItems

varchar(256)

NO

o_dttm_mti

o_dttm_mti

Fecha recuperacion Informacion Marti

datetime

SI

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

datetime

SI

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI

o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

Tablas de maestros 

  • Item
  • Channel
  • City
  • Country
  • State
  • Store
  • IdentificationType
  • User
  • Tender

Tabla: Item

Tabla SQL: item 

Descripción: Maestro de artículos 

Tabla

ClavePrimaria

ClavesForaneas

item

_id


Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

5ea5565c5604c8593c6083f8

internalCode

internalCode

Código del item o SKU

varchar(50)

NO

30001

description

description

Descripción del artículo

varchar(255)

NO

Reloj inteligente edición limitada

disabled

disabled

Indicador de habilitado o no (default: false)

bit

SI

0

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(256)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N


Tabla: Channel

Tabla SQL: channel

Descripción: Maestro de canales (de venta) 

Tabla

ClavePrimaria

ClavesForaneas

channel

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

5f36ecea202cb01e8bbc9d2b

code

code

Código del canal

  • bridge (canal por defecto para tienda física) 

varchar(50)

NO

online

name

name

Nombre del canal

varchar(255)

NO

Tienda Digital

disabled

disabled

Indicador de habilitado o no (default: false) 

bit

SI

0

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(256)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Tabla: City

Tabla SQL: city 

Descripción: Maestro de ciudades

Tabla

ClavePrimaria

ClavesForaneas

city

_id


Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

61dd8ac44123d1da485c01c6

code

code

Código de la ciudad 

int

NO

001AGU

name

name

Nombre de la ciudad

varchar(256)

NO

Aguascalientes

state

state

Id del estado (ver tabla SQL: State) 

varchar(256)

NO

61dd819c4123d1da48562040

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Tabla: Country 

Tabla SQL: country

Descripción: Maestro de países

Tabla

ClavePrimaria

ClavesForaneas

country

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

60a2cd97cef5bbf0aad4a629

code

code

Código del país

varchar(50)

NO

MEX

name

name

Nombre del país

varchar(255)

NO

México

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(256)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N


Tabla: State

Tabla SQL: state

Descripción: Maestro de estados o provincias

Tabla

ClavePrimaria

ClavesForaneas

state

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

61dd819c4123d1da48562040

code

code

Código del estado

varchar(50)

NO

AGU

name

name

Nombre del estado

varchar(255)

NO

Aguascalientes

country

country

Id del país (ver tabla SQL: coutry) 

varchar(256)

NO

60a2cd97cef5bbf0aad4a629

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N



Tabla: Store

Tabla SQL: store 

Descripción: Maestro de tiendas

Tabla

ClavePrimaria

ClavesForaneas

store

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

665a8a83c7dd7d1278d72ebc

code

code

Código de la tienda

int

NO

1

name

name

Nombre de la tienda

varchar(255)

NO

Tienda 1

address

address

Dirección de la tienda

varchar(500)

SI

Venezuela 4350

format

format

ID del formato (uso interno de BRIDGE)

varchar (24)

SI

67927568a583a714b4b96b0c

city

city

Id de la ciudad (ver tabla SQL: city) 

varchar(24)

SI

61dd8ac44123d1da485c056f

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N


Tabla: PartyIdentificationType 

Tabla SQL: partyIdentificationType

Descripción: Maestro de tipos de identificación 

Valores posibles (MX):

  • 8(INE)

  • 9(RFC)

  • 10(CURP)

  • 26 (RFC Genérico Nacional)

  • 27(RFC Genérico rico Extranjero)

Tabla

ClavePrimaria

ClavesForaneas

partyIdentificationType

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

61dd9ac34123d1da4867938a

code

code

Código del tipo de documento

int

SI

8

description

description

Descripción del tipo de documento

varchar(255)

NO

INE

disabled

disabled

Indicador si está hablitado o no

(por defecto: false)

bit

SI

0

version

version

versión. uso interno de BRIDGE

int

NO

0

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Tabla: User

Tabla SQL: user

Descripción: Maestro de usuarios 

Tabla

ClavePrimaria

ClavesForaneas

user

_id



Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

6668c975a583a72fcc92b575

userName

userName

Nombre del usuario 

varchar(100)

NO

Juliana Garcia

accountExpired

accountExpired

Indica si la cuenta se encuentra expirada (default: false)

bit

SI

0

name

name

Código del usuario 

varchar(100)

NO

jgarcia

lastUserLogin

state

Fecha y hora de ultimo login al sistema

Formato: YYYY-MM-DD HH:MM:SS

datetime

NO

2025-01-01 06:36:36.000

accountLocked

accountLocked

Indica si el usuario se encuentra  bloquedo (default: false)

bit

SI

0

enabled

enabled

Indica si se encuentra habilitado o no

bit

SI

1

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

Tabla: Tender

Tabla SQL: tender

Descripción: Maestro de medios de pago 

Valores posibles:

  • Peso (EFECTIVO)
  • Dllr (DOLARES)
  • Otros (Ejemplo: VI: Visa, AM: Amex)

Tabla

ClavePrimaria

ClavesForaneas

tender

_id


Campo JSON

Campo SQL

Descripcion

Tipo dato SQL

Nulo

Ejemplo

_id

_id

(PK) identificador

varchar(256)

NO

5ea5565d5604c8593c60841f

code

code

Código del medio de pago

varchar(50)

NO

Peso

descriptor

descriptor

Nombre del medio de pago

varchar(255)

NO

EFECTIVO

disabled

disabled

Indica si está habilitado o no 

bit

NO

0

description

description 

Descripción del medio de pago 

varchar(255)

NO

EFECTIVO

Datos personalizados de control

o_dttm_mti

o_dttm_mti

Fecha recuperación Información Marti

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_dttm_napse

o_dttm_napse

Fecha Insercion Napse

Formato: YYYY-MM-DD HH:MM:SS

datetime

SI

2025-05-08 13:07:44.977

o_ex_msg

o_ex_msg

Mensaje de Error de las Reglas de Negocio

varchar(255)

SI


o_flag

o_flag

Bandera de procesamiento   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

INSTALACIÓN DEL PLUGIN

  • Para que el plugin funcione, deben haberse dado los siguientes pasos: 
    • Creación de la base de datos Bridge2SQL en MongoDB.
    • Creación de la base de datos Bridge2SQL en SQL Server.
    • Haber corrido los scripts en la base de datos Bridge2SQL de SQL Server y los incrementales.
    • Haber instalado el plugin NodeJS.
    • Haber configurado bien el plugin, apuntando a central, base de datos mongo y SQL.
    • Haber habilitado la exportación a Rabbit desde BMC, en la sección "Colas de Exportación" de BMC, seleccionando como destino, "Rabbit"
  • Se debe crear una nueva base de datos con un nombre alusivo en un Servidor SQL Server, por ejemplo Bridge2SQLMarti
  • En MongoDB, en el servidor en donde ejecuta BMC o BAPIC, se debe crear una base de datos MongoDB con un nombre alusivo, por ejemplo Bridge2SQLMarti
  • Se deben correr el script principal y los incrementales en el siguiente orden: 
    • CreacionTablas.sql
    • IncrementalTablas.sql
  • La base deberá verse así: 

  • El próximo paso, es configurar el archivo de configuración: 
  • {
  "app": {
    "db": {
      "bridge2SQLMongo": "mongodb://user:[email protected]:27019/bridge2SQL?authSource=admin&authMechanism=SCRAM-SHA-256&directConnection=true",
      "bridgeMongo": "mongodb://user:[email protected]:27019/bridgeCentral?authSource=admin&authMechanism=SCRAM-SHA-256&directConnection=true",
      "bridge2SQLSQLServer": {
        "user": "sa",
        "password": "1",
        "database": "Bridge2SQL",
        "server": "1.1.1.1",
        "port": 1433
      }
    },
    "rabbit": {
      "url": "amqp://usr:[email protected]:5672",
      "active": true
    },
    "server": {
      "port": "8682",
      "logMode": "debug",
      "isSsl": false,
      "topTransactions": 1000
    }
  }
}

  • Los datos del archivo, son los siguientes: 

    • bridge2SQLMongo es la dirección del servidor de base de datos contra el cual operará el plugin, NO se trata de la base productiva de BRIDGE, si no, de una nueva base que será utilizada por el plugin.

    • bridgeMongo es la base de datos de Bridge Central (BMC).

    • rabbit: se debe configurar la IP de RabbitMQ de donde el plugin tomará los registros que se exportan.

    • bridge2SQLSQLServer: es la información del servidor de SQL Server en donde cree la base.

  • Luego, se instala el plugin como cualquier otro, es decir, si es en Linux, se configura en ecosystem o si es en Windows, como servicio.



  • Sem rótulos