Este servicio posee la descripción de la transacción que es generada ante cada operación de venta, cambio o devolución.
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
|
| cfeTipoDocRef | number | Tipo de comprobante codificado por DGI Uruguay |
cfeSerie | string | Serie del comprobante |
cfeNroRef | string | Numero de comprobante |
cfeFechaRef | date | Fecha de emisión |
originalCfeTipoDocRef | number | Sólo en devoluciones, tipo de comprobante codificado por DGI Uruguay de la venta original |
originalCfeSerie | string | Sólo en devoluciones, serie del comprobante de la venta original |
originalCfeNroRef | string | Sólo en devoluciones, número de comprobante de la venta original |
originalCfeFechaRef | date | Sólo en devoluciones, fecha de emisión de la venta original |
| 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)
|
| 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) |