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




© 2024 Napse. Todos los derechos reservados.

REVISIONES


FechaVersiónDescripciónAutor

 

1.1Se agrega detalle a los campos

Andrea Veronica Asato 


CONTENIDO


Introducción

Egresos - tenderOutflow

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

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

  • 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

JSON ejemplo

{
	"_id": "6098235319263b544cf413fa",
	"beginDateTime": "2021-05-09T15:00:05.247Z",
	"businessDayDate": "2021-05-09T00:00:00.000Z",
	"cancelFlag": false,
	"contigencyFlag": false,
	"endDateTime": "2021-05-09T15:00:44.006Z",
	"errorDetail": null,
	"offlineFlag": false,
	"originalTransaction": "<!--NO SE UTILIZA-->",
	"periodCode": 9,
	"periodNumber": 9,
	"safeId": "T110650",
	"sbPeriodNumber": 10,
	"storeCode": "T1",
	"subPeriodCode": 10,
	"suspendedFlag": false,
	"tenderControlTransaction": {
		"totals": 3050.8,
		"typeCode": "TenderOutflow",
		"subTypeCode": null,
		"typeId": 58,
		"TenderOutflow": {
			"safeId": "T110650",
			"storeSafeCode": "1",
			"externalDepositoryId": "T1BI0245",
			"externalDepositoryCode": "BI",
			"note": null,
			"bagNumber": null,
			"docNumber": null,
			"tenderControlTransactionTenderLineItems": [
				{
					"sequenceNumber": 2,
					"tenderTypeCode": "MCOF",
					"tenderId": "5edd448deb522b4fee01e8e0",
					"tenderDescription": "Mastercard",
					"amount": 1000,
					"count": 1,
					"foreignCurrencyAmount": 1000,
					"exchangeRate": null,
					"retailStoreId": "T1",
					"safeId": "T110650",
					"externalDepositoryId": "T1BI0245",
					"externalDepositoryCode": "BI",
					"comments": null
				},
				{
					"sequenceNumber": 1,
					"tenderTypeCode": "VIOF",
					"tenderId": "5edd448deb522b4fee01e8dd",
					"tenderDescription": "Visa",
					"amount": 2050.8,
					"count": 1,
					"foreignCurrencyAmount": 2050.8,
					"exchangeRate": null,
					"retailStoreId": "T1",
					"safeId": "T110650",
					"externalDepositoryId": "T1BI0245",
					"externalDepositoryCode": "BI",
					"comments": null
				}
			]
		}
	},
	"terminalCode": "0",
	"tillCode": "T110650",
	"tillType": "SF",
	"trainingModeFlag": false,
	"trxNumber": 18,
	"trxOrigin": "bm",
	"trxStatus": "ok",
	"trxType": "TenderOutflow",
	"trxTypeCode": 58,
	"updatedAt": "2021-05-09T18:01:30.200Z",
	"userName": "12742",
	"voidedFlag": false,
	"workstationCategoryId": null
}

Se trata de una transacción de egreso de 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, egreso de caja.
    3. TenderOutflow
      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 linea.
        5. foreignCurrencyAmount: el tipo de cambio de la moneda, en caso de ser extranjera.
        6. comments: información que ingresa el usuario para esa linea.
  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 egreso (tenderOutflow)

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 egreso

contigencyFlag

boolean

No utilizado en egreso

endDateTime

DateTime

Fecha de fin de la transacción

errorDetail

Object

Detalle del error

offlineFlag

boolean

No utilizado en egreso

originalTransaction


NO SE UTILIZA

periodCode

number

Código de periodo

periodNumber

number

Numero de periodo 

safeId

string

Código de caja safe

sbPeriodNumber

number

Número de sub período o turno 

storeCode

string

Código de la tienda

subPeriodCode

number

Código de sub período o truno

suspendedFlag

boolean

No utilizado en egreso

tenderControlTransaction {



    • totals

decimal

Importe total de la transacción.

    • typeCode

string

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

    • subTypeCode

string

Indica el subtipo de transacción

    • typeId

string

identificador del tipo de transacción

TenderOutflow {



    • 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

string

Datos adicionales: número de bolsa

    • docNumber 

{

string

Datos adicionales: Número del comprobante

tenderControlTransactionTenderLineItems {

lista

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 del repositorio 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 egreso

trxNumber

number

Número de la transacción

trxOrigin

string

Origen de la transacción: el egreso es siempre bm

trxStatus

string

Estatus de la transacción

trxType

string

Tipo de transacción

trxTypeCode

number

Código del 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 egreso

workstationCategoryId

string

Uso interno de bridge

  • Sem rótulos