BRIDGE API - Rabbit - Exportación de un ingreso en caja / safe



© 2024 Napse. Todos los derechos reservados.

REVISIONES
FechaVersiónDescripciónAutor

 

1.1Se agrega más detalle de los campos del JSON 

Andrea Veronica Asato 



CONTENIDO




Introducción

Ingresos - tenderInflow

Este servicio posee la descripción de la transacción que es generada desde BM Tienda -> Operaciones -> Operaciones de caja -> Ingresos 

Esto es realizado en colas RabbitMQ y lo que se postea, posee formato JSON.


Configuración

  • La habilitación del envío de este tipo de transacción se podrán configurar desde Configuración/colas de exportación

Monitor de exportaciones

  • La exportación se podrá consultar desde el menú Monitoreo/Monitor de exportaciones 

JSON ejemplo

{
	"_id": "60998c2c19263b544cf41465",
	"beginDateTime": "2021-05-10T16:40:08.055Z",
	"businessDayDate": "2021-05-10T00:00:00.000Z",
	"cancelFlag": false,
	"contigencyFlag": false,
	"endDateTime": "2021-05-10T16:40:28.565Z",
	"errorDetail": null,
	"offlineFlag": false,
	"originalTransaction": "<!--NO SE UTILIZA-->",
	"periodCode": 11,
	"periodNumber": 11,
	"safeId": "T110650",
	"sbPeriodNumber": 12,
	"storeCode": "T1",
	"subPeriodCode": 12,
	"suspendedFlag": false,
	"tenderControlTransaction": {
		"totals": 100,
		"typeCode": "TenderInflow",
		"subTypeCode": null,
		"typeId": 57,
		"TenderInflow": {
			"safeId": "T110650",
			"storeSafeCode": "1",
			"externalDepositoryId": "T1BI0245",
			"externalDepositoryCode": "BI",
			"note": null,
			"bagNumber": null,
			"docNumber": null,
			"tenderControlTransactionTenderLineItems": [
				{
					"sequenceNumber": 1,
					"tenderTypeCode": "Peso",
					"tenderId": "5ea5565d5604c8593c60841f",
					"tenderDescription": "EFECTIVO",
					"amount": 100,
					"count": 1,
					"foreignCurrencyAmount": 100,
					"exchangeRate": null,
					"retailStoreId": "T1",
					"safeId": "T110650",
					"externalDepositoryId": "T1BI0245",
					"externalDepositoryCode": "BI",
					"comments": "sobra do PDV1"
				}
			]
		}
	},
	"terminalCode": "0",
	"tillCode": "T110650",
	"tillType": "SF",
	"trainingModeFlag": false,
	"trxNumber": 24,
	"trxOrigin": "bm",
	"trxStatus": "ok",
	"trxType": "TenderInflow",
	"trxTypeCode": 57,
	"updatedAt": "2021-05-10T19:41:00.188Z",
	"userName": "12742",
	"voidedFlag": false,
	"workstationCategoryId": null
}

Se trata de una transacción de ingreso a caja o safe, la información relevante es la siguiente: 

  1. beginDateTIme: fecha de comienzo de la transacción.
  2. businessDayDate: día hábil de operación.
  3. endDateTime: fecha de fin de la transacción.
  4. periodNumber: número de período.
  5. sbPeriodNumber: número de sub período o turno.
  6. safeId: código de caja safe.
  7. storeCode: código de tienda.
  8. tenderControlTransaction
    1. totals: importe de la transacción.
    2. typeCode: tipo de transacción, en este caso, ingreso de caja.
    3. TenderInflow
      1. SafeId: código de safe o caja.
      2. TenderControlTransactionLineItems: es el detalle de los movimientos ingresados, pueden ser uno o mas.
        1. sequenceNumber: es un auto numérico.
        2. tenderTypeCode: es el código de medio de pago.
        3. tenderDescription: es la descripción del medio de pago.
        4. amount: el importe de esa línea.
        5. foreignCurrencyAmount: el tipo de cambio de la moneda, en caso de ser extranjera.
        6. comments: información que ingresa el usuario para esa línea.
  9. terminalCode: código de terminal, si es 0 se trata del BackOffice de tienda o BMT.
  10. tillCode: es el código de unidad contable till, recordemos que la contabilidad es por terminal o por operador, en este caso es el código del safe.

Detalle de los campos del JSON de una operación de caja de ingreso (tenderInflow)

Campo

Tipo

Descripción

id

string

Uso interno de bridge

beginDateTime

DateTime

Fecha de comienzo de la transacción

businessDayDate

DateTime

Fecha contable

cancelFlag

boolean

No utilizado en ingreso

contigencyFlag

boolean

No utilizado en ingreso

endDateTime

DateTime

Fecha de fin de la transacción

errorDetail

Object

Detalle del error

offlineFlag

boolean

No utilizado en ingreso

originalTransaction


<--No se utiliza-->

periodCode

number

Código de periodo

periodNumber

number

Numero de periodo

safeId

string

Uso interno de Bridge

sbPeriodNumber

number

Id de sub período o turno

storeCode

string

Código de la tienda

subPeriodCode

number

Código de sub período o turno

suspendedFlag

boolean

Uso interno de Bridge

tenderControlTransaction {



    • totals

decimal

Importe total de la transacción.

    • typeCode

string

Tipo de transacción, en este caso, ingreso de caja

    • subTypeCode

string

Subtipo de transacción

    • typeId

}

string

Es el identificador del tipo de transacción

TenderInflow {



    • safeId

string

Uso interno de bridge

    • storeSafeCode

string

Código de caja de tienda

    • externalDepositoryId

string

Uso interno de bridge

    • externalDepositoryCode

string

Indica el código del repositorio cuenta externa en operaciones de caja

    • note

string

Datos adicionales: comentarios

    • bagNumber

number

Datos adicionales: número de bolsa

    • docNumber

}

string

Datos adicionales: Número del comprobante

tenderControlTransactionTenderLineItems  {


Es el detalle de los movimientos ingresados, pueden ser uno o mas

    • sequenceNumber

number

Secuencia

    • tenderTypeCode

string

Es el código de medio de pago

    • tenderId

Decimal

Uso interno de bridge

    • tenderDescription

string

Es la descripción del medio de pago

    • amount

number

El importe o monto.

    • count

number

Por defecto 1

    • retailStoreId

string

Identificador de la tienda

    • safeId

string

Uso interno de bridge

    • externalDepositoryId

string

Uso interno de bridge

    • externalDepositoryCode

string

Indica el código de cuenta externa en operaciones de caja

    • comments

string

Información que ingresa el usuario para esa línea.

    • foreignCurrencyAmount

}

number

El tipo de cambio de la moneda, en caso de ser extranjera.

terminalCode

string

Código de terminal

tillCode

string

Uso interno de bridge

tillType

string

Uso interno de bridge

trainingModeFlag

boolean

No utilizado en Ingreso

trxNumber

number

Número de la transacción

trxOrigin

string

Origen de la transacción: par ingreso es bm

trxStatus

string

Estatus de la transacción

trxType

string

Tipo de transacción

trxTypeCode

number

código de tipo de transacción

updatedAt

dateTime

Fecha en que fue actualizado

userName

string

Nombre del usuario que realiza la transacción

voidedFlag

boolean

No utilizado en Ingreso

workstationCategoryId

string

Uso interno de bridge

  • Sem rótulos