> ## 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.

# Asigna una divergencia de contrato de consignado

> Asigna un elemento abierto a un operador. expectedVersion protege la operación mediante compare-and-swap; la operación es idempotente mediante el encabezado X-Idempotency que aplica el middleware de la plataforma.



## OpenAPI

````yaml es/openapi/v3-current/lender.yaml post /api/v1/internal/br/consignado/divergences/{id}/assign
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: Superficie OpenAPI 3.1 code-first del servicio Lender.
  license:
    name: Lerian Studio General License
  title: Lender API
  version: 1.0.0
servers:
  - url: https://lender.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - description: >-
      Operaciones de contabilidad del ledger: entradas de journal y asientos de
      accrual para cuentas de préstamo.
    name: Accounting
  - description: >-
      Recepción y ciclo de vida de la solicitud de préstamo: envío, decisión y
      estado.
    name: LoanApplications
  - description: >-
      Catálogo de productos de préstamo: definición, versionado y activación de
      productos de crédito.
    name: LoanProducts
  - description: >-
      Operaciones de servicing de cuentas de préstamo: saldos, cronogramas y
      acciones a nivel de cuenta.
    name: Loan Accounts
  - description: >-
      Registro de jurisdicciones: perfiles de jurisdicción soportados y sus
      capacidades.
    name: Jurisdictions
  - description: >-
      Operaciones de solicitud de préstamo específicas por jurisdicción
      (superficie de originación de Brasil).
    name: Loan Applications
  - description: >-
      Operaciones de cálculo de impuestos para crédito específico por
      jurisdicción (por ejemplo, IOF de Brasil).
    name: Tax
  - description: >-
      Operaciones de consignado privado de Brasil: triaje de divergencias de
      contrato y ajustes compensatorios.
    name: Consignado
paths:
  /api/v1/internal/br/consignado/divergences/{id}/assign:
    post:
      tags:
        - Consignado
      summary: Asigna una divergencia de contrato de consignado
      description: >-
        Asigna un elemento abierto a un operador. expectedVersion protege la
        operación mediante compare-and-swap; la operación es idempotente
        mediante el encabezado X-Idempotency que aplica el middleware de la
        plataforma.
      operationId: assignConsignadoContractDivergence
      parameters:
        - description: Contract divergence identifier.
          in: path
          name: id
          required: true
          schema:
            description: Contract divergence identifier.
            format: uuid
            type: string
        - description: Canonical idempotency request ID (lib-commons enforcer reads this).
          in: header
          name: X-Idempotency
          required: true
          schema:
            description: >-
              Canonical idempotency request ID (lib-commons enforcer reads
              this).
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssignContractDivergenceHumaRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractDivergenceHumaBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
components:
  schemas:
    AssignContractDivergenceHumaRequest:
      additionalProperties: false
      properties:
        assignee:
          description: Operator now responsible for the item.
          maxLength: 255
          minLength: 1
          type: string
        expectedVersion:
          description: 'Compare-and-swap guard: the version this request was read against.'
          format: int64
          minimum: 1
          type: integer
      required:
        - assignee
        - expectedVersion
      type: object
    ContractDivergenceHumaBody:
      additionalProperties: false
      properties:
        adjustmentStatus:
          description: not_required|required|requested|posted.
          type: string
        amountCurrency:
          description: ISO-4217 currency of the contested amounts.
          type: string
        assignedAt:
          description: Instant of the current assignment (RFC3339 UTC).
          type: string
        assignee:
          description: Operator currently responsible, when assigned.
          type: string
        authority:
          description: >-
            Source of truth for the contested value:
            client|dataprev|gateway|lender.
          type: string
        calculatedAt:
          description: Instant the Lender calculation was produced (RFC3339 UTC).
          type: string
        category:
          description: 'Bounded category: cash|rate|terms|margin|registration|technical.'
          type: string
        classification:
          description: Specific durable exception inside the category.
          type: string
        clientDeclaredAmount:
          description: Authoritative value the client declared, when a comparison exists.
          type: string
        contractId:
          description: Contract the divergence belongs to.
          type: string
        createdAt:
          description: RFC3339 UTC.
          type: string
        disposedAt:
          description: Instant of disposition (RFC3339 UTC), present once disposed.
          type: string
        dispositionActor:
          description: Identity that disposed the item, present once disposed.
          type: string
        dispositionJustification:
          description: Free-text justification, present once disposed.
          type: string
        dispositionResult:
          description: Structured outcome, present once disposed.
          type: string
        dispositionState:
          description: open|disposed.
          type: string
        effect:
          description: >-
            What the item does to the flow:
            audit_only|posting_pending|adjustment_required|booking_blocked.
          type: string
        firstObservedAt:
          description: First durable persist (RFC3339 UTC); the SLA clock start.
          type: string
        id:
          description: Contract divergence identifier.
          type: string
        latestObservedAt:
          description: Most recent observation (RFC3339 UTC).
          type: string
        lenderCalculatedAmount:
          description: Lender calculation. Audit evidence only, never authoritative.
          type: string
        occurrenceKey:
          description: Replay-fencing key for the observed occurrence.
          type: string
        railAcceptedAt:
          description: Instant the rail accepted the underlying fact (RFC3339 UTC).
          type: string
        ruleVersion:
          description: Version of the rule that produced the Lender calculation.
          type: string
        slaDueAt:
          description: Resolution deadline (RFC3339 UTC).
          type: string
        updatedAt:
          description: RFC3339 UTC.
          type: string
        version:
          description: >-
            Compare-and-swap guard: every mutation supplies this as
            expectedVersion.
          format: int64
          type: integer
      required:
        - id
        - contractId
        - category
        - classification
        - effect
        - authority
        - occurrenceKey
        - railAcceptedAt
        - firstObservedAt
        - latestObservedAt
        - slaDueAt
        - dispositionState
        - adjustmentStatus
        - version
        - createdAt
        - updatedAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          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
    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

````