...
Esto es realizado en colas RabbitMQ y lo que se postea, posee formato JSON.
- Los nombres de las colas se podrán configurar a partir de parámetros del sistema (desde Configuración/sistema/exportación/transacciones Rabbit)
Se adjuntan al post, diferentes ejemplos de transacciones en formato JSON a modo de referencia
# | Descripción | JSON ejemplo |
---|---|---|
1 |
|
...
2 |
| |
3 |
| |
4 |
| |
5 |
| |
6 |
| |
7 |
| |
8 |
|
Detalle de los campos
Campo | Tipo | Descripción |
---|---|---|
trxType | string | El tipo de transacción, pueden ser los valores 'Sale', 'Return' o 'Exchange' |
trxNumber | number | Numero de transacción de la terminal |
trxNumberOriginal | number | En caso de devoluciones, es requerido el numero original de la transacción |
trxTypeLang | string | Es el tipo de la transacción, en español, Venta, Devolución o Cambio |
companyCode | string | Código de compañía |
companyName | string | Nombre de la compañía |
storeCode | string | Código de la tienda |
storeName | string | Nombre de la tienda |
terminalCode | string | Código de la terminal |
periodNumber | number | Numero de período |
sbPeriodNumber | number | Número de turno |
businessDayDate | Date | Dia fiscal |
beginDateTime | Date | Fecha de inicio de la transacción |
endDateTime | Date | Fecha de fin de la transacción |
beginDateTimeAsInt | number | Fecha de inicio de la transacción, como entero |
beginDateTimeHour | number | Fecha de fin de la transacción, como entero |
operatorCode | string | Código de operador o cajero |
operatorName | string | Nombre del operador |
itemCount | number | Cantidad de items de la venta |
grossAmount | number | Monto bruto, con impuestos incluidos, sin descuentos |
taxAmount | number | Importe de impuestos |
promoDiscountAmount | number | Descuentos otorgados por promociones generales |
manualDiscountAmount | number | Descuentos otorgados por descuentos manuales |
trainingModeFlag | boolean | Si es modo entrenamiento |
suspendedFlag | boolean | Si es una transacción suspendida |
cancelFlag | boolean | Si es una transacción cancelada |
offlineFlag | boolean | Si es una transacción offline |
contingencyFlag | boolean | Si es una transacción cargada en contingencia |
netSalesAmount | number | Monto neto de la transacción |
returnAmount | number | Monto de la devolución, para el caso de los cambios |
grossPositiveAmount | number | Monto positivo de la venta (productos) |
grossNegativeAmount | number | Monto negativo de la venta (descuentos) |
ivaTaxAmount | number | Impuesto al valor agregado (VAT) |
internalTaxAmount | number | Impuestos internos (TAX) |
perceptionAmount | number | Importe de percepciones (impuesto a clientes de Argentina) |
transactionDiscountAmount | number | Importe general de descuentos de la transacción (descuentos por promociones + descuentos manuales) |
iva0Amount | number | Monto de la venta con impuestos al 0% (solo Argentina) |
iva21Amount | number | Monto de la venta con impuestos al 21% (solo Argentina) |
iva10Amount | number | Monto de la venta con impuestos al 10% (solo Argentina) |
iva27Amount | number | Monto de la venta con impuestos al 27% (solo Argentina) |
fiscalPosNumber | string | Número de centro emisor para emisión de factura electrónica |
billType | string | Tipo de comprobante, las opciones son FC A, FC B, NC A, NC B |
serieOfficialBill | string | A o B de acuerdo a si es un comprobante a responsable inscripto o no |
billNumber | string | Numero fe factura electrónica o comprobante fiscal |
fiscalCAENumber | string | Número de autorización de factura electrónica |
fiscalCAEDate | Date | Fecha de autorización de factura electrónica |
currentZNumber | number | Número de Z fiscal |
currencyDescription | string | Descripción de la moneda de la operación |
originalSerieOfficialBill | string | En caso de ser una nota de crédito, referencia a la factura original |
originalFiscalPOSNumber | string | En caso de ser una nota de crédito, referencia a la factura original |
originalBillNumber | string | En caso de ser una nota de crédito, referencia a la factura original |
hasCustomer | boolean | Si posee un cliente asociado o no |
denomination | string | El nombre del cliente, en caso de poseer uno asociado |
partyCode | string | El código del cliente, generalmente es su identificación |
partyTaxCategory | string | La categoría impositiva del cliente, puede ser CF (Consumidor Final) o RI (Responsable Inscripto) |
partyType | string | Si es persona PRS o Organización OGN |
partyFirstName | string | Primer nombre del cliente |
partyLastName | string | Apellido del cliente |
partyPerson | boolean | Si es una persona |
partyOrganization | boolean | Si es una organización |
partyIdentificationType | string | Tipo de identificación. 1 DNI 2 Pasaporte 3 CUIT 4 CUIL |
partyIdentificationNumber | string | Numero de identificación |
promoCouponLoyalty [ { barcode barcodeFormat format linesToPrint promotionID benefitID type } ] | lista | Cupones del módulo de fidelidad
|
manualDiscounts [ { discount customerDiscount typeCode discountEntryMethod percent type promo voiding voidFlag baseAmount customerBaseAmount reasonCode benefitApplicationMethodResume benefitApplicationMethodLineByLine } ] | lista | Descuentos manuales a la transacción
|
Items | ||
trxType | string | Se repite el mismo dato que la cabecera |
trxNumber | number | Se repite el mismo dato que la cabecera |
storeName | string | Se repite el mismo dato que la cabecera |
storeCode | string | Se repite el mismo dato que la cabecera |
terminalCode | string | Se repite el mismo dato que la cabecera |
periodNumber | number | Se repite el mismo dato que la cabecera |
sbPeriodNumber | number | Se repite el mismo dato que la cabecera |
beginDateTime | Date | Se repite el mismo dato que la cabecera |
beginDateTimeAsInt | number | Se repite el mismo dato que la cabecera |
beginDateTimeHour | number | Se repite el mismo dato que la cabecera |
operatorCode | string | Se repite el mismo dato que la cabecera |
operatorName | string | Se repite el mismo dato que la cabecera |
internalCode | string | Código del producto. Debe ser un SKU existente en Bridge. Consultar catálogo de maestros. |
description | string | Descripción del producto |
merchandiseHierarchyGroupCode | string | Código de grupo de la estructura jerárquica |
merchandiseHierarchyGroupName | string | Nombre del grupo de la estructura jerárquica |
unitPrice | number | Precio unitario del producto |
quantity | number | Cantidad del producto |
units | number | Cantidad del producto |
extendedPrice | number | Precio total del producto (precio unitario x cantidad) |
netAmount | number | Importe final o neto del producto |
voiding | boolean | Si es un producto anulado, es decir, no forma parte de la venta |
voidFlag | boolean | Si es un producto anulado, es decir, no forma parte de la venta |
trainingModeFlag | boolean | Se repite el mismo dato que la cabecera |
suspendedFlag | boolean | Se repite el mismo dato que la cabecera |
cancelFlag | boolean | Se repite el mismo dato que la cabecera |
locationCode | string | Código de almacén desde donde el producto sale |
sellerCode | string | Código del vendedor del ítem |
promoDiscountAmount | number | Descuento otorgado por promociones |
manualDiscountAmount | number | Descuentos manuales sobre el producto |
ivaType { id code description percentage disabled } | object | Tipo de iva
|
taxDetail [{ taxType typeCode taxAuthority taxableAmount taxIncludedInTaxableAmountFlag amount taxablePercentage magnitudeTax }] | lista | Detalle de impuestos (aplica a iva o impuestos internos, lista)
|
priceModifiers [ {
methodCode
reason
reasonText
type
action
amount
percent
previousPrice
promotionNumber
benefitNumber
promotionCode
benefitOrder
promotionID
tlogMessage
displayMessage
printerMessage
}]
Detalle de descuentos a nivel ítem (lista)
- methodCode: código del método de descuento (descuento, promoción, etc)
- reason: código del descuento
- reasonText: nombre de la promoción o motivo del descuento
- type: tipo
- action: SB si resta AD si suma (anulación de descuento)
- amount: monto del descuento
- percent: porcentaje del descuento
- previousPrice: precio anterior
- promotionNumber: nro de la promo
- benefitNumber: nro del beneficio
- promotionCode: código de promoción
- benefitOrder: orden dentro del beneficio
- promotionID: ID de promoción
- tlogMessage: mensaje del TLOG
- displayMessage: mensaje del display
- printerMessage: mensaje para la impresora
Payments [ ] (Medios de Pago) | ||
trxType | string | Se repite el mismo dato que la cabecera |
trxNumber | number | Se repite el mismo dato que la cabecera |
storeName | string | Se repite el mismo dato que la cabecera |
storeCode | string | Se repite el mismo dato que la cabecera |
terminalCode | string | Se repite el mismo dato que la cabecera |
periodNumber | number | Se repite el mismo dato que la cabecera |
sbPeriodNumber | number | Se repite el mismo dato que la cabecera |
beginDateTime:Date, | Date | Se repite el mismo dato que la cabecera |
beginDateTimeAsInt | number | Se repite el mismo dato que la cabecera |
beginDateTimeHour | number | Se repite el mismo dato que la cabecera |
operatorCode | string | Se repite el mismo dato que la cabecera |
operatorName | string | Se repite el mismo dato que la cabecera |
tenderName | string | Nombre del medio de pago |
amount | number | Monto del medio de pago |
change | number | Cambio (en caso de ser efectivo) |
surcharge | number | Recargo (para casos como tarjetas) |
voided | boolean | Si fue anulado |
voiding | boolean | Si fue anulado |
netAmount | number | Monto neto del pago |
trainingModeFlag | boolean | Se repite el mismo dato que la cabecera |
suspendedFlag | boolean | Se repite el mismo dato que la cabecera |
cancelFlag | boolean | Se repite el mismo dato que la cabecera |
fiscalPosNumber | string | Numero de centro emisor |
billType | string | Tipo de comprobante, las opciones son FC A, FC B, NC A, NC B |
serieOfficialBill | string | A o B de acuerdo a si es un comprobante a responsable inscripto o no |
billNumber | string | Numero fe factura electrónica |
foreignCurrencyQuote | number | |
foreignAmount | number | Monto en moneda extranjera |
foreignChange | number | Cambio de la moneda extranjera |
currencyISOCode | string | Código de la moneda |
card | boolean | Código de tarjeta |
externalId | string | |
vtolStore | string | Código de tienda de VTOL |
vtolTerminal | string | Código de terminal de VTOL |
cardNumber | string | Número de tarjeta enmascarado |
cardType | string | Tipo de tarjeta |
lotNumber | string | Número de lote |
referenceNumber | string | Número de referencia |
provider | string | Autorizador |
planDescriptor | string | Plan de pagos |
sellerName | string | Código de comercio |
cardAuthorizationCode | string | Código de autorización de la tarjeta |
cardCouponNumber | string | Número de cupón de la tarjeta |
cardLotNumber | string | Número de lote de la tarjeta |
installments | string | Cantidad de cuotas |
cardReferenceNumber | string | Codigo de referencia de la tarjeta |
Discounts [ ] (Descuentos y promociones al item) | ||
trxType | string | Se repite el mismo dato que la cabecera |
trxNumber | number | Se repite el mismo dato que la cabecera |
storeName | string | Se repite el mismo dato que la cabecera |
storeCode | string | Se repite el mismo dato que la cabecera |
terminalCode | string | Se repite el mismo dato que la cabecera |
periodNumber | number | Se repite el mismo dato que la cabecera |
sbPeriodNumber | number | Se repite el mismo dato que la cabecera |
beginDateTime | Date | Se repite el mismo dato que la cabecera |
beginDateTimeAsInt | number | Se repite el mismo dato que la cabecera |
beginDateTimeHour | number | Se repite el mismo dato que la cabecera |
operatorCode | string | Se repite el mismo dato que la cabecera |
operatorName | string | Se repite el mismo dato que la cabecera |
internalCode | string |
Código interno del producto sobre el que aplica el descuento manual o por promoción | ||
description | string | Descripción del producto |
promoCode | string | Código interno de la promoción – solo si es por promoción (no para descuento manual) |
promoDescription | string | Descripción de la promoción – solo si es por promoción (no para descuento manual) |
benefitClass | string | Clase de beneficio ( |
monetary: monetario) | ||
benefitValue | number | Valor del beneficio, por ejemplo, el porcentaje de descuento |
benefitPercent | number | Porcentaje del descuento |
previousPrice | number | Precio previo al descuento |
cancelFlag | boolean | Se repite el mismo dato que la cabecera |
message | string | Mensaje definido en la promoción – solo si es por promoción (no para descuento manual) |
reason | string | Código |
del motivo del descuento | ||
type | string | tipo de descuento o beneficio |
action | string | si suma o resta (SB= resta, AD=suma) |
promotionNumber | string | nro de promoción – solo si es por promoción (no para descuento manual) |
benefitNumber | string | nro de beneficio – solo si es por promoción (no para descuento manual) |