• Venta de un ítem al 22% de iva (tasa básica)
• Pago en efectivo
• Sin descuentos

• Venta de un ítem al 10% de iva (tasa mínima) y un item al 0% (exento)
• Pago en efectivo
• Sin descuentos

• Venta de un ítem al 22% de iva (tasa básica), un ítem al 10% de iva (tasa mínima) y un ítem al 0% (exento)
• Pago en efectivo
• Sin descuentos

• Venta de un ítem al 22% de iva (tasa básica)
• Pago en efectivo
• Con descuentos al ítem por promoción

• Venta de un ítem al 22% de iva (tasa básica)
• Con descuento manual al artículo
• Pago en efectivo

• Venta con factura en moneda extranjera (dólar)
• Venta de un ítem al 22%
• Con descuento por promoción
• Pago en dólar

Monto bruto, con impuestos incluidos (IVA e impuestos internos), sin percepciones

NO se restan los descuentos que la transacción pudiera tener.

Ni los items anulados

En las siguientes transacciones, se informa en 0: Return, ReturnShipmentDocument, VoidShipmentDocument, ReturnPaymentOnAccount

Importe de impuestos  (IVA, impuestos internos y percepciones)

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

En las siguientes transacciones, se informa en 0: Return, ReturnShipmentDocument, VoidShipmentDocument, ReturnPaymentOnAccount

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

• Si la configuración es sin impuestos

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

Monto de la devolución, para el caso de los cambios

En las siguientes transacciones, se informa en 0: Sale, BillShipmentDocument, PaymentOnAccount

Monto negativo de la venta (descuentos)

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

Monto de la devolución (productos)

Tipo de comprobante, las opciones son FC A, FC B, NC A, NC B/ Remito: RM A, RM B / Anulación de remito: DEVRM A, DEVRM B / Recibo: RC A, RC B / Devolución de recibo: CR A, CR B

"partyAddressFirstLine":"Av. Casa 1234",

"partyAddressCity":"Florida",

"partyAddressCityCode":"BSAS_182",

"partyAddressState":"BUENOS AIRES",

"partyAddressStateCode":"BSAS",

"partyAddressCountry":"Argentina",

"partyAddressCountryCode":"ARG",

Datos de contacto del cliente

"partyAddressFirstLine": Dirección 

"partyAddressCity": Ciudad

"partyAddressCityCode": Código de la ciudad

"partyAddressState": Provincia o estado

"partyAddressStateCode": Código de la provincia o estado

"partyAddressCountry": País

"partyAddressCountryCode": Código del país

"partyEmail":"[email protected]",

"partyTelephone":"54-11-123456789",

Email

Teléfono

promoCouponLoyalty [ {

barcode

barcodeFormat

format

linesToPrint

promotionID

benefitID

type

} ]

Cupones del módulo de fidelidad

• código de barras o nro. del cupón
• formato del código de barras (ej: EAN13)
• formato (digital o impreso)
• líneas a imprimir en el cupón
• ID de la promoción
• ID del beneficio
• Tipo de cupón

manualDiscounts [ {

discount

customerDiscount

typeCode

discountEntryMethod

percent

type

promo

voiding

voidFlag

baseAmount

customerBaseAmount

reasonCode

benefitApplicationMethodResume

benefitApplicationMethodLineByLine

} ]

Descuentos manuales a la transacción

• monto del descuento
• monto de descuento al cliente
• tipo: sale o return
• método de ingreso: teclado (keyed)
• porcentaje
• tipo
• es por promo (ej: false)
• anula
• anulado
• monto base sobre el cual aplica el descuento
• monto base del cliente sobre el cual aplica el descuento
• código del motivo de descuento (ej: OS)
• método de aplicación resumen (false porque no es de Promo)
• método de aplicación línea a línea (false porque no es de Promo)

cfeSerie

cfeNroRef

cfeFechaRef

originalCfeTipoDocRef

originalCfeSerie

originalCfeNroRef

originalCfeFechaRef

"foreignCurrencyInfo": {
"promoDiscountAmount": 20,
"manualDiscountAmount": 0,
"grossAmount": 109.09,
"taxAmount": 12.46,
"grossPositiveAmount": 89.09,
"grossNegativeAmount": 20,
"ivaTaxAmount": 12.46,
"internalTaxAmount": 0,
"perceptionAmount": 0,
"transactionDiscountAmount": 0,
"netSalesAmount": 69.09
},

