Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

#Descripción

JSON ejemplo

1
  • Venta de un ítem al 22% de iva (tasa básica)
  • Pago en efectivo
  • Sin descuentos
2
  • Venta de un ítem al 10% de iva (tasa mínima) y un item al 0% (exento)
  • Pago en efectivo
  • Sin descuentos
3
  • 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
4
  • Venta de un ítem al 22% de iva (tasa básica)
  • Pago en efectivo
  • Con descuentos al ítem por promoción
5
  • Venta de un ítem al 22% de iva (tasa básica)
  • Pago en efectivo y tarjeta bancaria
  • Con descuentos al ítem por promoción
6
  • Venta de un ítem al 22% de iva (tasa básica)
  • Pago en efectivo
  • Con cupón emitido por aplicación de una promoción
7
  • Venta de un ítem al 22% de iva (tasa básica) y un ítem exento 0%
  • Pago en efectivo
  • Con descuento manual a la transacción
8
  • Venta de un ítem al 22% de iva (tasa básica)
  • Con descuento manual al artículo
  • Pago en efectivo
9
  • Venta con factura en moneda extranjera (dólar)
  • Venta de un ítem al 22%
  • Con descuento por promoción
  • Pago en dólar


Detalle de los campos

Items

Tipo de iva

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

Detalle de impuestos (aplica a iva o impuestos internos, lista)

  • taxType: tipo de impuesto (ej: VAT o TAX)
  • typeCode: Sale o return
  • taxAuthority: código del impuesto o iva
  • taxableAmount: monto neto gravado
  • taxIncludedInTaxableAmountFlag: si está incluido el impuesto o no
  • amount: monto del impuesto
  • taxablePercentage; porcentaje del impuesto
  • magnitudeTax
CampoTipoDescripción
trxTypestringEl tipo de transacción, pueden ser los valores 'Sale', 'Return' o 'Exchange'
trxNumbernumberNumero de transacción de la terminal
trxNumberOriginalnumberEn caso de devoluciones, es requerido el numero original de la transacción
trxTypeLangstringEs el tipo de la transacción, en español, Venta, Devolución o Cambio
companyCodestringCódigo de compañía
companyNamestringNombre de la compañía
storeCodestringCódigo de la tienda
storeNamestringNombre de la tienda
terminalCodestringCódigo de la terminal
periodNumbernumberNumero de período
sbPeriodNumbernumberNúmero de turno
businessDayDateDateDia fiscal
beginDateTimeDateFecha de inicio de la transacción
endDateTimeDateFecha de fin de la transacción
beginDateTimeAsIntnumberFecha de inicio de la transacción, como entero
beginDateTimeHournumberFecha de fin de la transacción, como entero
operatorCodestringCódigo de operador o cajero
operatorNamestringNombre del operador
itemCountnumberCantidad de items de la venta
grossAmountnumberMonto bruto, con impuestos incluidos, sin descuentos
taxAmountnumberImporte de impuestos
promoDiscountAmountnumberDescuentos otorgados por promociones generales
manualDiscountAmountnumberDescuentos otorgados por descuentos manuales
trainingModeFlagbooleanSi es modo entrenamiento
suspendedFlagbooleanSi es una transacción suspendida
cancelFlagbooleanSi es una transacción cancelada
offlineFlagbooleanSi es una transacción offline
contingencyFlagbooleanSi es una transacción cargada en contingencia
netSalesAmountnumberMonto neto de la transacción
returnAmountnumberMonto de la devolución, para el caso de los cambios
grossPositiveAmountnumberMonto positivo de la venta (productos)
grossNegativeAmountnumberMonto negativo de la venta (descuentos)
ivaTaxAmountnumberImpuesto al valor agregado (VAT)
internalTaxAmountnumberImpuestos internos (TAX)
perceptionAmountnumberImporte de percepciones (impuesto a clientes de Argentina)
transactionDiscountAmountnumberImporte general de descuentos de la transacción (descuentos por promociones + descuentos manuales)
iva0AmountnumberMonto de la venta con impuestos al 0% (solo Argentina)
iva21AmountnumberMonto de la venta con impuestos al 21%  (solo Argentina)
iva10AmountnumberMonto de la venta con impuestos al 10%  (solo Argentina)
iva27AmountnumberMonto de la venta con impuestos al 27%  (solo Argentina)
fiscalPosNumberstringNúmero de centro emisor para emisión de factura electrónica
billTypestringTipo de comprobante, las opciones son FC A, FC B, NC A, NC B
serieOfficialBillstringA o B de acuerdo a si es un comprobante a responsable inscripto o no
billNumberstringNumero fe factura electrónica o comprobante fiscal
fiscalCAENumberstringNúmero de autorización de factura electrónica
fiscalCAEDateDateFecha de autorización de factura electrónica
currentZNumbernumberNúmero de Z fiscal
currencyDescriptionstringDescripción de la moneda de la operación
originalSerieOfficialBillstringEn caso de ser una nota de crédito, referencia a la factura original
originalFiscalPOSNumberstringEn caso de ser una nota de crédito, referencia a la factura original
originalBillNumberstringEn caso de ser una nota de crédito, referencia a la factura original
hasCustomerbooleanSi posee un cliente asociado o no
denominationstringEl nombre del cliente, en caso de poseer uno asociado
partyCodestringEl código del cliente, generalmente es su identificación
partyTaxCategorystringLa categoría impositiva del cliente, puede ser CF (Consumidor Final) o RI (Responsable Inscripto)
partyTypestringSi es persona PRS o Organización OGN
partyFirstNamestringPrimer nombre del cliente
partyLastNamestringApellido del cliente
partyPersonbooleanSi es una persona
partyOrganizationbooleanSi es una organización
partyIdentificationTypestringTipo de identificación. 1 DNI 2 Pasaporte 3 CUIT 4 CUIL
partyIdentificationNumberstringNumero de identificación

