transactionRetail

transactionObjectId

–

_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)

No aplica para México.

varchar(256)

SI

N/A

businessDayDate

businessDayDate

Día contable o de negocio.

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

Esta fecha indica el inicio del período de la tienda (es decir luego de un cierre de período se debe abrir la tienda, con la apertura de la misma se inicia un nuevo día de negocio) 

datetime

NO

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) 

No aplica para México.

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, reemplazado por billNumber)

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, IEPS) 

• 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 o adelanto de efectivo 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: ítems vendidos

b) devolución: ítems 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, IEPS (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, reemplazado por el campo fiscalCAENumber)

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 imponible o gravado 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, IEPS)

numeric(18,4)

NO

0.0000

monetaryPromotionDisabled 

monetaryPromotionDisabled 

bit

SI

0

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.

Dependiendo de la configuración utilizada para determinar precios con o sin impuestos, su cálculo puede ser:

• Con impuestos:
  • Monto neto de descuentos de la transacción con IVA: grossAmount + perceptionAmount - discounts
• Sin impuestos:
  • Monto neto de descuentos de la transacción sin IVA: grossAmount + perceptionAmount - discounts

Aclaración: cuando la trxType = Return, se informará en 0.

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

4110

originalTerminalCode

originalTerminalCode

Código original de terminal (nativa de BRIDGE)

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 (nativa de BRIDGE)

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

525521388697

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)

No incluye descuentos manuales ni descuentos por listas promocionales.

numeric(18,4)

NO

0.0000

promoListDiscount

promoListDiscount

Monto de descuentos acumulados solo por descuentos de listas de precios promocionales

numeric(18,4)

SI

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 asignado a la venta.

Aplica cuando el vendedor se agregó a nivel de toda la transacción.

Si la asignación de vendedor es por artículo, el vendedor por item estará en la tabla transactionRetailItem campo sellerID.

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

ver tabla SQL: "User"

varchar(256)

SI

carlosp

sellerName

sellerName

Nombre del vendedor

Aplica cuando el vendedor se agregó a nivel de toda la transacción.

Si la asignación de vendedor es por artículo, el vendedor por item estará en la tabla transactionRetailItem campo sellerName.

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

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. 

MX:  NO SE UTILIZA EN MEXICO

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, IEPS 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

(campo DEPRECADO, reemplazado por invoiceRequired)

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)

Incluye únicamente los descuentos que son a nivel transacción.

No incluye descuentos por listas promocionales, ya que estos son a nivel ítem.

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, reemplazado por cancelFlag)

bit

NO

0

xmlTimbrado

xmlTimbrado

XML Timbrado 

(campo DEPRECADO)

text

SI

N/A

isExternalReference

isExternalReference

Sólo para Devoluciones (trxType= Return)

Indica si la devolución corresponde a una venta generada en otro sistema diferente a BRIDGE. (Ejemplo: para las devoluciones de compras de ecommerce facturados en otro sistema)

Por defecto= false

bit

SI

0

originalExternalReferenceForRefund

originalExternalReferenceForRefund

Si el campo isExternalReference = true, se informará el número de comprobante de venta generado en el otro sistema diferente a BRIDGE 

varchar(64)

SI

2315

trxNumberSuccessive 

trxNumberSuccessive 

Número consecutivo de comprobante por su tipo (variará según el trxType de la transacción) 

int 

SI

1253

channel

channel

Código del canal de venta (aplica cuando es la venta de un pedido facturado en BRIDGE)

-----------

ver tabla SQL: channel

varchar(256)

SI

vtex

order

order

Número interno de pedido (asignado por BRIDGE al momento de su creación)

varchar(256)

SI

bridge0000000164

externalOrder

externalOrder

Número externo del pedido (el que asigna el canal que pudiera ser por ejemplo el ecommerce)

varchar(256)

SI

vtex02128

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

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)

NO

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)

NO

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)

NO

NORM

locationCode

locationCode

Código de depósito

varchar(256)

SI

DEP1

manualDiscountAmount

manualDiscountAmount