lista

campos tipo number

Lista de los campos en moneda original de facturación (aplica si fue facturado en moneda extranjera)

foreignCurrencyInfo: Información en moneda extranjera de la transacción

• monto de descuento por promoción en moneda extranjera
• monto de descuento manual en moneda extranjera
• monto bruto en moneda extranjera
• monto de impuesto en moneda extranjera
• monto de bruto positivo en moneda extranjera
• monto de bruto negativo en moneda extranjera
• monto de iva en moneda extranjera
• monto de impuesto interno en moneda extranjera
• monto de percepciones en moneda extranjera
• monto de descuento a la transacción en moneda extranjera
• monto de venta neta en moneda extranjera

Datos de envío a domicilio o retiro en otra tienda/punto de retiro 

• Si es envío a domicilio se indica el método de contacto del cliente para el envío y su detalle

Ejemplo de retiro en tienda

 "shipment" : {
        "orderPickupLocation" : {
                     "id" : "60c10c1ae5e38617bc5f",
                     "code" : "TUni",
                     "name" : "Tienda Unicenter",
      }

deliveryDocumentsList [{

• type
• deliveryDocumentSerie
• deliveryDocumentPosNumber
• deliveryDocumentNumber
• deliveryDocumentDate
• amount
• billFlag
• cancelFlag
• selectedToPay
• period
• subPeriod
• businessDate
• originalStore
• originalWorkstationCode
• originalTransactionNumber

} ]

• Lista de remitos facturados. unicamente disponible en transacción del tipo BillShipmentDocument
  • uso interno
  • Serie del remito
  • Centro emisor del remito
  • Número de comprobante del remito
  • Fecha del remito
  • Monto del remito
  • Uso interno
  • Uso interno
  • Uso interno
  • Periodo del remito
  • Subperiodo del remito
  • Fecha contable del remito
  • Tienda del remito
  • Terminal del remito
  • Número de transacción del remito
   del cliente (sólo disponible cuando por configuración del evento sea requerido)
• Indica si el evento fue anulado

marginAsNumber

Identifica el margen de la transacción en importe

marginAsPercent

Identifica el margen de la transacción en porcentaje

fuelCreditProgramTransaction

Identifica si se trata de una venta flota

originalPeriodNumber

En caso de transacciones desfasadas, número del periodo original (si no es transacción desfasada, se envía en null)

originalSubPeriodNumber

En caso de transacciones desfasadas, número del subperiodo original (si no es transacción desfasada, se envía en null)

originalPeriodCode

En caso de transacciones desfasadas, código del periodo original (si no es transacción desfasada, se envía en null)

originalSubPeriodCode

En caso de transacciones desfasadas, código del subperiodo original (si no es transacción desfasada, se envía en null)

orderPackagesQty

orderOriginalExternalNumber

orderPartialBillVersion

Número de versión sobre pedido original en caso de ser un pedido derivado de la facturación parcial de Omni (a partir de 7.5.4 para facturación parcial de Omni. Debe encontrarse configurado para esta funcionalidad) Esto representa el nro de pedido parcial que se generó a partir del original con cada surtido parcial

itemType

Tipo de ítem. Los tipos posibles son:

paymentOnAccount

• "selectedToPay"
• "accountNumber"
• "accountDate"
• "installment" 
• "expirationDate" 
• "latePaymentDays" 
• "originalCapitalAmount" 
• "originalInterestAmount" 
• "originalTotalAmount" 
• "pendingCapitalAmount"
• "pendingInterestAmount"
• "pendingTotalAmount"
• "toPayLateInterestAmount"
• "calculatedLatePaymentIntAmount" 
• "toPayTotalAmount" 
• "paidCapitalAmount"
• "paidInterestAmount"
• "paidLatePaymentInterestAmount" 
• "paidTotalAmount"
• "installmentExpired"
• "partialPaymentAllowed"
• "foreignCurrencyQuoteFactor" 
• "deleteToLateInterest"
• "installmentEdited" 
• "identificationTypeId" 
• "identificationType"
• "identificationNumber" 
• "customerName"
• "trxNumber"
• "storeCode"
• "terminalCode"

            }, 

Detalle de las facturas de cuenta corriente que se están cobrando en una transacción de tipo "PaymentOnAccount"

