Plugin Bridge2SQL

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.

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:

Configuración Inicial: Configurar conexión a RabbitMQ y a SQL Server
Conexión a RabbitMQ: Configurar canales y declaración de colas a leer.
Consumo de Mensajes: Recibe un mensaje, lo procesa extrayendo la información relevante para insertar en SQL.
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.
Conexión a la Base de Datos SQL Server: Abrir una conexión con SQL de forma segura.
Inserción de Registros en la Base de Datos: Ejecutar los scripts de SQL
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.
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).

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
_id	_id	Identificador único	varchar(256)	NO
baseCurrencyCode	baseCurrencyCode	Código de moneda base	varchar(256)	SI
beginDateTime	beginDateTime	Fecha y hora de inicio	datetime	NO
beginDateTimeAsInt	beginDateTimeAsInt	Fecha y hora de inicio como entero	int	NO
beginDateTimeHour	beginDateTimeHour	Hora de inicio	int	NO
billNumber	billNumber	Número de factura	varchar(256)	SI
billTotalAmount	billTotalAmount	Monto total de factura	numeric(18,4)	NO
billType	billType	Tipo de factura	varchar(256)	SI
businessDayDate	businessDayDate	Fecha de día hábil	varchar(256)	SI
cancelFlag	cancelFlag	Indica si la transaccion fue cancelada	bit	NO
contingencyFlag	contingencyFlag	Indica si fue una transaccion de contingencia	bit	NO
createdAt	createdAt	Fecha de creación	datetime	NO
currencyDescription	currencyDescription	Descripción de la moneda	varchar(256)	SI
denomination	denomination	Denominación	varchar(256)	SI
diasCredito	diasCredito	Días de crédito	varchar(256)	SI
endDateTime	endDateTime	Fecha y hora de finalización	datetime	NO
fiscalCAENumber	fiscalCAENumber	Número de CAE fiscal (NO SE UTILIZA EN MEXICO)	varchar(256)	SI
fiscalMode	fiscalMode	Modo Fiscal (NO SE UTILIZA EN MEXICO)	varchar(256)	SI
fiscalPosNumber	fiscalPosNumber	Número de Punto de Venta Fiscal	varchar(256)	SI
folio	folio	Folio de la factura (Facturación MEX)	varchar(256)	SI
folioDelivery	folioDelivery	Folio de entrega	varchar(256)	SI
folioInternet	folioInternet	Folio de Internet	varchar(256)	SI
foreignCurrencyInvoice	foreignCurrencyInvoice	Factura en moneda extranjera	bit	NO
foreignCurrencySellingQuote	foreignCurrencySellingQuote	Cotización de venta en moneda extranjera	numeric(18,4)	NO
grossAmount	grossAmount	Monto bruto	numeric(18,4)	NO
grossNegativeAmount	grossNegativeAmount	Monto bruto negativo	numeric(18,4)	NO
grossPositiveAmount	grossPositiveAmount	Monto bruto positivo	numeric(18,4)	NO
hasCustomer	hasCustomer	Indica si la transaccion tiene un cliente	bit	NO
internalTaxAmount	internalTaxAmount	Monto de impuesto interno	numeric(18,4)	NO
invoiceCurrencyCode	invoiceCurrencyCode	Código de moneda de la factura	varchar(256)	SI
invoiceRequired	invoiceRequired	Factura requerida	bit	NO
invoiceUUID	invoiceUUID	UUID de la factura	varchar(256)	SI
itemCount	itemCount	Cantidad de ítems	numeric(18,4)	NO
iva0Amount	iva0Amount	Monto de IVA al 0%	numeric(18,4)	NO
iva105Amount	iva105Amount	Monto de IVA al 10.5% (NO SE UTILIZA EN MEXICO)	numeric(18,4)	NO
iva21Amount	iva21Amount	Monto de IVA al 21% (NO SE UTILIZA EN MEXICO)	numeric(18,4)	NO
iva27Amount	iva27Amount	Monto de IVA al 27% (NO SE UTILIZA EN MEXICO)	numeric(18,4)	NO
ivaTaxAmount	ivaTaxAmount	Acumulado total de IVA	numeric(18,4)	NO
manualDiscountAmount	manualDiscountAmount	Monto de descuento manual	numeric(18,4)	NO
nccProcessedFlag	nccProcessedFlag	Bandera de procesamiento de NCC	bit	NO
netSalesAmount	netSalesAmount	Monto neto de ventas	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
offlineFlag	offlineFlag	Indica si la transaccion fue realizada fuera de linea	bit	NO
operatorCode	operatorCode	Código de operador	varchar(256)	SI
operatorName	operatorName	Nombre del operador	varchar(256)	SI
originalBillNumber	originalBillNumber	Número original de factura	varchar(256)	SI
originalFiscalPOSNumber	originalFiscalPOSNumber	Número original de punto de venta fiscal	varchar(256)	SI
originalSerieOfficialBill	originalSerieOfficialBill	Serie original de factura	varchar(256)	SI
originalStoreCode	originalStoreCode	Código original de tienda	varchar(256)	SI
originalTerminalCode	originalTerminalCode	Código original de terminal	varchar(256)	SI
originalTrxNumber	originalTrxNumber	Número original de transacción	int	SI
party	party	Información de cliente	varchar(256)	SI
partyAddressCity	partyAddressCity	Ciudad de dirección de cliente	varchar(256)	SI
partyAddressCountry	partyAddressCountry	País de dirección de cliente	varchar(256)	SI
partyAddressFirstLine	partyAddressFirstLine	Primera línea de dirección de cliente	varchar(256)	SI
partyAddressPostalCode	partyAddressPostalCode	Código postal de dirección de cliente	varchar(256)	SI
partyAddressState	partyAddressState	Estado de dirección de cliente	varchar(256)	SI
partyCode	partyCode	Código de cliente	varchar(256)	SI
partyEmail	partyEmail	Correo electrónico de cliente	varchar(256)	SI
partyFirstName	partyFirstName	Nombre de cliente (primer nombre)	varchar(256)	SI
partyIdentificationNumber	partyIdentificationNumber	Número de identificación de cliente	varchar(256)	SI
partyIdentificationType	partyIdentificationType	Tipo de identificación de cliente Valores posibles: 8(INE) 9(RFC) 10(CURP) 26 (RFC Genérico Nacional) 27(RFC Genérico rico Extranjero)	varchar(256)	SI
partyLastName	partyLastName	Apellido de cliente	varchar(256)	SI
partyOrganization	partyOrganization	Organización de cliente	bit	SI
partyPerson	partyPerson	Persona de cliente	bit	SI
partyTaxCategory	partyTaxCategory	Categoría fiscal de cliente	varchar(256)	SI
partyTelephone	partyTelephone	Teléfono de cliente	varchar(256)	SI
partyType	partyType	Tipo de cliente	varchar(256)	SI
perceptionAmount	perceptionAmount	Monto de percepción	numeric(18,4)	NO
periodNumber	periodNumber	Número de período	int	NO
promoDiscountAmount	promoDiscountAmount	Monto de descuento promocional	numeric(18,4)	NO
returnAmount	returnAmount	Monto de devolución	numeric(18,4)	NO
sbPeriodNumber	sbPeriodNumber	Número de período (SB)	int	NO
sellerID	sellerID	ID del vendedor	varchar(256)	SI
sellerName	sellerName	Nombre del vendedor	varchar(256)	SI
seq_export	seq_export	Identificador secuencial de exportación (con IDENTITY(1,1))	bigint	NO
serieOfficialBill	serieOfficialBill	Serie de factura oficial	varchar(256)	SI
store	store	Tienda	varchar(256)	NO
storeCode	storeCode	Código de tienda	varchar(256)	NO
storeName	storeName	Nombre de la tienda	varchar(256)	NO
supervisorCreditTrx	supervisorCreditTrx		varchar(256)	SI
suspendedFlag	suspendedFlag	Indica si es una transaccion suspendida	bit	NO
taxAmount	taxAmount	Monto de impuestos	numeric(18,4)	NO
tenderRepository	tenderRepository	Repositorio de transacción	varchar(256)	NO
terminal	terminal	Terminal	varchar(256)	NO
terminalCode	terminalCode	Código de terminal	varchar(256)	NO
timbrado	timbrado	Indica si la transaccion fue timbrada	bit	SI
trainingModeFlag	trainingModeFlag	Indica si fue una transaccion de entrenamiento	bit	NO
transactionDiscountAmount	transactionDiscountAmount	Monto de descuento de transacción	numeric(18,4)	NO
transactionObjectId	transactionObjectId	ID de objeto de transacción	varchar(256)	NO
trxCornerShop	trxCornerShop	Bandera de Transacción CornerShop	bit	SI
trxNumber	trxNumber	Número de transacción	int	NO
trxRappi	trxRappi	Bandera de Transacción Rappi	bit	SI
trxType	trxType	Tipo de transacción. Valores posibles: Sale (Venta) Return (Devolucion) Exchange (Cambio)	varchar(256)	NO
trxTypeLang	trxTypeLang	Tipo de transacción (idioma)	varchar(256)	SI
updatedAt	updatedAt	Fecha de actualización	datetime	NO
version	version	Versión	int	NO
voidedFlag	voidedFlag	Bandera de anulación	bit	NO
xmlTimbrado	xmlTimbrado	XML Timbrado (Facturación MEX)	text	SI

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
_id	_id	Identificador	varchar(256)	NO
beginDateTime	beginDateTime	Fecha y Hora de Inicio	datetime	NO
beginDateTimeAsInt	beginDateTimeAsInt	Fecha y Hora de Inicio	int	NO
beginDateTimeHour	beginDateTimeHour	Hora de Inicio	int	NO
billTotalAmount	billTotalAmount	Total de Facturacion	numeric(18,4)	NO
cancelFlag	cancelFlag	Indica si el item fue cancelador	bit	NO
createdAt	createdAt	Fecha de Creación	datetime	SI
description	description	Descripción	varchar(256)	SI
extendedPrice	extendedPrice	Precio Extendido	numeric(18,4)	NO
giftCardBalance	giftCardBalance	Saldo de Tarjeta de Regalo	numeric(18,4)	NO
giftCardRechargeAmount	giftCardRechargeAmount	Monto Recargado de Tarjeta de Regalo	numeric(18,4)	NO
internalCode	internalCode	Código Interno	varchar(256)	SI
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
locationCode	locationCode	Código de Ubicación	varchar(256)	SI
manualDiscountAmount	manualDiscountAmount	Monto de Descuento Manual	numeric(18,4)	NO
merchandiseHierarchyGroupCode	merchandiseHierarchyGroupCode	Código del Grupo de Jerarquía de Mercancía	varchar(256)	SI
merchandiseHierarchyGroupName	merchandiseHierarchyGroupName	Nombre del Grupo de Jerarquía de Mercancía	varchar(256)	SI
netAmount	netAmount	Monto Neto	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
operatorCode	operatorCode	Código de Operador	varchar(256)	SI
operatorName	operatorName	Nombre del Operador	varchar(256)	SI
perceptionTotal	perceptionTotal	Total de Percepción	numeric(18,4)	NO
periodNumber	periodNumber	Número de Período	int	NO
promoDiscountAmount	promoDiscountAmount	Monto de Descuento Promocional	numeric(18,4)	NO
prorratedTxDiscount	prorratedTxDiscount	Descuento Prorrateado de Transacción	numeric(18,4)	NO
quantity	quantity	Cantidad	numeric(18,4)	NO
returned	returned	Bandera de Devolución	bit	NO
sbPeriodNumber	sbPeriodNumber	Número de Período (SB)	int	NO
sellerID	sellerID	ID del Vendedor	varchar(256)	SI
sellerName	sellerName	Nombre del Vendedor	varchar(256)	SI
sequenceNumber	sequenceNumber	Número de Secuencia	int	NO
store	store	Tienda	varchar(256)	SI
storeCode	storeCode	Código de Tienda	varchar(256)	SI
storeName	storeName	Nombre de la Tienda	varchar(256)	SI
suspendedFlag	suspendedFlag	Bandera de Suspensión	bit	NO
taxTotal	taxTotal	Total de Impuestos	numeric(18,4)	NO
terminal	terminal	Terminal	varchar(256)	SI
terminalCode	terminalCode	Código de Terminal	varchar(256)	SI
trainingModeFlag	trainingModeFlag	Bandera de Modo de Entrenamiento	bit	NO
transactionObjectId	transactionObjectId	ID de Objeto de Transacción	varchar(256)	NO
trxNumber	trxNumber	Número de Transacción	numeric(18,4)	NO
trxType	trxType	Tipo de Transacción Valores posibles: Sale (Venta) Return (Devolucion) Exchange (Cambio)	varchar(256)	SI
unitOfMeasureCode	unitOfMeasureCode	Código de Unidad de Medida	varchar(256)	SI
unitOfMeasureDecimals	unitOfMeasureDecimals	Decimales de Unidad de Medida	numeric(18,4)	NO
unitPrice	unitPrice	Precio Unitario	numeric(18,4)	NO
units	units	Unidades	numeric(18,4)	NO
updatedAt	updatedAt	Fecha de Actualización	datetime	SI
vatTotal	vatTotal	Total de IVA	numeric(18,4)	NO
version	version	Versión	numeric(18,4)	NO
voidedQuantity	voidedQuantity	Cantidad Anulada	numeric(18,4)	NO
voidFlag	voidFlag	Bandera de Anulación	bit	NO
voiding	voiding	Anulación	bit	NO

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
_id	_id	Identificador	varchar(256)	NO
action	action	Acción	varchar(256)	SI
beginDateTime	beginDateTime	Fecha y Hora de Inicio	datetime	NO
beginDateTimeAsInt	beginDateTimeAsInt	Fecha y Hora de Inicio como Entero	int	NO
beginDateTimeHour	beginDateTimeHour	Hora de Inicio	int	NO
benefitClass	benefitClass	Clase de Beneficio	varchar(256)	NO
benefitNumber	benefitNumber	Número de Beneficio	varchar(256)	SI
benefitPercent	benefitPercent	Porcentaje de Beneficio	numeric(18,4)	NO
benefitValue	benefitValue	Valor del Beneficio	numeric(18,4)	NO
cancelFlag	cancelFlag	Indica si el registro fue cancelado	bit	NO
createdAt	createdAt	Creado en	datetime	NO
description	description	Descripción	varchar(256)	NO
internalCode	internalCode	Código Interno	varchar(256)	NO
message	message	Mensaje	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
operatorCode	operatorCode	Código de Operador	varchar(256)	NO
operatorName	operatorName	Nombre del Operador	varchar(256)	NO
periodNumber	periodNumber	Número de Período	int	NO
promoDescription	promoDescription	Descripción de la Promoción	varchar(256)	SI
promotionNumber	promotionNumber	Número de Promoción	varchar(256)	SI
reason	reason	Razón	varchar(256)	SI
sbPeriodNumber	sbPeriodNumber	Número de Período (SB)	int	NO
sequenceNumber	sequenceNumber	Número de Secuencia	varchar(256)	NO
store	store	Tienda	varchar(256)	NO
storeCode	storeCode	Código de Tienda	varchar(256)	NO
storeName	storeName	Nombre de la Tienda	varchar(256)	NO
terminal	terminal	Terminal	varchar(256)	NO
terminalCode	terminalCode	Código de Terminal	varchar(256)	NO
transactionObjectId	transactionObjectId	ID de Objeto de Transacción	varchar(256)	NO
trxNumber	trxNumber	Número de Transacción	int	NO
trxType	trxType	Tipo de Transacción Valores posibles: Sale (Venta) Return (Devolucion) Exchange (Cambio)	varchar(256)	NO
type	type	Tipo de descuento Valores posibles: PER(por porcentaje) AMT(por monto)	varchar(256)	SI
updatedAt	updatedAt	Actualizado en	datetime	NO
version	version	Versión	numeric(18,4)	NO

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
_id	_id	Identificador	varchar(256)	NO
amount	amount	Monto	numeric(18,4)	NO
BankNameTransfer	BankNameTransfer	Nombre de la entidada financiera	varchar(256)	SI
beginDateTime	beginDateTime	Fecha y Hora de Inicio	datetime	NO
beginDateTimeAsInt	beginDateTimeAsInt	Fecha y Hora de Inicio como Entero	int	NO
beginDateTimeHour	beginDateTimeHour	Hora de Inicio	int	NO
billNumber	billNumber	Número de Factura	varchar(256)	SI
billType	billType	Tipo de Factura	varchar(256)	SI
cancelFlag	cancelFlag	Bandera de Cancelación	bit	NO
card	card	Tarjeta	bit	NO
cardAuthorizationCode	cardAuthorizationCode	Código de Autorización de Tarjeta	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	varchar(256)	SI
change	change	Cambio	numeric(18,4)	NO
createdAt	createdAt	Creado en	datetime	SI
currencyISOCode	currencyISOCode	Código de Moneda ISO	varchar(256)	SI
extraCashAmount	extraCashAmount	Monto Extra en Efectivo	numeric(18,4)	SI
extraCashCupon	extraCashCupon	Cupón de Monto Extra en Efectivo	varchar(256)	SI
fiscalPosNumber	fiscalPosNumber	Número de Punto de Venta Fiscal	varchar(256)	SI
foreignAmount	foreignAmount	Monto en Moneda Extranjera	numeric(18,4)	NO
foreignChange	foreignChange	Cambio en Moneda Extranjera	numeric(18,4)	NO
foreignCurrencyQuote	foreignCurrencyQuote	Cotización de Moneda Extranjera	numeric(18,4)	NO
installments	installments	Cuotas	varchar(256)	SI
lotNumber	lotNumber	Número de Lote	varchar(256)	SI
netAmount	netAmount	Monto Neto	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
operatorCode	operatorCode	Código de Operador	varchar(256)	SI
operatorName	operatorName	Nombre del Operador	varchar(256)	SI
periodNumber	periodNumber	Número de Período	int	NO
planDescriptor	planDescriptor	Descripción del Plan	varchar(256)	SI
provider	provider	Proveedor	varchar(256)	SI
referenceNumber	referenceNumber	Número de Referencia	varchar(256)	SI
sbPeriodNumber	sbPeriodNumber	Número de Período Secundario	int	NO
sellerName	sellerName	Nombre del Vendedor	varchar(256)	SI
serieOfficialBill	serieOfficialBill	Serie de Factura Oficial	varchar(256)	SI
store	store	Tienda	varchar(256)	SI
storeCode	storeCode	Código de Tienda	varchar(256)	SI
storeName	storeName	Nombre de la Tienda	varchar(256)	SI
surcharge	surcharge	Recargo	numeric(18,4)	NO
suspendedFlag	suspendedFlag	Bandera de Suspensión	bit	NO
tender	tender	Forma de Pago	varchar(256)	SI
tenderCode	tenderCode	Código de Forma de Pago	varchar(256)	SI
tenderName	tenderName	Nombre de Forma de Pago	varchar(256)	SI
tenderRepository	tenderRepository	Repositorio de Forma de Pago	varchar(256)	SI
terminal	terminal	Terminal	varchar(256)	SI
terminalCode	terminalCode	Código de Terminal	varchar(256)	SI
trainingModeFlag	trainingModeFlag	Bandera de Modo de Entrenamiento	bit	NO
transactionObjectId	transactionObjectId	ID de Objeto de Transacción	varchar(256)	SI
trxNumber	trxNumber	Número de Transacción	int	NO
trxType	trxType	Tipo de Transacción Valores posibles: Sale (Venta) Return (Devolucion) Exchange (Cambio)	varchar(256)	SI
updatedAt	updatedAt	Actualizado en	datetime	SI
version	version	Versión	numeric(18,4)	NO
voided	voided	Anulado	bit	NO
voiding	voiding	Anulación	bit	NO
vtolStore	vtolStore	Tienda de Vtol	varchar(256)	SI
vtolTerminal	vtolTerminal	Terminal de Vtol	varchar(256)	SI
walletPaymentId	walletPaymentId	Identificador de Pago con Billetera Digital	varchar(64)	SI

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
_class	_class	Clase	varchar(256)	SI
_id	_id	Identificador	varchar(256)	NO
apiProcessed	apiProcessed	Bandera Procesado por API	bit	NO
birthCountryCode	birthCountryCode	Código de País de Nacimiento	varchar(256)	SI
birthDayNumber	birthDayNumber	Día de Nacimiento	int	NO
birthMonthNumber	birthMonthNumber	Mes de Nacimiento	int	NO
birthYearNumber	birthYearNumber	Año de Nacimiento	int	NO
code	code	Código	varchar(256)	SI
createdAt	createdAt	Fecha de Creación	datetime	SI
creditBillAvailable	creditBillAvailable	Disponible en la Factura de Crédito	bit	NO
disabled	disabled	Bandera Deshabilitado	bit	NO
email	email	Correo Electrónico	varchar(256)	SI
exemptFlag	exemptFlag	Bandera de Exento	bit	NO
firstName	firstName	Primer Nombre	varchar(256)	SI
genderType	genderType	Tipo de Género	varchar(256)	SI
identificationType	identificationType	Tipo de Identificación Valores posibles: 8(INE) 9(RFC) 10(CURP) 26 (RFC Genérico Nacional) 27(RFC Genérico rico Extranjero)	varchar(256)	SI
identifier	identifier	Identificador	varchar(256)	SI
lastName	lastName	Apellido	varchar(256)	SI
middleNames	middleNames	Segundo nombre	varchar(64)	SI
name	name	Nombre	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
store	store	Tienda	varchar(256)	SI
typeCode	typeCode	Código de Tipo	varchar(256)	SI
updatedAt	updatedAt	Fecha de Actualización	datetime	SI
version	version	Versión	int	NO

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
_id	_id	Identificador	varchar(256)	NO
areaCode	areaCode	Código de Área	varchar(256)	SI
betweenStreets	betweenStreets	Entre Calles	varchar(256)	SI
city	city	Ciudad	varchar(256)	SI
code	code	Código	varchar(256)	SI
country	country	País	varchar(256)	SI
countryCode	countryCode	Código de País	varchar(256)	SI
disabled	disabled	Deshabilitado	bit	NO
effectiveDate	effectiveDate	Fecha Efectiva	varchar(256)	SI
emailAddress	emailAddress	Correo Electrónico de Cliente	varchar(256)	SI
expirationDate	expirationDate	Fecha de Expiración	varchar(256)	SI
extensionNumber	extensionNumber	Número de Extensión	varchar(256)	SI
firstLine	firstLine	Primera Línea	varchar(256)	SI
fourthLine	fourthLine	Cuarta Línea	varchar(256)	SI
name	name	Nombre de Cliente	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
party	party	ID de Cliente	varchar(256)	NO
partyCode	partyCode	Código de Cliente	varchar(256)	SI
postalCode	postalCode	Código Postal	varchar(256)	SI
principalForBilling	principalForBilling	Principal para Facturación	bit	NO
principalForDelivery	principalForDelivery	Principal para Entrega	bit	NO
secondLine	secondLine	Segunda Línea	varchar(256)	SI
state	state	Estado	varchar(256)	SI
telephoneNumber	telephoneNumber	Número de Teléfono	varchar(256)	SI
thirdLine	thirdLine	Tercera Línea	varchar(256)	SI
version	version	Versión	numeric(18,4)	NO

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

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.
- Haber configurado en el config del plugin, que colecciones va a exportar, es decir, esto se configura en BMC (habilitando la exportación a Rabbit) y luego en el plugin (indicando cuales son las colas Rabbit que escucha).
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
- 20240606-NAPSEPD-31693-AlterTenderReferenceNumber.sql
- 20240819-NAPSEPD-32712-AlterTransactionRetail.sql
- 20240821-NAPSEPD-32527-AlterTransactionRetailPayment.sql
- 20240924-NAPSEPD-34679-AlterTransactionRetail.sql
- 20241120-NAPSEPD-36262-AlterTransactionRetailPayment.sql
- 20250327-NAPSDPD-35846-AgregaCamposDeProcesamientoEnTablas.sql
- 20250410-NAPSDPD-35846-AcomodaCamposSiNoExisten.sql
La base deberá verse así:

El próximo paso, es configurar el archivo de configuración:

{
  "app": {
    "db": {
      "mongoUrl": "mongodb://admin:[email protected]:27017/pluginSQLmarti?replicaSet=bridge&authSource=admin"
    },
    "rabbit": {
      "url": "amqp://admin:[email protected]:5672",
      "active": true,
      "queues":["transactions.sql", "customers.sql"]
    },
    "server": {
      "port": "8682",
      "logMode": "debug",
      "isSsl": false
    },
    "bridge": {
      "url": "http://10.4.203.65:8081",
      "client": "bridge-api",
      "secret": "DA39A3EE5E6B4B0D3255BFEF95601890AFD80709",
      "topTransactions": 10
    },
    "sql": {
      "user": "napse_usr",
      "password": "Read+Card-Bell",
      "database": "DW_NAPSE",
      "server": "10.72.250.11",
      "port": 1433
    }
  }
}

Los datos del archivo, son los siguientes:
- mongoUrl 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.
- rabbit: se debe configurar la IP de RabbitMQ de donde el plugin tomará los registros que se exportan.
- rabbit.queues: se deben definir que colas se tomarán.
- bridge: son los datos de BRIDGE API.
- sql: 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.

Árvore de páginas

Plugin Bridge2SQL

PLUGIN BRIDGE2SQL

