Inbound messaging from BACEN

Lerian SPB consumes the inbound STR settlement replies (R-legs) and the notices that arrive from BACEN over the RSFN. A settled status on the R-leg moves the transfer’s STR message to CONFIRMED, and a rejected status moves it to REJECTED. A pending status keeps the transfer open, because the STR still holds the entry. When BACEN accepts your STR0011, the transfer moves to CANCELLED. A cancelled status that answers no STR0011 of yours, or a status outside BACEN’s domain, opens a reconciliation case. Conta PI, electronic-money, rediscount and compulsory-deposit movements report a settled reply as SETTLED. Lerian SPB projects BACEN’s settlement fields verbatim. An STR transfer credit (an R2 or R3 reply) that matches no transfer the rail sent is a credit that another institution started. The rail records it as an inbound operation and publishes str.operation.received for your ledger to record. For each inbound notice, the rail publishes str.message.received. Some notices also change rail state and publish a dedicated event.

Inbound message	What the rail does	Dedicated event
GEN0001	Answers the echo and records the notice	—
GEN0004	Records the transmission error	`str.transmission.errorReceived`
GEN0005	Records the administrative notice	`str.admin.noticeReceived`
GEN0007, GEN0018, GEN0022	Updates the counterparty certificate state	`str.certificate.counterpartyChanged`
GEN0021	Updates the operating-window grades	`str.schedule.changed`
STR0015, STR0017	Reports the STR closing and opening	`str.readiness.changed`
STR0016	Reports the closing balance and the additional-aporte window	`str.balance.closingReported`
STR0018, STR0019	Reports a participant that BACEN excluded, included, or changed	`str.participant.directoryChanged`
LPI0006	Reports an automatic transfer	`str.autoTransfer.reported`
RCO0014	Reports a recalculated compulsory requirement	`str.compulsory.requirementRecalculated`
RCO0019	Reports a compulsory deposit that a third party made	`str.compulsory.depositAdvised`
SLB0001, SLB0003, SLB0005, SLB0008	Records the charge, the withdrawn charge, the credit, or the direct debit	`str.slb.entryNotified`
RDC0015, RDC0016	Converts or cancels the open rediscounts at STR close	—
SME0001R2, SME0002R2, SME0004R2	Records the electronic-money advice	`str.emoney.transferAdvised`

The rail quarantines an inbound frame that it cannot turn into a message, and opens a reconciliation case for it. The str.emoney.transferAdvised event’s data object always includes messageCode, numCtrlSTR, dtHrBC, vlrLanc, and dtMovto. Depending on the advice leg, it can also include debitedIspb, creditedIspb, numCtrlSTROr, hist, ispbIFCredtd, agCredtd, and ctCredtd. The event does not expose CNPJCliCredtd. Deduplicate this event by (eventType, data.numCtrlSTR), not by ce-id: a retry can produce a fresh ce-id, while the same control number identifies the same movement.