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

# Disparar una conciliación manual (admin)

> Dispara una ejecución de conciliación manual para la institución resuelta y devuelve el handle de la ejecución. scope selecciona el conjunto (monitoring_orders por defecto, all_pending, specific_order); orderId es obligatorio para specific_order y se rechaza (422) para cualquier otro scope. HTTP 200 significa que la ejecución fue CREADA e intentada de forma síncrona — NO significa que la conciliación tuvo éxito: una ejecución puede finalizar FAILED (por ejemplo cuando el conector no puede resolverse) y aun así devolver 200 con ordersScheduled=0. Consulta el estado de la ejecución vía GET /v1/admin/reconciliation para conocer el resultado terminal. jobId es el id de la ejecución; ordersScheduled es el número de órdenes que esta ejecución concilió. La institución se deriva de la identidad de la solicitud validada, nunca del payload.



## OpenAPI

````yaml es/openapi/v3-current/sisbajud.yaml post /v1/admin/reconciliation/trigger
openapi: 3.0.3
info:
  title: Lerian SISBAJUD API
  description: >-
    API de Lerian SISBAJUD — el rail del lado del participante que integra la
    institución con el sistema SISBAJUD (Sistema de Busca de Ativos do Poder
    Judiciário) del Banco Central do Brasil para el bloqueo y desbloqueo
    judicial de activos. Cubre la administración de órdenes judiciales, la
    gestión de archivos de remesa y de retorno, la conciliación, el monitoreo de
    SLA, las solicitudes de titulares de datos LGPD y la configuración por
    institución y las credenciales de conector.
  version: v1.0.0
servers:
  - url: https://sisbajud.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: >-
      Operaciones administrativas sobre órdenes judiciales: listado y detalle,
      reprocesamiento de órdenes fallidas, acceso a archivos de remesa y de
      retorno, ejecuciones y estado de conciliación, monitoreo de riesgo de SLA,
      estadísticas de procesamiento, verificación del registro de auditoría,
      resúmenes de sujetos entre organizaciones y solicitudes y justificaciones
      de titulares de datos LGPD.
  - name: Institution
    description: >-
      Configuración por institución y credenciales de conector: upsert de
      configuración con aprovisionamiento del conjunto de claves de
      tokenización, lectura segura de la configuración y registro y rotación de
      credenciales de conector salientes.
paths:
  /v1/admin/reconciliation/trigger:
    post:
      tags:
        - Admin
      summary: Disparar una conciliación manual (admin)
      description: >-
        Dispara una ejecución de conciliación manual para la institución
        resuelta y devuelve el handle de la ejecución. scope selecciona el
        conjunto (monitoring_orders por defecto, all_pending, specific_order);
        orderId es obligatorio para specific_order y se rechaza (422) para
        cualquier otro scope. HTTP 200 significa que la ejecución fue CREADA e
        intentada de forma síncrona — NO significa que la conciliación tuvo
        éxito: una ejecución puede finalizar FAILED (por ejemplo cuando el
        conector no puede resolverse) y aun así devolver 200 con
        ordersScheduled=0. Consulta el estado de la ejecución vía GET
        /v1/admin/reconciliation para conocer el resultado terminal. jobId es el
        id de la ejecución; ordersScheduled es el número de órdenes que esta
        ejecución concilió. La institución se deriva de la identidad de la
        solicitud validada, nunca del payload.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/http.TriggerReconciliationRequest'
        description: Reconciliation trigger options
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.TriggerReconciliationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/http.AdminErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    http.TriggerReconciliationRequest:
      properties:
        orderId:
          format: uuid
          type: string
        organizationId:
          format: uuid
          type: string
        scope:
          enum:
            - monitoring_orders
            - all_pending
            - specific_order
          type: string
      type: object
    http.TriggerReconciliationResponse:
      properties:
        jobId:
          format: uuid
          type: string
        ordersScheduled:
          type: integer
        triggeredAt:
          type: string
      type: object
    http.AdminErrorResponse:
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        message:
          type: string
        title:
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: 'Bearer token authentication (format: "Bearer {token}")'
      in: header
      name: Authorization
      type: apiKey

````