promoCouponLoyalty [ {

barcode

barcodeFormat

format

linesToPrint

promotionID

benefitID

type

} ]

lista

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

} ]

lista

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)
cfeTipoDocRefnumberTipo de comprobante codificado por DGI Uruguay     

cfeSerie

stringSerie del comprobante (Uruguay)

cfeNroRef

stringNumero de comprobante (Uruguay)

cfeFechaRef

dateFecha de emisión (Uruguay)

originalCfeTipoDocRef

numberSólo en devoluciones, tipo de comprobante codificado por DGI Uruguay de la venta original    (Uruguay)

originalCfeSerie

stringSólo en devoluciones, serie del comprobante de la venta original    (Uruguay)

originalCfeNroRef

stringSólo en devoluciones, número de comprobante de la venta original    (Uruguay)

originalCfeFechaRef

dateSólo en devoluciones, fecha de emisión de la venta original    (Uruguay)
baseCurrencyCodetrxTypestringSe repite el mismo dato que la cabecera
trxNumbernumberSe repite el mismo dato que la cabecera
storeNamestringSe repite el mismo dato que la cabecera
storeCodestringSe repite el mismo dato que la cabecera
terminalCodestringSe repite el mismo dato que la cabecera
periodNumbernumberSe repite el mismo dato que la cabecera
sbPeriodNumbernumberSe repite el mismo dato que la cabecera
beginDateTimeDateSe repite el mismo dato que la cabecera
beginDateTimeAsIntnumberSe repite el mismo dato que la cabecera
beginDateTimeHournumberSe repite el mismo dato que la cabecera
operatorCodestringSe repite el mismo dato que la cabecera
operatorNamestringSe repite el mismo dato que la cabecera
internalCodestringCódigo del producto.  Debe ser un SKU existente en Bridge. Consultar catálogo de maestros.
descriptionstringDescripción del producto
merchandiseHierarchyGroupCodestringCódigo de grupo de la estructura jerárquica
merchandiseHierarchyGroupNamestringNombre del grupo de la estructura jerárquica
unitPricenumberPrecio unitario del producto
quantitynumberCantidad del producto
unitsnumberCantidad del producto
extendedPricenumberPrecio total del producto (precio unitario x cantidad)
netAmountnumberImporte final o neto del producto
voidingbooleanSi es un producto anulado, es decir, no forma parte de la venta
voidFlagbooleanSi es un producto anulado, es decir, no forma parte de la venta
trainingModeFlagbooleanSe repite el mismo dato que la cabecera
suspendedFlagbooleanSe repite el mismo dato que la cabecera
cancelFlagbooleanSe repite el mismo dato que la cabecera
locationCodestringCódigo de almacén desde donde el producto sale
sellerCodestringCódigo del vendedor del ítem
promoDiscountAmountnumberDescuento otorgado por promociones
manualDiscountAmountnumberDescuentos manuales sobre el producto

ivaType {

id

code

description

percentage

disabled

}

object

taxDetail [{

taxType

typeCode

taxAuthority

taxableAmount

taxIncludedInTaxableAmountFlag

amount

taxablePercentage

magnitudeTax

}]

lista

"itemTicketStockInformationList": [{

"inventoryReservationCode": "R1387810541609070117ded4c435b0a36743",

"storeCode": "T1",

"locationCode": "DEP1",

"locationErpCode": "7391",

"revenueCenterCode": "RCD",

"itemInventoryStateCode": "OnSale",

"quantity": 1,

"serializedUnit": "000000000010000467",

"serialNumber": "000000000000000006",

"voidedFlag": false

                }

            ],