Monto acumulado de descuento manual a nivel item (incluye los descuentos por listas de precios promocionales) 

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

promoListDiscount

promoListDiscount

Monto de descuentos acumulados solo por descuentos de listas de precios promocionales

numeric(18,4)

SI

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 de 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  o adelanto de efectivo (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 (impuestos internos, IEPS 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)

NO

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)

NO

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)

NO

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 que toma una cantidad de artículo dentro de la transacción.

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 ítem

numeric(18,4)

NO

89.5200

version

version

Versión

(Uso interno de BRIDGE) 

numeric(18,4)

NO

0

voidedQuantity

voidedQuantity

Informa la cantidad anulada del ítem.

numeric(18,4)

NO

0.0000

voidFlag

voidFlag

Indica si es una Anulación de un ítem 

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 ítem

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

bit

NO

0

ContactMethodType

shipmentContactMethodType

Nombre del método de contacto del cliente seleccionado como dirección de entrega 

varchar(256)

SI

Personal

FirstLine

shipmentFirstLine

Domicilio de envío a domicilio

varchar(256)

SI

AVENIDA LAZARO CARDENAS 312

City

shipmentCity

Nombre de la ciudad de envío

varchar(256)

SI

Xalapa

CityCode

shipmentCityCode

Código de la ciudad de envío 

varchar(64)

SI

087VER

State

shipmentState

Nombre de estado o provincia de envío

varchar(256)

SI

Veracruz

StateCode

shipmentStateCode

Código del estado o provincia del envío

varchar(64)

SI

VER

Country

shipmentCountry

Nombre del país del envío 

varchar(256)

SI

Mexico

CodeCountry

shipmentCodeCountry

Código del país del envío

varchar(64)

SI

MEX

EmailAddress

shipmentEmailAddress

Correo electrónico del cliente

varchar(256)

SI

[email protected]

CountryCode

shipmentCountryCode

Código de país del nro de teléfono del cliente para el envío

varchar(64)

SI

52

AreaCode

shipmentAreaCode

Código de área del nro de teléfono del cliente para el envío

varchar(16)

SI

55

TelephoneNumber

shipmentTelephoneNumber

Nro de teléfono del cliente para el envío

varchar(16)

SI

2324321

DeliveryEstimatedDate

shipmentDeliveryEstimatedDate

Fecha estimada de entrega

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

datetime

SI

2025-05-13 03:00:00.000

OrderPickupLocationCode

shipmentOrderPickupLocationCode

Sólo para RETIRO EN TIENDA: código de la tienda o punto de retiro 

varchar(64)

SI

4118

OrderPickupLocationName

shipmentOrderPickupLocationName

Sólo para RETIRO EN TIENDA: nombre de la tienda o punto de retiro 

varchar(256)

SI

MARTI BOLIVAR

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   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

amount

amount

Monto del impuesto 

numeric(18,2) 

NO

16.00

description

description

Nombre del impuesto interno o regla impositiva (para impuestos de cliente en ARG)

varchar(256)

SI

exemptFlag

exemptFlag

Indicador si se exime del impuesto  (para impuestos de cliente en ARG)

bit

SI

0

magnitudeTax

magnitudeTax

Uso interno de BRIDGE

numeric(18,2) 

SI

taxableAmount

taxableAmount

Monto neto gravado (sobre el cual se calcula el impuesto)

numeric(18,2) 

NO

100.00

taxablePercentage

taxablePercentage

Porcentaje del impuesto

numeric(18,2) 

NO

16.00

taxAuthority

taxAuthority

Código del impuesto interno o del iva o de la regla impositiva (para impuestos de cliente en ARG)

varchar(64)

NO

3

taxType

taxType

Tipo de impuesto (ej: VAT, IIBB o TAX)

• • VAT: corresponde a IVA
  • TAX: corresponde a impuestos internos o sutuarios, IEPS
  • IIBB: corresponde a percepciones de Ingresos Brutos (sólo Argentina)
  • PERIVA: corresponde a percepciones de IVA (sólo Argentina)
  • TASA: corresponde a tasas municipales (sólo Argentina)

