> ## 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. # Registar uma cessão de crédito ao seu fundo atribuído > Registra a cessão de um crédito e estabelece o limite de propriedade do fundo. Uma atribuição anterior ao fundo, por si só, não habilita leituras com escopo de fundo. O bancarizador identifica o crédito pelo idempotency_key usado no lance e pelo fundo que assinou o endosso. O crédito já deve estar atribuído exatamente a esse fundo; um crédito sem atribuição ou atribuído a outro fundo é rejeitado. A operação é idempotente. Registrar novamente o mesmo crédito e fundo retorna o estado durável em vez de criar uma segunda linha ou um segundo fato no feed. cedido começa como false e só se torna true por meio deste registro. ## OpenAPI ````yaml pt/openapi/v3-current/consignado.yaml put /v1/consignado/leilao/bid-submissions/cessao openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian Studio url: https://lerian.studio description: >- Superfície OpenAPI 3.1 para Lerian Consignado — Dataprev. o API cobre credenciais tenant e configuração de rede, margem do trabalhador, leilões e licitações de empréstimos, registro e ciclo de vida do contrato, confirmação de desembolso, portabilidade, refinanciamento, renegociação, garantias FGTS, reconciliação, fundos, atribuições, uso, rendimento e assinaturas de eventos. o material secreto é gravado no armazenamento secreto tenant e nunca é devolvido por nenhuma operação. 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: >- Custódia de credenciais do Dataprev e configuração pública do rail por tenant (upload, status, rotação, revogação, código do solicitante e URL base do portal do trabalhador) name: Credentials - description: >- Uso do gateway consignado no escopo do tenant: agregação de unidades faturáveis ​​com preço por competência name: Consignado Usage - description: >- Per-tenant plano de controle de assinatura do streaming-hub (listar, criar, obter, girar, revogar e testar a entrega) name: Subscriptions - description: >- Superfície folha de pagamento da rail Dataprev: leituras de saldo e autorização FGTS, execução de garantias FGTS, suspensão de contrato, reativação e alteração de prazo, documentos contratuais próprios da rede e leituras sob demanda de transações, escriturações, repasses e rescisões trabalhistas name: Consignado Rail - description: >- Superfície de comando da rede síncrona: as operações que um bancarizador sem o credor realizam sobre HTTP. cada um compartilha sua implementação de comando com o gatilho de evento de credor equivalente. name: Consignado Rail Commands - description: >- Confirmação de desembolso de propriedade do gateway: um banco cliente registrando o dinheiro que ALREADY pagou a um trabalhador. ele não cruza nenhuma fronteira governamental e não representa nenhuma operação Dataprev. name: Consignado Disbursement - description: > Taxa de transferência da rail Dataprev de saída de autoatendimento per-tenant: leia e defina o próprio requests-per-second deste tenant, incluindo uma pausa deliberada em zero name: Consignado Throughput paths: /v1/consignado/leilao/bid-submissions/cessao: put: tags: - Consignado Cessão summary: Registar uma cessão de crédito ao seu fundo atribuído description: >- Registra a cessão de um crédito e estabelece o limite de propriedade do fundo. Uma atribuição anterior ao fundo, por si só, não habilita leituras com escopo de fundo. O bancarizador identifica o crédito pelo idempotency_key usado no lance e pelo fundo que assinou o endosso. O crédito já deve estar atribuído exatamente a esse fundo; um crédito sem atribuição ou atribuído a outro fundo é rejeitado. A operação é idempotente. Registrar novamente o mesmo crédito e fundo retorna o estado durável em vez de criar uma segunda linha ou um segundo fato no feed. cedido começa como false e só se torna true por meio deste registro. operationId: registerConsignadoCessao requestBody: content: application/json: schema: $ref: '#/components/schemas/CessaoRegistrationRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/CessaoRegistrationResponse' description: OK '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Bad Request '401': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Unauthorized '403': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Forbidden '404': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Not Found '409': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Conflict '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 '501': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Not Implemented '503': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Service Unavailable security: - BearerAuth: [] components: schemas: CessaoRegistrationRequest: additionalProperties: false properties: fundo_ref: description: >- The fund this credit was ceded to. D-FUND-REF-OPAQUE: matched byte for byte against the credit's own attribution — no trim, case fold, or normalization. examples: - ' Fundo: Árvore/Classe A — série № 7 ' type: string idempotency_key: description: >- The credit's own business key — the SAME idempotency_key the bid was submitted and accepted under. Bounded at 128 CHARACTERS, the same unit the bid submission surface and its database CHECK already use — never bytes, which a multibyte key would reach first. examples: - idem-bid-2026-08-12-0001 maxLength: 128 minLength: 1 type: string required: - idempotency_key - fundo_ref type: object CessaoRegistrationResponse: additionalProperties: false properties: cedido: description: >- Always true on a successful response: cedido is fail-closed, and this operation only ever succeeds by making it true. type: boolean cedido_at: description: When the cessão was durably registered, strict RFC 3339 UTC. examples: - '2026-08-12T12:00:00Z' type: string fundo_ref: description: The fund this credit is ceded to. type: string required: - fundo_ref - cedido - cedido_at 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 ````