Skip to main content
The Lerian Consignado — Dataprev business surface is entirely event-driven. Averbação, detecting an auction (leilão) win, margin reads, and reconciliation all happen by exchanging events over Kafka — none of them has an HTTP endpoint. The only HTTP surface Consignado exposes is credential custody (certificate and OAuth material), documented in the Consignado API reference. Money amounts and rates cross the wire as decimal strings, never floats. Every event carries its schema version in the ce-schemaversion header and travels in the shared CloudEvents envelope. Every fact carries version 1.0.0 except consignado_proposal.accepted, which carries 2.0.0. Consignado’s ce-source is consignado-gw, which also names its topic namespace (see Topic naming): emitted events land on consignado-gw.<resource>.<event>, with a .v2 suffix on the one fact whose schema major is 2. Every fact is outbox-backed: it is written in the same database transaction as the state change it reports and relayed to the broker afterwards.

Events emitted

Facts Consignado emits after acting on a command or picking up an input from the rail. Optional fields are marked ? — an absent key means the rail sent nothing, where an empty string would read as a blank the rail sent.

Commands consumed

Commands Consignado consumes from Lender. It subscribes by topic, under the producer’s (lender) namespace; the producing service sets the ce-type header, so it is not listed here. The averbação command subscription is active only in deployments where averbação is enabled; the margin command is always subscribed. No producer emits the margin command yet: Lender declares lender.consignado_margin.requested as a contract reservation (see Lender events), so the margin round trip, including the consignado_margin.fetched and consignado_afastamento.reported facts it produces, carries no live traffic until that command ships.