> ## 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. # Alterar los términos mutables de un contrato averbado > Esta operación actúa como proxy de alterar-consignado-trabalhador (Manual 003 §3.2): recuento de cuotas, monto de la cuota, nombre del trabajador y, opcionalmente, la primera competencia de deducción. Se aplican la misma prueba de titularidad del tenant y el mismo requisito de idempotencia que en suspend. El dinero es una cadena decimal, nunca un flotante. ## OpenAPI ````yaml es/openapi/v3-current/consignado.yaml patch /v1/consignado/contracts/{numero_contrato}/terms openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian Studio url: https://lerian.studio description: >- Superficie OpenAPI 3.1 para Lerian Consignado — Dataprev. API cubre las credenciales y la configuración de red de tenant, el margen de los trabajadores, las subastas y ofertas de préstamos, el registro y el ciclo de vida de los contratos, la confirmación de desembolsos, la portabilidad, la refinanciación, la renegociación, las garantías de FGTS, la conciliación, los fondos, las asignaciones, el uso, el rendimiento y las suscripciones a eventos. El material secreto se escribe en el almacén secreto tenant y ninguna operación lo devuelve nunca. license: name: Lerian Studio General License title: Lerian Consignado API version: v1.0.0 servers: - url: https://consignado.sandbox.lerian.net security: - BearerAuth: [] tags: - description: >- Custodia de credenciales de Dataprev y configuración pública del rail por tenant (carga, estado, rotación, revocación, código del solicitante y URL base del portal del trabajador) name: Credentials - description: >- Uso de la gateway del consignado en el ámbito del tenant: agregación de unidades facturables con precio por competencia name: Consignado Usage - description: >- Plano de control de suscripción al hub de streaming per-tenant (enumerar, crear, obtener, rotar, revocar y probar la entrega) name: Subscriptions - description: >- Superficie de rail de nómina Dataprev: lecturas de saldo y autorización FGTS, ejecución de garantía FGTS, suspensión de contrato, reactivación y cambios de términos, documentos de contrato propios de la red y lecturas bajo demanda de leilão solicitações, escriturações, repasses y terminaciones de empleo. name: Consignado Rail - description: >- Superficie de comando de red síncrona: las operaciones de un bancarizador sin que el prestamista conduzca sobre HTTP. Cada uno comparte su implementación de comando con el activador de evento de prestamista equivalente. name: Consignado Rail Commands - description: >- Confirmación de desembolso propiedad de la gateway: un banco cliente que registra el dinero que ya pagó a un trabajador. No cruza ninguna frontera gubernamental y no representa ninguna operación Dataprev. name: Consignado Disbursement - description: > Rendimiento de red Dataprev saliente de autoservicio per-tenant: lea y configure el requests-per-second propio de este tenant, incluida una pausa deliberada en cero name: Consignado Throughput paths: /v1/consignado/contracts/{numero_contrato}/terms: patch: tags: - Consignado Rail summary: Alterar los términos mutables de un contrato averbado description: >- Esta operación actúa como proxy de alterar-consignado-trabalhador (Manual 003 §3.2): recuento de cuotas, monto de la cuota, nombre del trabajador y, opcionalmente, la primera competencia de deducción. Se aplican la misma prueba de titularidad del tenant y el mismo requisito de idempotencia que en suspend. El dinero es una cadena decimal, nunca un flotante. operationId: alterConsignadoContractTerms parameters: - description: >- Rail contract number of an averbação belonging to the authenticated tenant. in: path name: numero_contrato required: true schema: description: >- Rail contract number of an averbação belonging to the authenticated tenant. examples: - 99999999999AN1 maxLength: 15 minLength: 1 type: string - description: >- Client-chosen idempotency key. REQUIRED: an absent key is 422, never a generated default. in: header name: X-Idempotency required: true schema: description: >- Client-chosen idempotency key. REQUIRED: an absent key is 422, never a generated default. examples: - idem-terms-2026-07-30-0001 type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ContratoTermsBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ContratoOperationResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: ContratoTermsBody: additionalProperties: false properties: codigoInscricaoEmpregador: description: 'Employer inscription type: 1 = CNPJ, 2 = CPF.' enum: - '1' - '2' examples: - '1' type: string competenciaInicioDesconto: description: >- First deduction competência, yyyyMM. Obrigatório=Não at the rail: omitted, the rail fills it automatically. Relayed verbatim — sending an empty string would be an invalid value rather than an absence, so an omitted field is dropped from the wire. examples: - '202608' type: string cpf: description: >- Worker CPF, exactly 11 digits. In the BODY, never a path or query parameter. examples: - '99999999999' pattern: ^[0-9]{11}$ type: string matricula: examples: - 99999999999-A minLength: 1 type: string nomeTrabalhador: examples: - Trabalhador 99999999999 minLength: 1 type: string numeroInscricaoEmpregador: examples: - '42422253000101' minLength: 1 type: string numeroParcelas: description: Number of instalments. examples: - 11 format: int64 minimum: 1 type: integer valorParcela: description: >- Instalment amount (decimal string, BRL, at most 2 decimals). A decimal string end to end — a money field never becomes a binary float on the way to the rail. examples: - '444.96' pattern: ^[0-9]+(\.[0-9]{1,2})?$ type: string required: - nomeTrabalhador - numeroParcelas - valorParcela - cpf - matricula - codigoInscricaoEmpregador - numeroInscricaoEmpregador type: object ContratoOperationResponse: additionalProperties: false properties: hashOperacao: description: >- The rail's own operation identity, surfaced as its exact decimal digits (the rail types it Numérico). Manual 003 publishes no response table for these operations, so it MAY be absent on a 2xx — a 2xx is itself the success signal, do not branch on this field being present. examples: - '33908101' type: string type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -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 ````