varchar(64)

NO

VAT

typeCode

typeCode

Indica si es un impuesto dentro de una venta o anulación del item en devolución (sale) ó dentro de una devolución  o anulación del item en una venta (return) 

Valores posibles:

• Sale o return

varchar(64)

NO

Sale

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   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

action

action

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

Valores posibles:

• SB (resta) 
• AD (suma) 

varchar(256)

NO

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

Referencia de la 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)

NO

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

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   N=Nuevo, Y=Procesado, E=Error

varchar(3)

NO

N

amount

amount

Monto del pago realizado en la transacción.

numeric(18,4)

NO

649.0000

BankNameTransfer

BankNameTransfer

Nombre de la entidad financiera.

Aplica únicamente con el tipo de medio de pago "transferencia" cuando la misma requiere informar el banco en la venta.

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

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

billType

billType

Tipo de comprobante:

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

(Uso interno de BRIDGE)

No aplica para México.

varchar(256)

SI

N/A

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 (cuando es tarjeta bancaria y el pago fue validado online)

varchar(256)

SI

123456

referenceNumber

cardCouponNumber

Número de Referencia del pago , es el RRN de la autorización de la tarjeta

varchar(256)

SI

10005

cardCouponNumberOff

cardCouponNumberOff

Cupón de Tarjeta Alternativo (cuando es tarjeta bancaria y el pago fue ingresado en modo offline)

varchar(256)

SI

1234

cardNumber

cardNumber

Número de Tarjeta (si se valida con VTOL se guardará enmascarado)

varchar(256)

SI

450799******7787

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 recibido, no incluye vuelto ni descuentos.

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 del pago , es el RRN de la autorización de la tarjeta

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. 

No aplica para México.

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)

NO

Peso

tenderName

tenderName

Nombre del medio de Pago

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

ver tabla SQL: tender (campo descriptor) 

varchar(256)

NO

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

payments[n]. additionalData. authorization_code.trxReferenceNumber

trxReferenceNumber

Referencia única del pago generada por VTOL. Usado para devoluciones con referencia donde no se tiene la tarjeta (campo 166)

trxType

trxType

Tipo de Transacción

Valores posibles:

• Sale (Venta)

• Return (Devolucion)

• Exchange (Cambio con referencia a compra original)

• ManualExchante (Cambio)

varchar(256)

NO

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

payments[n]. additionalData. authorization_code.cardType

vtolCardType

Tipo de tarjeta. Es devuelto por VTOL e indica si la tarjeta es crédito, débito, sin clasificar, etc. de acuerdo con la configuración de prefijos en VTOL.

(VTOL: campo 161)

Valores posibles:

• Credito= Tarjeta tipo Crédito.
• Debito = Tarjeta tipo Débito.
• Sin Clasificar= Tipo de tarjeta no identificado por VTOL

varchar

SI

Credito

payments[n]. additionalData. authorization_code.trxId

vtolTrxId

Id de la transacción para control de pendientes generado por VTOL 

(VTOL: campo 24)

int

SI

10

payments[n]. additionalData. authorization_code.ticket

vtolTicket

Número de ticket del pago generado por VTOL (para ser utilizado en devoluciones) 

(VTOL: campo 32)

int

SI

1

vtolStore

vtolStore

Número de comercio o afiliación por la que se procesó el pago. Devuelto por 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

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:15:00.137

o_dttm_napse

o_dttm_napse

Fecha Inserción 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

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

varchar(3)

NO

N

_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 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

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 el cliente admite transacciones que se paguen con crédito.    

bit

SI

0

disabled

disabled

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

Por default toma el valor 0.

bit

NO

0

email

email

Dirección de correo electrónico del cliente

varchar(256)

SI

[email protected]

exemptFlag

exemptFlag

Indica si el cliente se encuentra exento del impuesto del IVA.   

bit

NO

0

firstName

firstName

Primer 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

varchar(256)

SI

Juan Jose Martinez

store

store

Código de la Tienda Bridge

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

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

varchar(256)

SI

4118

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

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

areaCode

