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

# Crear una operación de liquidación

> Envía una única operación de liquidación para su admisión. Idempotente mediante el encabezado Idempotency-Key.



## OpenAPI

````yaml es/openapi/v3-current/slc.yaml post /v1/operations
openapi: 3.0.3
info:
  title: Lerian SLC API
  description: >-
    API de Lerian SLC — el rail del lado del participante que conecta la
    institución con la liquidación de tarjetas por neto diferido SLC de Núclea.
    Cubre la admisión y el ciclo de vida de las operaciones de liquidación, las
    posiciones de compensación, el registro de participantes y arreglos, la
    recuperación de transmisión y la conectividad con Núclea, la importación de
    clave de firma BYOK Modelo A y los webhooks con alcance al tenant.
  version: v1.0.0
servers:
  - url: https://slc.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: Configuración del tenant y administración de cartas muertas.
  - name: Clearing
    description: >-
      Posiciones de compensación por neto diferido de la institución
      liquidadora.
  - name: Connectivity
    description: >-
      Drenajes de recuperación de transmisión, retransmisión y sondas de
      conectividad con Núclea.
  - name: Operations
    description: >-
      Admisión, ciclo de vida e historial de estados de las operaciones de
      liquidación.
  - name: Participants
    description: Registro de participantes del tenant.
  - name: Arrangements
    description: Arreglos de tarjeta y esquema por participante.
  - name: SigningKey
    description: Importación de clave de firma BYOK Modelo A para la firma de mensajes.
  - name: Webhooks
    description: Suscripciones de webhook con alcance al tenant, entregas y reenvío.
paths:
  /v1/operations:
    post:
      tags:
        - Operations
      summary: Crear una operación de liquidación
      description: >-
        Envía una única operación de liquidación para su admisión. Idempotente
        mediante el encabezado Idempotency-Key.
      operationId: createOperation
      parameters:
        - description: Idempotency key for safe retries
          in: header
          name: Idempotency-Key
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/http.CreateOperationRequest'
        description: Operation to create
        required: true
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.CreateOperationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    http.CreateOperationRequest:
      properties:
        arrangementCode:
          type: string
        authorizationCode:
          type: string
        brandCode:
          type: string
        creditorIspb:
          type: string
        currency:
          type: string
        domicileIfIspb:
          type: string
        dueDate:
          type: string
        establishmentCode:
          type: string
        externalId:
          type: string
        installmentNumber:
          type: integer
        installments:
          type: integer
        intakeMode:
          type: string
        metadata:
          additionalProperties: {}
          type: object
        operationType:
          type: string
        originalOperationId:
          description: >-
            OriginalOperationID identifies the operation a CANCELLATION targets
            (UUID).

            Mandatory for operationType=CANCELLATION, ignored otherwise.
          type: string
        participantId:
          type: string
        participantRole:
          type: string
        pvCode:
          description: >-
            PontoVenda (merchant/EC) identity for the ASLC027
            Grupo_ASLC027_PontoVenda.

            Required for CREDIT, enforced in the command use case (not via
            struct tags),

            because only CREDIT mandates the [1..1] PontoVenda identity.
            pvDocument is

            the merchant CPF/CNPJ — regulated PII; it is never logged in the
            clear.
          type: string
        pvDocument:
          type: string
        pvName:
          type: string
        pvPersonType:
          type: string
        reasonCategory:
          description: >-
            ReasonCategory is the numeric <MotvCanc> cancellation reason (OP107
            §11.3.16),

            one of "1".."4". Mandatory for operationType=CANCELLATION, optional
            otherwise.

            Carried as a string on the wire so the nullable-text column and the
            value

            object stay symmetric; the 1..4 domain is enforced by the domain,
            not the XSD.
          type: string
        settlementIfIspb:
          type: string
        transactionDate:
          type: string
        value:
          type: integer
      required:
        - creditorIspb
        - domicileIfIspb
        - dueDate
        - externalId
        - installments
        - operationType
        - participantId
        - participantRole
        - value
      type: object
    http.CreateOperationResponse:
      properties:
        externalId:
          type: string
        id:
          type: string
        meta:
          $ref: '#/components/schemas/http.CreateOperationMeta'
        state:
          type: string
      type: object
    http.ErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object
    http.CreateOperationMeta:
      properties:
        requestId:
          type: string
        timestamp:
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````