BRIDGE API - Rabbit - Exportación de conciliación de un período



© 2024 Napse. Todos los derechos reservados.

REVISIONES
FechaVersiónDescripciónAutor

 

1.1Creación del documento

Andrea Veronica Asato 







CONTENIDO



Introducción 

Conciliaciones - tillConciliation

Este servicio posee la descripción de la transacción que es generada ante cada conciliación de periodo / turno desde BM Tienda  -> Operaciones -> Conciliaciones

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

JSON ejemplo

JSON ejemplo de tillConciliation

{

    "_id" : ObjectId("626ad9b61a80e55c108dfca4"),

    "trainingModeFlag" : false,

    "suspendedFlag" : false,

    "voidedFlag" : false,

    "offlineFlag" : false,

    "contigencyFlag" : false,

    "storeCode" : "1",

    “externalId” : “1234”

    “costCenter” : “Centro1234”

    "terminalCode" : "0",

    "workstationCategoryId" : "3",

    "trxNumber" : 8250,

    "businessDayDate" : ISODate("2022-04-25T03:00:00.000Z"),

    "beginDateTime" : ISODate("2022-04-28T18:15:18.855Z"),

    "endDateTime" : ISODate("2022-04-28T18:15:18.855Z"),

    "periodNumber" : 4038,

    "sbPeriodNumber" : 4042,

    "periodCode" : 1955,

    "subPeriodCode" : 4,

    "userName" : "suser",

    "originalTransaction" : "<!--NO SE UTILIZA-->",

    "controlTransaction" : {

        "typeCode" : "TillConciliation",

        "subTypeCode" : null,

        "typeId" : 61,

        "TillConciliation" : {

            "periodConciliationFlag" : true,

            "amounts" : {

                "tenderLoanTotalAmount" : NumberDecimal("0.00000"),

                "tenderPickupTotalAmount" : NumberDecimal("0.00000"),

                "tenderDepositoryTotalAmount" : null,

                "positiveTenderTotalAmount" : NumberDecimal("3080.60000"),

                "negativeTenderTotalAmount" : NumberDecimal("0.00000"),

                "othersIncome" : NumberDecimal("0.00000"),

                "othersExpenditure" : NumberDecimal("0.00000"),

                "presented" : NumberDecimal("0.00000"),

                "excessesMissing" : NumberDecimal("1489.80000")

            },

            "controlTransactionTillLineItems" : [{

                    "sequence" : 1,

                    "conciliatedFlag" : true,

                    "conciliationReason" : ObjectId("5ea5565c5604c8593c6081d0"),

                    "conciliationComments" : "Comentario",

                    "conciliationOperator" : "suser",

                    "conciliationDate" : ISODate("2022-04-28T18:14:50.989Z"),

                    "tenderRepository" : "1prueba1242",

                    "amounts" : {

                        "tenderLoanTotalAmount" : NumberDecimal("0.00000"),

                        "tenderPickupTotalAmount" : NumberDecimal("0.00000"),

                        "positiveTenderTotalAmount" : NumberDecimal("1489.80000"),

                        "negativeTenderTotalAmount" : NumberDecimal("0.00000"),

                        "othersIncome" : NumberDecimal("0.00000"),

                        "othersExpenditure" : NumberDecimal("0.00000"),

                        "presented" : NumberDecimal("0.00000"),

                        "excessesMissing" : NumberDecimal("1489.80000")

                    },

                    "controlTransactionTillTenderLineItems" : [{

                            "sequence" : 1,

                            "tender" : "EFECTIVO",

                         “tenderCode”: “EFEC”

                            "amounts" : {

                                "tenderLoanTotalAmount" : NumberDecimal("0"),

                                "tenderPickupTotalAmount" : NumberDecimal("0"),

                                "positiveTenderTotalAmount" : NumberDecimal("1489.8"),

                                "negativeTenderTotalAmount" : NumberDecimal("0"),

                                "othersIncome" : NumberDecimal("0"),

                                "othersExpenditure" : NumberDecimal("0"),

                                "presented" : NumberDecimal("0"),

                                "excessesMissing" : NumberDecimal("0.0")

                            }

                        }],

                    "controlTransactionSecondaryTillLineItems" : [{

                            "sequence" : 1,

                            "tenderRepository" : "Till for Workstation 524",

                            "amounts" : {

                                "tenderLoanTotalAmount" : NumberDecimal("0"),

                                "tenderPickupTotalAmount" : NumberDecimal("0"),

                                "positiveTenderTotalAmount" : NumberDecimal("0"),

                                "negativeTenderTotalAmount" : NumberDecimal("0"),

                                "othersIncome" : NumberDecimal("0"),

                                "othersExpenditure" : NumberDecimal("0"),

                                "presented" : NumberDecimal("0"),

                                "excessesMissing" : NumberDecimal("0")

                            },

                            "controlTransactionSecondaryTillTenderLineItems" : [{

                                    "sequence" : 1,

                                    "tender" : "EFECTIVO",

                                       “tenderCode”: “EFEC”

                                    "amount" : {

                                        "tenderLoanTotalAmount" : NumberDecimal("0"),

                                        "tenderPickupTotalAmount" : NumberDecimal("0"),

                                        "positiveTenderTotalAmount" : NumberDecimal("1489.8"),

                                        "negativeTenderTotalAmount" : NumberDecimal("0"),

                                        "othersIncome" : NumberDecimal("0"),

                                        "othersExpenditure" : NumberDecimal("0"),

                                        "presented" : NumberDecimal("0"),

                                        "excessesMissing" : NumberDecimal("0.0")

                                    }

                                }]

                        }, {

                            "sequence" : 2,

                            "tenderRepository" : "Till for Operator asilva",

                            "amounts" : {

                                "tenderLoanTotalAmount" : NumberDecimal("0"),

                                "tenderPickupTotalAmount" : NumberDecimal("0"),

                                "positiveTenderTotalAmount" : NumberDecimal("1489.8000000000002"),

                                "negativeTenderTotalAmount" : NumberDecimal("0"),

                                "othersIncome" : NumberDecimal("0"),

                                "othersExpenditure" : NumberDecimal("0"),

                                "presented" : NumberDecimal("0"),

                                "excessesMissing" : NumberDecimal("1489.8000000000002")

                            },

                            "controlTransactionSecondaryTillTenderLineItems" : [{

                                    "sequence" : 1,

                                    "tender" : "EFECTIVO",

                                       “tenderCode”: “EFEC”

                                    "amount" : {

                                        "tenderLoanTotalAmount" : NumberDecimal("0"),

                                        "tenderPickupTotalAmount" : NumberDecimal("0"),

                                        "positiveTenderTotalAmount" : NumberDecimal("1489.8"),

                                        "negativeTenderTotalAmount" : NumberDecimal("0"),

                                        "othersIncome" : NumberDecimal("0"),

                                        "othersExpenditure" : NumberDecimal("0"),

                                        "presented" : NumberDecimal("0"),

                                        "excessesMissing" : NumberDecimal("0.0")

                                    }

                                }]

                        }]

                }, {

                    "sequence" : 2,

                    "conciliatedFlag" : true,

                    "conciliationReason" : ObjectId("5ea5565c5604c8593c6081d0"),

                    "conciliationComments" : "Comentario",

                    "conciliationOperator" : "suser",

                    "conciliationDate" : ISODate("2022-04-28T18:14:50.989Z"),

                    "tenderRepository" : "1prueba30931",

                    "amounts" : {

                        "tenderLoanTotalAmount" : NumberDecimal("0.00000"),

                        "tenderPickupTotalAmount" : NumberDecimal("0.00000"),

                        "positiveTenderTotalAmount" : NumberDecimal("1590.80000"),

                        "negativeTenderTotalAmount" : NumberDecimal("0.00000"),

                        "othersIncome" : NumberDecimal("0.00000"),

                        "othersExpenditure" : NumberDecimal("0.00000"),

                        "presented" : NumberDecimal("0.00000"),

                        "excessesMissing" : NumberDecimal("1590.80000")

                    },

                    "controlTransactionTillTenderLineItems" : [{

                            "sequence" : 1,

                            "tender" : "EFECTIVO",

                              “tenderCode”: “EFEC”

                            "amounts" : {

                                "tenderLoanTotalAmount" : NumberDecimal("0"),

                                "tenderPickupTotalAmount" : NumberDecimal("0"),

                                "positiveTenderTotalAmount" : NumberDecimal("1590.8"),

                                "negativeTenderTotalAmount" : NumberDecimal("0"),

                                "othersIncome" : NumberDecimal("0"),

                                "othersExpenditure" : NumberDecimal("0"),

                                "presented" : NumberDecimal("0"),

                                "excessesMissing" : NumberDecimal("0.0")

                            }

                        }],

                    "controlTransactionSecondaryTillLineItems" : [{

                            "sequence" : 1,

                            "tenderRepository" : "Till for Operator nacho",

                            "amounts" : {

                                "tenderLoanTotalAmount" : NumberDecimal("0"),

                                "tenderPickupTotalAmount" : NumberDecimal("0"),

                                "positiveTenderTotalAmount" : NumberDecimal("1590.8"),

                                "negativeTenderTotalAmount" : NumberDecimal("0"),

                                "othersIncome" : NumberDecimal("0"),

                                "othersExpenditure" : NumberDecimal("0"),

                                "presented" : NumberDecimal("0"),

                                "excessesMissing" : NumberDecimal("1590.8")

                            },

                            "controlTransactionSecondaryTillTenderLineItems" : [{

                                    "sequence" : 1,

                                    "tender" : "EFECTIVO",

                                       “tenderCode”: “EFEC”

                                    "amount" : {

                                        "tenderLoanTotalAmount" : NumberDecimal("0"),

                                        "tenderPickupTotalAmount" : NumberDecimal("0"),

                                        "positiveTenderTotalAmount" : NumberDecimal("1590.8"),

                                        "negativeTenderTotalAmount" : NumberDecimal("0"),

                                        "othersIncome" : NumberDecimal("0"),

                                        "othersExpenditure" : NumberDecimal("0"),

                                        "presented" : NumberDecimal("0"),

                                        "excessesMissing" : NumberDecimal("0.0")

                                    }

                                }]

                        }]

                }]

        }

    },

    "trxOrigin" : "bm",

    "trxStatus" : "ok",

    "trxType" : "TillConciliation",

    "trxTypeCode" : 61,

    "errorDetail" : null,

    "updatedAt" : ISODate("2022-04-28T18:15:30.250Z")

}