• Uso interno
• Numero de Factura 
• Fecha de factura (formato: 2022-05-31)
• Uso interno
• Uso interno
• Uso interno
• Monto de la factura
• Uso interno todos los campos posteriores
• Número de transacción, tienda, terminal de la factura original

Cantidad vendida

Cuando el ítem tiene unidad de medida es fraccionable, entonces la cantidad por defecto es 1

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

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

unitOfMeasureCode

string

Código de unidad de medida del artículo

unitOfMeasureDecimals

number

Cantidad de decimales de la unidad de medida del artículo

unitOfMeasureDescription

string

Descripción de la unidad de medida. Ej: "Kilogramo", "Unidad"

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

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 dentro del array TaxDetail)

voiding = true indica que la cantidad se resta de la transacción. Es un lineItem de anulación (ver ejemplo en anexo)

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

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

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

ivaType {

id

code

description

percentage

disabled

}

ivaType: Tipo de iva

• id
• código del tipo de iva
• descripción del iva
• porcentaje
• deshabilitado

taxDetail [{

taxType

typeCode

taxAuthority

taxableAmount

taxIncludedInTaxableAmountFlag

originalAmount

amount

taxablePercentage

unifiedFactor

magnitudeTax

foreignCurrencyInfo {
taxableAmount
amount

       "jurisdiction" : "BA", 

       "jurisdictionTaxType" : "IB",

       "stateJurisdiction" : "BSAS",
}

}]

taxDetail: Detalle de impuestos (aplica a iva, percepciones de ingresos brutos IIBB o IVA o impuestos internos, lista)

• taxType: tipo de impuesto (ej: VAT, IIBB o TAX)
  • VAT: corresponde a IVA
  • TAX: corresponde a impuestos internos
  • 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)
    
• typeCode: Sale o return
• taxAuthority: código del impuesto interno o del iva o de la regla impositiva
• description: descripción del impuesto interno o del iva o de la regla impositiva
• taxableAmount: monto neto gravado
• taxIncludedInTaxableAmountFlag: si false NO corresponde a un impuesto de artículo (ejemplo percepción IIBB o IVA)
• originalAmount: sólo para percepciones. Corresponde al monto del impuesto calculado por la regla impositiva
• amount: monto del impuesto (en el caso de las percepciones puede ser igual al originalAmount o diferir si el cliente tiene una alícuota de percepción propia)
• taxablePercentage; porcentaje del impuesto
• unifiedFactor: sólo para percepciones. Corresponde al coeficiente unificado
• magnitudeTax

• foreignCurrencyInfo: información en moneda extranjera del detalle de impuestos del item (aplica si fue facturado en moneda extranjera)
  • taxableAmount: monto neto gravado en moneda extranjera
  • amount: monto del iva en moneda extranjera

En el caso de Argentina, también puede venir el desglose de percepciones que aplique sobre el item (como taxType: IIBB)

• Se agrega en el caso de los impuestos del cliente (percepciones o municipales)
  • jurisdicción (código)
  • tipo de impuesto (tipo de impuesto)
  • provincia o ciudad de la jurisdicción (código de la jurisdicción)

"itemTicketStockInformationList": [{

"inventoryReservationCode": "R1387810541609070117ded4c435b0a36743",

"storeCode": "T1",

"locationCode": "DEP1",

"locationErpCode": "7391",

"revenueCenterCode": "RCD",

"itemInventoryStateCode": "OnSale",

"quantity": 1,

"serializedUnit": "000000000010000467",

"serialNumber": "000000000000000006",

"voidedFlag": false

                }

            ],

itemTicketStockInformationList: Detalle de movimiento de stock del ítem (aplica a los ítems del tipo stockItem)

• inventoryReservationCode: código de reserva (interno de Bridge)
• storeCode: código de la tienda del depósito del item
• locationCode: código del depósito donde sale el item
• locationErpCode: código del depósito para el ERP
• revenueCenterCode: centro de costo (default Bridge: RCD)
• itemInventoryStateCode: código del estado del depósito (default: OnSale)
• quantity: cantidad de unidades
• serializedUnit: código único para el ítem en la tabla de items seriados
• serialNumber: nro de serie del ítem
• voidedFlag: si fue o no anulado el movimiento (boleano)

