> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Read the CEF D+2 repasse transfers included in a window

> Reads the rail's consultar-repasse-pagamentos (Manual 005 v1.16 §3.5): the per-registro CEF D+2 transfers included in the inclusion window, each with its own competência, guia and transfer instant. The existence of a registro IS the liquidation — the rail publishes no status field. Same mandatory 30-day-capped window as escriturações, and the same no-write discipline: the job's done-keys are untouched.



## OpenAPI

````yaml /pt/openapi/v3-current/consignado.yaml get /v1/consignado/reconciliation/repasses
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: >-
    OpenAPI 3.1 surface for Lerian Consignado — Dataprev. The API covers tenant
    credentials and rail configuration, worker margin, loan auctions and bids,
    contract registration and lifecycle, B3 instrument codes, disbursement
    confirmation, portability, refinancing, renegotiation, FGTS guarantees,
    reconciliation, funds, assignments, throughput, and event subscriptions.
  license:
    name: Lerian Studio General License
  title: Lerian Consignado API
  version: v1.0.0
servers:
  - url: https://br-consignado-gw.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - description: >-
      Per-tenant Dataprev credential custody and public rail configuration
      (upload, status, rotation, revoke, requester code, and worker portal base
      URL)
    name: Credentials
  - description: >-
      Per-tenant streaming-hub subscription control-plane (list, create, get,
      rotate, revoke, and test delivery)
    name: Subscriptions
  - description: >-
      Dataprev payroll-rail surface: FGTS balance and authorization reads, the
      FGTS guarantee execution, contract suspension, reactivation and term
      changes, the rail's own contract documents, and the on-demand reads of
      leilão solicitações, escriturações, repasses and employment terminations
    name: Consignado Rail
  - description: >-
      Synchronous rail command surface: the operations a bancarizador without
      the lender drives over HTTP.
    name: Consignado Rail Commands
  - description: >-
      Gateway-owned disbursement confirmation: a client bank recording money it
      has ALREADY paid to a worker. It crosses no government boundary and
      proxies no Dataprev operation.
    name: Consignado Disbursement
  - description: >-
      Per-tenant self-service outbound Dataprev rail throughput: read and set
      this tenant's own requests-per-second, including a deliberate pause at
      zero
    name: Consignado Throughput
  - description: >-
      The B3 instrument code (Código IF) of an averbado contract: informed once
      by the bancarizador after B3 registers the CCB, and read back
    name: Consignado Registro B3
paths:
  /v1/consignado/reconciliation/repasses:
    get:
      tags:
        - Consignado Rail
      summary: Read the CEF D+2 repasse transfers included in a window
      description: >-
        Reads the rail's consultar-repasse-pagamentos (Manual 005 v1.16 §3.5):
        the per-registro CEF D+2 transfers included in the inclusion window,
        each with its own competência, guia and transfer instant. The existence
        of a registro IS the liquidation — the rail publishes no status field.
        Same mandatory 30-day-capped window as escriturações, and the same
        no-write discipline: the job's done-keys are untouched.
      operationId: listConsignadoRepasses
      parameters:
        - description: >-
            Inclusion window start, RFC 3339 (rail dataHoraInicio, Obrigatório
            Sim — Manual 005 v1.16 §3.4.1 p.28 / §3.5.1 p.35).
          explode: false
          in: query
          name: data_hora_inicio
          required: true
          schema:
            description: >-
              Inclusion window start, RFC 3339 (rail dataHoraInicio, Obrigatório
              Sim — Manual 005 v1.16 §3.4.1 p.28 / §3.5.1 p.35).
            examples:
              - '2026-07-01T00:00:00Z'
            format: date-time
            type: string
        - description: >-
            Inclusion window end, RFC 3339 (rail dataHoraFim, Obrigatório Sim).
            The span must not exceed 30 days — the rail answers code GR above
            that (Manual 005 v1.16 §4.1 p.40), and this gateway refuses 422
            locally so the attempt costs no rail quota.
          explode: false
          in: query
          name: data_hora_fim
          required: true
          schema:
            description: >-
              Inclusion window end, RFC 3339 (rail dataHoraFim, Obrigatório
              Sim). The span must not exceed 30 days — the rail answers code GR
              above that (Manual 005 v1.16 §4.1 p.40), and this gateway refuses
              422 locally so the attempt costs no rail quota.
            examples:
              - '2026-07-30T00:00:00Z'
            format: date-time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataprevRepasseResponse'
          description: OK
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unprocessable Entity
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Internal Server Error
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      security:
        - BearerAuth: []