lista

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 item en la tabla de items seriados
  • serialNumber: nro de serie del item
  • voidedFlag: si fue o no anulado el movimiento (boleano)Código ISO de la moneda base
    foreignCurrencySellingQuotenumberCotización de la moneda (aplica si fue facturado en moneda extranjera)
    invoiceCurrencyCodestringCódigo ISO de la moneda de facturación (aplica si fue facturado en moneda extranjera)

    "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
    Items
    trxTypestringSe repite el mismo dato que la cabecera
    trxNumbernumberSe repite el mismo dato que la cabecera
    storeNamestringSe repite el mismo dato que la cabecera
    storeCodestringSe repite el mismo dato que la cabecera
    terminalCodestringSe repite el mismo dato que la cabecera
    periodNumbernumberSe repite el mismo dato que la cabecera
    sbPeriodNumbernumberSe repite el mismo dato que la cabecera
    beginDateTimeDateSe repite el mismo dato que la cabecera
    beginDateTimeAsIntnumberSe repite el mismo dato que la cabecera
    beginDateTimeHournumberSe repite el mismo dato que la cabecera
    operatorCodestringSe repite el mismo dato que la cabecera
    operatorNamestringSe repite el mismo dato que la cabecera
    internalCodestringCódigo del producto.  Debe ser un SKU existente en Bridge. Consultar catálogo de maestros.
    descriptionstringDescripción del producto
    merchandiseHierarchyGroupCodestringCódigo de grupo de la estructura jerárquica
    merchandiseHierarchyGroupNamestringNombre del grupo de la estructura jerárquica
    unitPricenumberPrecio unitario del producto
    quantitynumberCantidad del producto
    unitsnumberCantidad del producto
    extendedPricenumberPrecio total del producto (precio unitario x cantidad)
    netAmountnumberImporte final o neto del producto
    voidingbooleanSi es un producto anulado, es decir, no forma parte de la venta
    voidFlagbooleanSi es un producto anulado, es decir, no forma parte de la venta
    trainingModeFlagbooleanSe repite el mismo dato que la cabecera
    suspendedFlagbooleanSe repite el mismo dato que la cabecera
    cancelFlagbooleanSe repite el mismo dato que la cabecera
    locationCodestringCódigo de almacén desde donde el producto sale
    sellerCodestringCódigo del vendedor del ítem
    promoDiscountAmountnumberDescuento otorgado por promociones
    manualDiscountAmountnumberDescuentos manuales sobre el producto

    ivaType {

    id

    code

    description

    percentage

    disabled

    }

    object

    ivaType: Tipo de iva

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




    taxDetail [{

    taxType

    typeCode

    taxAuthority

    taxableAmount

    taxIncludedInTaxableAmountFlag

    amount

    taxablePercentage

    magnitudeTax

    foreignCurrencyInfo {
    taxableAmount
    amount
    }

    }]

    lista

    taxDetail: Detalle de impuestos (aplica a iva o impuestos internos, lista)

    • taxType: tipo de impuesto (ej: VAT o TAX)
    • typeCode: Sale o return
    • taxAuthority: código del impuesto o iva
    • taxableAmount: monto neto gravado
    • taxIncludedInTaxableAmountFlag: si está incluido el impuesto o no
    • amount: monto del impuesto
    • taxablePercentage; porcentaje del impuesto
    • 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

    "itemTicketStockInformationList": [{

    "inventoryReservationCode": "R1387810541609070117ded4c435b0a36743",

    "storeCode": "T1",

    "locationCode": "DEP1",

    "locationErpCode": "7391",

    "revenueCenterCode": "RCD",

    "itemInventoryStateCode": "OnSale",

    "quantity": 1,

    "serializedUnit": "000000000010000467",

    "serialNumber": "000000000000000006",

    "voidedFlag": false

                    }

                ],

    lista

    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,
    "manualDiscountAmount": 0,
    "extendedPrice": 69.09
    },

    listaforeignCurrencyInfo: información en moneda extranjera del item (aplica si fue facturado en moneda extranjera)
    • 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
    Payments [ ] (Medios de Pago)
    trxTypestringSe repite el mismo dato que la cabecera
    trxNumbernumberSe repite el mismo dato que la cabecera
    storeNamestringSe repite el mismo dato que la cabecera
    storeCodestringSe repite el mismo dato que la cabecera
    terminalCodestringSe repite el mismo dato que la cabecera
    periodNumbernumberSe repite el mismo dato que la cabecera
    sbPeriodNumbernumberSe repite el mismo dato que la cabecera
    beginDateTime:Date,DateSe repite el mismo dato que la cabecera
    beginDateTimeAsIntnumberSe repite el mismo dato que la cabecera
    beginDateTimeHournumberSe repite el mismo dato que la cabecera
    operatorCodestringSe repite el mismo dato que la cabecera
    operatorNamestringSe repite el mismo dato que la cabecera
    tenderNamestringNombre del medio de pago
    amountnumberMonto del medio de pago
    changenumberCambio (en caso de ser efectivo)
    surchargenumberRecargo (para casos como tarjetas)
    voidedbooleanSi fue anulado
    voidingbooleanSi fue anulado
    netAmountnumberMonto neto del pago
    trainingModeFlagbooleanSe repite el mismo dato que la cabecera
    suspendedFlagbooleanSe repite el mismo dato que la cabecera
    cancelFlagbooleanSe repite el mismo dato que la cabecera
    fiscalPosNumberstringNumero de centro emisor
    billTypestringTipo de comprobante, las opciones son FC A, FC B, NC A, NC B
    serieOfficialBillstringA o B de acuerdo a si es un comprobante a responsable inscripto o no
    billNumberstringNumero fe factura electrónica
    foreignCurrencyQuotenumber 
    foreignAmountnumberMonto en moneda extranjera
    foreignChangenumberCambio de la moneda extranjera
    currencyISOCodestringCódigo de la moneda
    cardbooleanCódigo de tarjeta
    externalIdstring 
    vtolStorestringCódigo de tienda de VTOL
    vtolTerminalstringCódigo de terminal de VTOL
    cardNumberstringNúmero de tarjeta enmascarado
    cardTypestringTipo de tarjeta
    lotNumberstringNúmero de lote
    referenceNumberstringNúmero de referencia
    providerstringAutorizador
    planDescriptorstringPlan de pagossellerName
    sellerNamestringCódigo de comercio
    cardAuthorizationCodestringCódigo de autorización de la tarjeta
    cardCouponNumberstringNúmero de cupón de la tarjeta
    cardLotNumberstringNúmero de lote de la tarjeta
    installmentsstringCódigo Cantidad de comerciocuotas
    cardAuthorizationCodecardReferenceNumberstringCódigo de autorización referencia de la tarjeta
    cardCouponNumberstringNúmero de cupón de la tarjeta
    cardLotNumberstringNúmero de lote de la tarjeta
    installmentsstringCantidad de cuotas
    cardReferenceNumberstringCodigo de referencia de la tarjeta

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

    listaforeignCurrencyInfo: información en moneda extranjera del pago (aplica si es un pago en moneda extranjera)
    • 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
    Discounts [ ] (Descuentos y promociones al item)
    trxTypestringSe repite el mismo dato que la cabecera
    trxNumbernumberSe repite el mismo dato que la cabecera
    storeNamestringSe repite el mismo dato que la cabecera
    storeCodestringSe repite el mismo dato que la cabecera
    terminalCodestringSe repite el mismo dato que la cabecera
    periodNumbernumberSe repite el mismo dato que la cabecera
    sbPeriodNumbernumberSe repite el mismo dato que la cabecera
    beginDateTimeDateSe repite el mismo dato que la cabecera
    beginDateTimeAsIntnumberSe repite el mismo dato que la cabecera
    beginDateTimeHournumberSe repite el mismo dato que la cabecera
    operatorCodestringSe repite el mismo dato que la cabecera
    operatorNamestringSe repite el mismo dato que la cabecera
    internalCodestringCódigo interno del producto sobre el que aplica el descuento manual o por promoción
    descriptionstringDescripción del producto
    promoCodestringCódigo interno de la promoción – solo si es por promoción (no para descuento manual)
    promoDescriptionstringDescripción de la promoción – solo si es por promoción (no para descuento manual)
    benefitClassstringClase de beneficio (monetary: monetario)
    benefitValuenumberValor del beneficio, por ejemplo, el porcentaje de descuento
    benefitPercentnumberPorcentaje del descuento
    previousPricenumberPrecio previo al descuento
    cancelFlagbooleanSe repite el mismo dato que la cabecera
    messagestringMensaje definido en la promoción – solo si es por promoción (no para descuento manual)
    reasonstringCódigo del motivo del descuento
    typestringtipo de descuento o beneficio
    actionstringsi suma o resta (SB= resta, AD=suma)
    promotionNumberstringnro de promoción – solo si es por promoción (no para descuento manual)benefitNumberstringnro de beneficio – solo si es por promoción (no para descuento manual) para descuento manual)
    benefitNumberstringnro de beneficio – solo si es por promoción (no para descuento manual)

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

    listaforeignCurrencyInfo: información en moneda extranjera del descuento (aplica si fue una factura en moneda extranjera)
    • benefitValue: monto del beneficio en moneda extranjera
    • previousPrice: precio previo en moneda extranjera