"foreignCurrencyInfo": {
"netAmount": 56.63,
"unitPrice": 89.09,
"manualAmount": 0,
"extendedPrice": 69.09
},

• netAmount: monto neto del ítem en moneda extranjera
• unitPrice: precio neto del ítem en moneda extranjera
• manualDiscountAmount: monto de descuento manual en moneda extranjera
• extendedPrice: precio extendido del ítem en moneda extranjera

"warrantyProperties" : {
                "warrantedInsuranceAmount" : "3000",
                "warrantyPercentage" : 1,
                "warrantyPeriod" : "1",
                "warrantyBaseCost" : 100,
                "warrantyTransaction" : "24",
                "warrantyDescription" : "MAPFRE",
                "policyNumber" : "ZX009",
                "warrantyCode" : "WRTY2_CELU",
                "warrantyDate" : "26/07/2022",

                "operationTypeCode" : "WRT",

                "relatedLineItem" : 1

            },

Datos de las propiedades de una garantía extendida y el ítem al cual se relaciona de venderse asociado dentro de la misma operación de venta (v1.3)

"operationTypeCode" : "WRT", ------ indica el tipo de relación (garantía)

"relatedLineItem" : 1 -----------------indica el nro de secuencia de ítem al cual se encuentra relacionado (es decir, el item garantizado)

"attributes": [
                {
                    "_id": "63cadef2918597b6fd79bd2c",
                    "code": "COLOR",
                    "option": "ROJO"
                },
                {
                    "_id": "63cadef2918597b6fd79bd2d",
                    "code": "SIZE",
                    "option": "S"
                }
            ],

Lista de atributos de un articulo 

Se informa el código y el valor u opción del atributo

exportCalendarPeriod

Datos del calendario de período
"exportCalendarPeriod": {
        "_id": "646cb39999927dfb801e4835",
        "calendarLevelID": 1,
        "calendarID": 0,
        "store": "63a333ace418b69be4b96d56",
        "shiftID": 13,
        "calendarPeriodID": 13,
        "businessDay": "646cb39999927dfb801e4834",
        "startDateTime": "2023-05-23T09:37:45",
        "version": 0,
        "id": "646cb39999927dfb801e4835"
    },

exportCalendarSubPeriod

Datos del calendario de subperiodo
"exportCalendarSubPeriod": {
        "_id": "646cb39999927dfb801e4836",
        "calendarLevelID": 0,
        "calendarID": 0,
        "store": "63a333ace418b69be4b96d56",
        "shiftID": 14,
        "calendarPeriodID": 14,
        "businessDay": "646cb39999927dfb801e4834",
        "startDateTime": "2023-05-23T09:37:45",
        "version": 0,
        "id": "646cb39999927dfb801e4836"
    }

voidedBy

"voidedBy": [], (se agrega a partir de 7.5.5)

• Lista de secuencias que anulan a el item informado (pudiendo ser parcial) 

En los casos en los cuales un item dentro de la transacción sea anulado por otra secuencia del mismo item, se listarán en esta lista

tenderType {

• id
• descriptor
• disabled
• code
• codeName

}

• id del tender type
• Descripción del medio de pago
• Si está deshabilitado
• Código del medio de pago
• Código del medio de pago

Código de autorización (cuando el pago fue validado online) 

Modo de autorización (cuando el pago fue validado online) 

"foreignCurrencyInfo": {
"amount": 69.09,
"netAmount": 69.09,
"surcharge": 0,
"change": 0,
"foreignCurrencyQuote": 43.561
},

• amount: monto del pago en moneda extranjera
• netAmount: monto neto del pago en moneda extranjera
• surcharge: recargo en moneda extranjera
• change: cambio o vuelto en moneda extranjera
• foreignCurrencyQuote: cotización de la moneda extranjera

MEDIO DE PAGO TIPO CASH

additionalData {

• returnFlag
• controlTenderExternalAccount
• isExtraCash
  
  
• extraCashAmount
  
  
• extraCashItemSeqNumber
• customerDocument
• controlTenderExternalAccountTill
  }

• Sólo ExtraCash: Indica si el pago sale del cajón
• Cuenta externa
• Sólo ExtraCash: Indica si el payment corresonde a Extra Cash
• Sólo ExtraCash: En caso que corresponda a Extra Cash, indica el monto
• Sólo ExtraCash: se puede utilizar el campo sequenceNumber para asociar el item Extracash
• Identificador del cliente (no mandatorio)
• Uso interno
• Uso interno