Documentación y Modelo de Datos SQL

INTRODUCCIÓN

DIAGRAMA DE ARQUITECTURA

DESCRIPCIÓN DE LOS COMPONENTES

Bridge Manager Central

Colas RabbitMQ

Plugin Bridge2Sql

Componentes:

SQL Server

FLUJO DE DATOS

Transactions

New Customer

Tender Transaction

Control Transaction

Safe Transaction

MAPEO DE LA INFORMACIÓN JSON - SQL

Tabla: transactionRetail

Tabla: transactionRetailItem

Tabla: transactionRetailDiscount

Tabla: transactionRetailPayment

Tabla: party

Tabla: partyContactMethod

Tabla: tenderTransaction

Tabla: tenderTransactionDetail

Tabla: safeTransaction

Tabla: safeTransactionDetail

Tabla: controlTransaction

Tabla: newOrder

Tabla: newOrderDetail

Tabla: newOrderDetailPriceModifiers

Tabla: newOrderPayments

Tabla: newOrderTransactions

Tabla: tillConciliation

Tabla: tillConciliationTenderAdditionalData

Tabla: tillConciliationSubperiods

Tabla: controlTransactionTillLineItems

Tabla: controlTransactionTillTenderLineItems

Tabla: controlTransactionTillLineItems

Tabla: tillConciliationSecondaryTillTenderLineItems

INSTALACIÓN DEL PLUGIN