areaCode

Código de área de la ciudad

varchar(256)

SI

55

betweenStreets

betweenStreets

varchar(256)

SI

Av. Vasco de Quiroga

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

Av. Vasco de Quiroga 3800

fourthLine

fourthLine

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

varchar(256)

SI

CDMX

name

name

Nombre asignado al método de contacto.

varchar(256)

SI

Martí Centro Santa Fe

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

Tienda

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

bagNumber

bagNumber

Número de Bolsa

Dato opcional adicional de la operación. 

varchar(256)

SI

beginDateTime

beginDateTime

Fecha y hora de inicio de la transacción 

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

datetime

SI

businessDayDate

businessDayDate

Día contable o de negocio.

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

Esta fecha indica el inicio del período de la tienda (es decir luego de un cierre de período se debe abrir la tienda, con la apertura de la misma se inicia un nuevo día de negocio) 

datetime

SI

cancelFlag

cancelFlag

Indica si la transacción fue cancelada (si es true, no contabiliza fondos) 

NO APLICA para operaciones de caja

bit

NO

contigencyFlag

contigencyFlag

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) 
NO APLICA para operaciones de caja

bit

NO

voucherNumber

docNumber

Número de Documento

Dato opcional adicional de la operación. 

varchar(256)

SI

endDateTime

endDateTime

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

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

datetime

SI

note

note

Nota

Texto adicional que se puede ingresar en la operación de caja en BMT

varchar(256)

SI

offlineFlag

offlineFlag

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

NO APLICA para operaciones de caja

bit

NO

originalTransaction

originalTransaction

Transacción Original

NO APLICA para operaciones de caja

varchar(256)

SI

periodCode

periodCode

Código de Período de tienda

int

NO

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

safeId

safeId

ID de Caja de tienda o SAFE (código de tenderRepository)

(Uso interno de BRIDGE) 

varchar(256)

SI

111225

sbPeriodNumber

sbPeriodNumber

Número de subperíodo o turno de la tienda (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

storeCode

storeCode

Código de Tienda

varchar(256)

SI

subPeriodCode

subPeriodCode

Código de Subperíodo o turno de la tienda

numeric(18,4)

NO

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) 

Por defecto: false

NO APLICA para operaciones de caja

bit

NO

terminalCode

terminalCode

Código de Terminal donde se generó la operación. 
En las operaciones de caja se utiliza la terminal 0 de BMT

varchar(256)

SI

tillCode

tillCode

Código de la cuenta contable. En estos casos es el código del SAFE

varchar(256)

SI

tillType

tillType

Tipo de Caja. 

Valores posibles para este tipo de operación:

• SF (Safe) 

varchar(256)

SI

totals

totals

Monto total de la operación (suma de todos los medios de pago de la operación) 

numeric(18,4)

SI

3000.0000

trainingModeFlag

trainingModeFlag

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

Por defecto: false

NO APLICA para operaciones de caja

bit

NO

trxNumber

trxNumber

Número de transacción asignado para  la operación por la terminal (las operaciones de caja siempre se realizan desde la terminal 0 de la tienda) 

numeric(18,4)

NO

trxOrigin

trxOrigin

Origen de Transacción

Valores posibles: bm

varchar(256)

SI

trxStatus

trxStatus

Estado de procesamiento de la transacción (cuando es procesada) 

Valores posibles:

• ok
• error 

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

Valores posibles: 

• 57: TenderInflow(Ingreso) 

• 58: TenderOutflow(Egreso)

• 21: TenderReceipt(Reposición de valores)

• 20: TenderDeposit(Entrega de valores)

• 60: TenderSafeTransfer(Transferencia de caja)

int

NO

updatedAt

updatedAt

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

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

(Uso interno de BRIDGE) 

datetime

SI

userName

userName

Nombre de Usuario que genera la operación

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

ver tabla SQL: user

varchar(256)

SI

voidedFlag

voidedFlag

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

NO APLICA para operaciones de caja

bit

NO

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:15:00.137

o_dttm_napse

o_dttm_napse

Fecha Inserción Napse