MEDIO DE PAGO TIPO CARD

additionalData {

• ad_planPrinterDescriptor
• extraCashAmount
  
  
• extraCashItemSeqNumber
  
  
• sellerName
• controlTenderExternalAccount
• installments
• ticketCurrency

• authorization_code → ticket

• customerDocument
• inputType
• planId
• cardtype
• planSurcharge
• extraCashPayment
• authorization_type
• controlTenderExternalAccountTill
• paymentVerificationMethod
• currencyCode
• storeCode
  }

• Descripción del plan
• Sólo ExtraCash: En caso que corresponda a Extra Cash, indica el monto
• Sólo ExtraCash: se puede utilizar el campo sequenceNumber para asociar el item Extracash
• Nombre del vendedor
• Cuenta externa
• Cantidad de cuotas
• Moneda
  
  
  
• Número de voucher (máximo 4 dígitos)

• Identificador del cliente
• Modo de ingreso de la tarjeta (ejemplo "Keyed")
• Código del plan
• Tipo de tarjeta (Credit, Debit)
• Interés
• Uso interno
• Uso interno
• Uso interno
• Uso interno
• Uso interno
• Código de la tienda

MEDIO DE PAGO TIPO WALLET (billetera)

additionalData {

• walletPaymentId
  

• installments

• authorization_code {

• • • terminal
      
    • trxId
      
      
    • vtolServerId
      
    • datetime
      
    • ticket
      
    • state
    • authorizationCode
      
    • node
    • store
    • lotNumber
    • amount
    • responseAuth
      
    • originalTrxDate
      
    • trxType
      
    • accountNumber
      
    • currentSessionId
      
    • configurationVersion
      
    • walletPaymentId
      
    • amountRefunded
      
    • paymentStatus
      
    • paymentStatusDetail
      
    • cardType
      
    • responseMessage
      
    • walletPaymentOptionId
      
      
    • walletOriginalAmount
      
    • emv
      
    • pending
      
    • commited
      
    • rollbacked
      
    • uniqueTrxId }
      
      
• customerDocument
• planId
• planSurcharge
• authorization_type
• account
  }

• Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet.
• Cuotas
  
  
  
• Código de terminal de VTOL
• Número secuencial asignado por VTOL a nivel de tienda - terminal
• Uso interno
• Fecha y hora
• Número de cupón
• Uso interno
• Código de autorización
• Uso inteno
• Código de tienda de VTOL
• Número de lote
• Monto
• Uso interno
• Uso interno
• Uso interno
• Número de tarjeta
• Uso interno
• Uso interno
• Uso interno
• Uso interno
  
• Uso interno
• Uso interno
• Uso interno
• Uso interno
• Los primeros dígitos (antes del _) corresponden al ProviderPOSCode. Luego se incluye el código de plan autoasignado por Bridge. Ejemplo: "walletPaymentOptionId": "VI_1"
• Uso interno
• Uso interno
• Uso interno
• Uso interno
• Uso interno
• Uso interno
  

• Identificador del cliente
• Código del plan
• Interés
• Uso interno
• Uso interno

number

string

"foreignCurrencyInfo": {
"benefitValue": 20,
"previousPrice": 89.09
},

• benefitValue: monto del beneficio en moneda extranjera
• previousPrice: precio previo en moneda extranjera

deliveryDocumentsList [{

• type
• deliveryDocumentSerie
• deliveryDocumentPosNumber
• deliveryDocumentNumber
• deliveryDocumentDate
• amount
• billFlag
• cancelFlag
• selectedToPay
• period
• subPeriod
• businessDate
• originalStore
• originalWorkstationCode
• originalTransactionNumber

} ]

Lista de remitos facturados. unicamente disponible en transacción del tipo BillShipmentDocument

• uso interno
• Serie del remito
• Centro emisor del remito
• Número de comprobante del remito
• Fecha del remito
• Monto del remito
• Uso interno
• Uso interno
• Uso interno
• Periodo del remito
• Subperiodo del remito
• Fecha contable del remito
• Tienda del remito
• Terminal del remito
• Número de transacción del remito

Venta de una cerveza con su envase 

Venta_Cerveza_ConEnvase.json

Venta de una cerveza con su envase

y su devolución