Detalle de los campos del JSON de una conciliación de período (till Conciliation)

Campo

tipo

Descripción

id

string

Uso interno de bridge

trainingModeFlag

boolean

no utilizado en la conciliación

suspendedFlag

boolean

no utilizado en la conciliación

voidedFlag

boolean

no utilizado en la conciliación

offlineFlag

boolean

no utilizado en la conciliación

contigencyFlag

boolean

no utilizado en la conciliación

storeCode

string

código de la tienda

externalId

number

código externo de la tienda

costCenter

string

código de centro de costo de la tienda

terminalCode

string

código de la terminal

workstationCategoryId

string

Indica la categoría de la terminal desde donde se realiza la conciliación

trxNumber

number

número de la transacción

businessDayDate

datetime

Fecha contable

beginDateTime

datetime

Fecha y hora en que inicia la transacción

endDateTime

datetime

Fecha y hora en que finaliza la transacción

periodNumber

number

Número de período de la conciliación

sbPeriodNumber

numbre

Número de subperíodo o turno de la conciliación

periodCode

number

Código del periodo de la conciliación

subPeriodCode

number

Código del subperiodo de la conciliación

userName

string

Nombre de usuario que realiza la transacción

originalTransaction

-

NO SE UTILIZA

controlTransaction {

lista

tag que incluye detalle de la conciliación

typeCode

string

Indica el tipo de transacción: TillConciliation (conciliación)

subTypeCode

string

Indica el subtipo de transacción

typeId

string

ID del tipo de transacción (uso interno)

TillConciliation {

lista

Tipo de transacción

periodConciliationFlag

boolean

Identifica sí el período / turno está conciliado

Amounts {

lista

Tag que incluye todos los montos de la conciliación a nivel total de tienda

tenderLoanTotalAmount

numberdecimal

indica el monto de las dotaciones

tenderPickupTotalAmount

numberdecimal

Indica el monto de los retiros 

                     tenderWithdrawalTotalAmountnumberdecimalIndica el monto de las rendiciones

tenderDepositoryTotalAmount

numberdecimal

No utilizado

positiveTenderTotalAmount

numberdecimal

Indica el monto de las ventas

negativeTenderTotalAmount

numberdecimal

Indica el monto de las devoluciones

othersIncome

numberdecimal

Indica el monto de las cobranzas

othersExpenditure

numberdecimal

Indica el monto de las devoluciones de cobranzas

presented

numberdecimal

monto de los arqueos

excessesMissing       }

numberdecimal

Indica los montos de sobrante / faltante

      controlTransactionTillLineItems [ {

lista

Informa el detalle por cuenta primaria  (operador / terminal / categoría de terminal) 

sequence

number

Secuencia de la transacción

conciliatedFlag

boolean

Identifica si la cuenta esta conciliada

conciliationReason

string

Identifica el motivo de diferencia

conciliationComments

string

Comentarios adicionales de la conciliación

conciliationOperator

string

operador que concilió la cuenta

conciliationDate

datetime

Indica la fecha y hora en que se concilió la cuenta

tenderRepository

string

Indica la cuenta primaria (operador / terminal / categoría de terminal) 

Amounts {

lista

Tag que incluye todos los montos acumulados por cuenta base  (operador / terminal / categoría de terminal) 

tenderLoanTotalAmount

numberdecimal

indica el monto de las dotaciones

tenderPickupTotalAmount

numberdecimal

Indica el monto de los retiros

tenderWithdrawalTotalAmount

numberdecimal

Indica el monto de las rendiciones

positiveTenderTotalAmount

numberdecimal

Indica el monto de las ventas

negativeTenderTotalAmount

numberdecimal

Indica el monto de las devoluciones

othersIncome

numberdecimal

Indica el monto de las cobranzas

othersExpenditure

numberdecimal

Indica el monto de las devoluciones de cobranzas

presented

numberdecimal

Indica el monto de los arqueos

excessesMissing    }

numberdecimal

Indica los montos de sobrante / faltante

   controlTransactionTillTenderLineItems [ {

lista

Informa el detalle por cuenta primaria  (operador / terminal / categoría de terminal) y medio de pago

sequence

number

Secuencia de transacción

tender

string

Indica el medio de pago

tenderCode

string

código de medio de pago

Amounts {

lista

Tag que incluye todos los montos acumulados por cuenta base  (operador / terminal / categoría de terminal) y medio de pago

tenderLoanTotalAmount

numberdecimal

indica el monto de las dotaciones

tenderPickupTotalAmount

numberdecimal

Indica el monto de los retiros

tenderWithdrawalTotalAmount

numberdecimal

Indica el monto de las rendiciones

positiveTenderTotalAmount

numberdecimal

Indica el monto de las ventas

negativeTenderTotalAmount

numberdecimal

Indica el monto de las devoluciones

othersIncome

numberdecimal

Indica el monto de las cobranzas

othersExpenditure

numberdecimal

Indica el monto de las devoluciones de cobranzas

presented

numberdecimal

Indica el monto de los arqueos

excessesMissing   } ]

numberdecimal

Indica los montos de sobrante / faltante

controlTransactionSecondaryTillLineItems {

lista

Informa el detalle por cuenta secundaria (operador / terminal / categoría de terminal) 

sequence

number

Secuencia de transacción

tenderRepository

string

Identifica la cuenta base

Amounts {


Tag que incluye todos los montos acumulados por cuenta base secundaria  (operador / terminal / categoría de terminal) 

tenderLoanTotalAmount

numberdecimal

indica el monto de las dotaciones

tenderPickupTotalAmount

numberdecimal

Indica el monto de los retiros

tenderWithdrawalTotalAmount

numberdecimal

Indica el monto de las rendiciones

positiveTenderTotalAmount

numberdecimal

Indica el monto de las ventas

negativeTenderTotalAmount

numberdecimal

Indica el monto de las devoluciones

othersIncome

numberdecimal

Indica el monto de las cobranzas

othersExpenditure

numberdecimal

Indica el monto de las devoluciones de cobranzas

presented

numberdecimal

Indica el monto de los arqueos

excessesMissing}

numberdecimal

Indica los montos de sobrante / faltante

controlTransactionSecondaryTillTenderLineItems {

lista

Informa el detalle por cuenta secundaria (operador / terminal / categoría de terminal) y medio de pago

sequence

number

Número de secuencia

tender

string

Indica el medio de pago

tenderCode

number

código de medio de pago

Amount {

lista

Tag que incluye todos los montos acumulados por cuenta base  (operador / terminal / categoría de terminal)  y medio de pago

tenderLoanTotalAmount

numberdecimal

indica el monto de las dotaciones

tenderPickupTotalAmount

numberdecimal

Indica el monto de los retiros 

tenderWithdrawalTotalAmount

numberdecimal

Indica el monto de las rendiciones

positiveTenderTotalAmount

numberdecimal

Indica el monto de las ventas

negativeTenderTotalAmount

numberdecimal

Indica el monto de las devoluciones

othersIncome

numberdecimal

Indica el monto de las cobranzas

othersExpenditure

numberdecimal

Indica el monto de las devoluciones de cobranzas

presented

numberdecimal

Indica el monto de los arqueos

excessesMissing}}}

numberdecimal

Indica los montos de sobrante / faltante

trxOrigin

string

Origen de la transacción

trxStatus

string

Estatus de la transacción

trxType

string

Tipo de transacción, en este caso es TillConciliation

trxTypeCode

number

Código del tipo de transacción

errorDetail

object

Detalle del error

updatedAt

datetime

Fecha en que fue actualizado la transacción



  • Sem rótulos