components:
  schemas:
    DataprevRepasseResponse:
      additionalProperties: false
      properties:
        registros:
          description: >-
            The per-registro repasse records included in the window, each with
            its own competência. This read returns records, NOT a competência
            aggregate. An empty list is the rail's answer, not an error.
          items:
            $ref: '#/components/schemas/DataprevRepasseRecord'
          type:
            - array
            - 'null'
      required:
        - registros
      type: object
    Detail:
      additionalProperties: true
      properties:
        code:
          description: >-
            Stable, machine-readable product error code. One of the enumerated
            values: the CLT-NNNN catalog codes for the general refusal classes;
            the named command conflicts, which a client branches on to tell one
            conflict from another; the four terminal refusals
            IDEMPOTENCY_STATE_UNRECOGNISED, IDEMPOTENCY_RECORD_UNREADABLE,
            IDEMPOTENCY_OUTCOME_UNRECORDED and IDEMPOTENCY_REPLAY_UNAVAILABLE
            (422), which tell the client to reconcile the original request and
            never retry under a new key; IDEMPOTENCY_KEY_REUSE (422): the key is
            spent on a different request, so send a new key; the codes a single
            surface answers, named after it (FUNDO_*, REGISTRO_B3_*, ...); and
            the 5xx codes naming an upstream (DATAPREV_*, STREAMING_HUB_*,
            TENANT_MANAGER_*, the Access Manager's AUT-0033 and AUT-1021) or an
            unknown outcome, whose detail is client-readable; and the Access
            Manager's AUT-1022 (403): the partner credential holds more than one
            originador, so name it in the path.
          enum:
            - AUT-0033
            - AUT-1021
            - AUT-1022
            - AVERBACAO_ARTIFACT_CONFLICT
            - AVERBACAO_CLAIM_CONFLICT
            - AVERBACAO_DOCUMENTATION_CONFLICT
            - AVERBACAO_EXCLUDED
            - AVERBACAO_HELD_BY_ANOTHER_SENDER
            - AVERBACAO_NOT_ACCEPTED
            - AVERBACAO_OPERATIONS_INTERNAL
            - AVERBACAO_OPERATIONS_INVALID_CURSOR
            - AVERBACAO_OPERATIONS_INVALID_QUERY
            - AVERBACAO_OPERATIONS_UNKNOWN_STATUS
            - AVERBACAO_OPERATION_NOT_FOUND
            - BID_NO_PROPOSTA_LEFT
            - BID_ORIGINADOR_INACTIVE
            - BID_ORIGINADOR_UNKNOWN
            - BID_PROPOSAL_SLOT_TAKEN
            - BID_SOLICITACAO_TAKEN
            - BID_SOLICITACAO_UNKNOWN
            - BID_SUBMISSIONS_INTERNAL
            - BID_SUBMISSIONS_INVALID_CURSOR
            - BID_SUBMISSIONS_UNKNOWN_SITUATION
            - BOOKING_FIELD_INVALID
            - CEDED_CREDIT_INTERNAL
            - CEDED_CREDIT_NO_FUND_ENTITLEMENT
            - CEDED_CREDIT_UNAVAILABLE
            - CLT-0001
            - CLT-0002
            - CLT-0003
            - CLT-0004
            - CLT-0005
            - CLT-0006
            - CLT-0007
            - CLT-0008
            - CLT-0009
            - CLT-0010
            - CLT-0011
            - CONTRACT_ALREADY_REGISTERED
            - CONTRACT_NOT_BOOKABLE
            - CURSOR_EXPIRED
            - CURSOR_FENCE_MISMATCH
            - DATAPREV_CREDENTIAL_REJECTED
            - DATAPREV_CREDENTIAL_REQUIRED
            - DATAPREV_CREDENTIAL_REVOKED
            - DATAPREV_INVALID_RESPONSE
            - DATAPREV_TIMEOUT
            - DATAPREV_UNAVAILABLE
            - DECLARED_DATES_OUT_OF_ORDER
            - DECLARED_TERMS_INCONSISTENT
            - DISBURSEMENT_CONFIRMATIONS_INTERNAL
            - DISBURSEMENT_CONFIRMATIONS_INVALID_CURSOR
            - DISBURSEMENT_PAYMENT_CONFLICT
            - EVENT_DELIVERY_INTERNAL
            - EXCLUSION_AUTHORITY_CONFLICT
            - EXCLUSION_BOOKING_IDENTITY_INCOMPLETE
            - EXCLUSION_DOCUMENTATION_UNDERWAY
            - EXCLUSION_OPERATIONS_INTERNAL
            - EXCLUSION_OPERATIONS_INVALID_CURSOR
            - EXCLUSION_OPERATIONS_INVALID_QUERY
            - EXCLUSION_OPERATIONS_UNKNOWN_STATUS
            - EXCLUSION_OPERATION_NOT_FOUND
            - EXCLUSION_RENEGOTIATION_UNDERWAY
            - FGTS_EXECUTION_ALREADY_REFUSED
            - FGTS_EXECUTION_CONTRACT_TAKEN
            - FGTS_EXECUTION_OUTCOME_UNRESOLVED
            - FGTS_EXECUTION_PAYLOAD_MISMATCH
            - FIRST_DEDUCTION_BEFORE_COMPETENCIA
            - FORMALIZATION_DEADLINE_EXCEEDED
            - FUNDO_CNPJ_CONFLICT
            - FUNDO_DEACTIVATED
            - FUNDO_INTERNAL
            - FUNDO_INVALID_ID
            - FUNDO_INVALID_INPUT
            - FUNDO_NOT_FOUND
            - FUNDO_NOT_REGISTERED
            - FUNDO_REF_CONFLICT
            - FUNDO_UNAVAILABLE
            - HELD_REPASSE_MONTH_CLOSED
            - HELD_REPASSE_MONTH_MISMATCH
            - HELD_REPASSE_NOT_FOUND
            - HELD_REPASSE_UNATTRIBUTABLE
            - IDEMPOTENCY_KEY_REUSE
            - IDEMPOTENCY_OUTCOME_UNRECORDED
            - IDEMPOTENCY_RECORD_UNREADABLE
            - IDEMPOTENCY_REPLAY_UNAVAILABLE
            - IDEMPOTENCY_STATE_UNRECOGNISED
            - INVALID_CONTRACT_NUMBER
            - INVALID_CURSOR
            - INVALID_EVENTS_INVALID_CURSOR
            - INVALID_EVENT_NOT_FOUND
            - INVALID_EVENT_NOT_REQUEUEABLE
            - INVALID_PAGE_LIMIT
            - INVENTORY_UNAVAILABLE
            - LOAN_PRODUCT_VERSION_UNKNOWN
            - MARGIN_SNAPSHOT_INCONSISTENT
            - MATRICULA_DIFFERS_FROM_PROPOSAL
            - ORIGINADOR_INTERNAL
            - ORIGINADOR_INVALID_ID
            - ORIGINADOR_INVALID_INPUT
            - ORIGINADOR_NOT_FOUND
            - ORIGINADOR_REF_CONFLICT
            - ORIGINADOR_UNAVAILABLE
            - OUTCOME_UNKNOWN
            - PORTABILIDADE_WINDOW_EXPIRED
            - RAIL_COMMANDS_INTERNAL
            - RAIL_COMMANDS_INVALID_CURSOR
            - RAIL_COMMANDS_TENANT_REQUIRED
            - RAIL_COMMANDS_UNKNOWN_FILTER
            - RAIL_COMMAND_ALREADY_REFUSED
            - RAIL_COMMAND_ANSWER_NOT_RETAINED
            - RAIL_COMMAND_CLAIM_CONFLICT
            - RAIL_COMMAND_CLOSE_CONTRADICTED
            - RAIL_COMMAND_NOT_CLOSEABLE
            - RAIL_COMMAND_OUTCOME_UNRESOLVED
            - RAIL_COMMAND_PAYLOAD_MISMATCH
            - RATE_OUTSIDE_PRODUCT_RANGE
            - REGISTRATION_NOT_FOUND
            - REGISTRO_B3_AVERBACAO_NAO_CONFIRMADA
            - REGISTRO_B3_CONTRATO_NAO_ENCONTRADO
            - REGISTRO_B3_DATA_REGISTRO_INVALIDA
            - REGISTRO_B3_INTERNAL
            - REGISTRO_B3_JA_INFORMADO
            - REGISTRO_B3_NAO_INFORMADO
            - REGISTRO_B3_UNAVAILABLE
            - REGISTRO_B3_UNWIRED
            - RENEGOTIATION_EXCLUSION_UNDERWAY
            - REPASSE_EXPECTATIONS_INTERNAL
            - REPASSE_EXPECTATIONS_INVALID_CURSOR
            - REPASSE_EXPECTATIONS_UNKNOWN_SITUATION
            - REVERSAO_WINDOW_EXPIRED
            - SALDO_DEVEDOR_INTERNAL
            - SALDO_DEVEDOR_INVALID_CURSOR
            - SALDO_DEVEDOR_NOT_FOUND
            - SALDO_DEVEDOR_TENANT_REQUIRED
            - SALDO_DEVEDOR_UNAVAILABLE
            - STREAMING_HUB_TIMEOUT
            - STREAMING_HUB_UNAVAILABLE
            - TENANT_MANAGER_TIMEOUT
            - TENANT_MANAGER_UNAVAILABLE
            - THROUGHPUT_HISTORY_INTERNAL
            - THROUGHPUT_HISTORY_INVALID_CURSOR
            - THROUGHPUT_HISTORY_TENANT_REQUIRED
            - THROUGHPUT_HISTORY_UNAVAILABLE
            - THROUGH_REQUIRED
            - UNKNOWN_QUERY_PARAMETER
            - VERSION_ADMITS_NO_PESSOA_FISICA
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
        upstream:
          $ref: '#/components/schemas/Upstream'
          description: >-
            RFC 9457 extension member: the error a proxied third-party provider
            reported. Absent unless the emitting service explicitly surfaced
            one.
      type: object
    DataprevRepasseRecord:
      additionalProperties: false
      properties:
        codigo_inscricao_empregador:
          description: >-
            The employer inscription type the rail named: 1 = CNPJ, 2 = CPF
            (Manual 005 v1.16 §3.5.2). Absent when the rail did not publish it.
          examples:
            - '1'
          type: string
        codigo_trf:
          description: The handle of the transfer to the financial institution.
          examples:
            - TRF00098765
          type: string
        competencia:
          description: >-
            The registro's OWN payroll competência, yyyyMM (Manual 005 v1.16
            §3.5.2). It can differ from the queried window: the 21/10/2025
            semantic flip changed what this field means, and
            data_hora_inclusao_dataprev is the disambiguator. Both are surfaced
            so a consumer can branch — the flip logic is NOT applied here.
          examples:
            - '202607'
          type: string
        cpf:
          description: >-
            The worker the repassed money moved for, 11 digits, re-padded from
            the rail's JSON Número (Manual 005 v1.16 §3.5.2 p.37). A repasse
            whose numero_contrato matches nothing in the consumer's book is the
            exception this read exists to raise; without this it names nobody.
            Empty when the rail did not publish it.
          examples:
            - '99971699990'
          type: string
        data_hora_inclusao_dataprev:
          description: >-
            When Dataprev recorded the registro, RFC 3339 UTC. It is the
            disambiguator for the 21/10/2025 competência semantic flip (Manual
            005 v1.16 §3.5.2): branch on it together with competencia. Surfaced
            only; not applied here.
          examples:
            - '2026-07-17T03:12:44Z'
          format: date-time
          type: string
        data_hora_pagamento_guia:
          description: >-
            When the EMPLOYER paid the guia, RFC 3339 UTC (Manual 005 v1.16
            §3.5.2). This is the instant the §3.5 D+2 repasse deadline actually
            runs from — but it is only published once the repasse arrives, so a
            missing-repasse alarm cannot be anchored on it. Zero when the rail
            published none.
          examples:
            - '2026-06-02T09:00:00Z'
          format: date-time
          type: string
        data_repasse_if:
          description: >-
            The rail's transfer instant to the financial institution, RFC 3339
            UTC (CEF D+2).
          examples:
            - '2026-07-17T00:00:00Z'
          format: date-time
          type: string
        id:
          description: >-
            The append-only identity of the repasse registro (Manual 005 v1.16
            §3.5.2) and its dedupe subject: one idempotent event is emitted per
            id, so at-least-once delivery and a restart re-emit are a no-op.
            Immutable per registro.
          examples:
            - repasse-000123456
          type: string
        matricula:
          description: >-
            The worker's payroll registration on the bond the repassed
            instalment was discounted from (Manual 005 v1.16 §3.5.2 p.37,
            Texto). Empty when the rail did not publish it.
          examples:
            - MATCEN716
          type: string
        numero_contrato:
          description: >-
            The contract this repasse settles — the reconciliation key against
            the expected schedule. The SAME contract can appear in N registros.
          examples:
            - '199971600000'
          type: string
        numero_guia:
          description: >-
            The payment-guia handle. A guia paid twice yields TWO registros
            carrying the same numero_guia — that is money to return, and whether
            it is a duplicidade to claw back is the consumer's call, not the
            gateway's.
          examples:
            - '000000012345678'
          type: string
        numero_inscricao_empregador:
          description: >-
            The employer inscription number exactly as the rail sent it (Manual
            005 v1.16 §3.5.2), never padded. Absent when the rail did not
            publish it.
          examples:
            - '42422253000101'
          type: string
        status_repasse:
          description: >-
            ALWAYS EMPTY from the real rail. Manual 005 v1.16 §3.5.2 publishes
            no situacao/PAGO/PENDENTE field on consultar-repasse-pagamentos —
            the mere EXISTENCE of a registro IS the liquidation, so do not wait
            for a status here. The key is retained only because it is a shipped
            cross-repo field on consignado.reconciliation.received; dropping it
            needs a coordinated migration.
          examples:
            - ''
          type: string
        valor_atualizacao_monetaria:
          description: >-
            Monetary restatement applied to the instalment, when any (decimal
            string, BRL). Absent when there is none.
          examples:
            - '3.47'
          type: string
        valor_juros_de_mora:
          description: >-
            Late-payment interest, when the rail charged any (decimal string,
            BRL). Absent when there is none.
          examples:
            - '11.16'
          type: string
        valor_multa:
          description: >-
            Late-payment penalty, when the rail charged one (decimal string,
            BRL). Absent when there is none.
          examples:
            - '22.33'
          type: string
        valor_parcela_paga:
          description: The instalment amount actually repassed (decimal string, BRL).
          examples:
            - '1116.31'
          type: string
        verbas_rescisorias:
          description: >-
            Marks a termination-benefit CANDIDATE, not trusted guarantee cash.
            It does NOT identify FGTS balance or penalty cash, recovery
            authority, ordering, or terminality — do not infer any of those from
            this flag.
          examples:
            - false
          type: boolean
      required:
        - id
        - numero_contrato
        - cpf
        - matricula
        - numero_guia
        - valor_parcela_paga
        - codigo_trf
        - data_repasse_if
        - data_hora_pagamento_guia
        - data_hora_inclusao_dataprev
        - status_repasse
        - verbas_rescisorias
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    Upstream:
      additionalProperties: false
      properties:
        code:
          description: The upstream provider's own error code, verbatim.
          examples:
            - E4001
          type: string
        message:
          description: >-
            The upstream provider's own error message, verbatim (bounded, never
            its raw response body).
          examples:
            - account not found at provider
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.