> ## 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 uma conciliação manual (admin)

> Dispara uma execução de conciliação manual para a instituição resolvida e retorna o handle da execução. scope seleciona o conjunto (monitoring_orders por padrão, all_pending, specific_order); orderId é obrigatório para specific_order e é recusado (422) para qualquer outro scope. HTTP 200 significa que a execução foi CRIADA e tentada de forma síncrona — NÃO significa que a conciliação teve sucesso: uma execução pode finalizar FAILED (por exemplo quando o conector não pode ser resolvido) e ainda assim retornar 200 com ordersScheduled=0. Consulte o status da execução via GET /v1/admin/reconciliation para saber o resultado terminal. jobId é o id da execução; ordersScheduled é o número de ordens que esta execução conciliou. A instituição é derivada da identidade da solicitação validada, nunca do payload.



## OpenAPI

````yaml pt/openapi/v3-current/sisbajud.yaml post /v1/admin/reconciliation/trigger
openapi: 3.0.3
info:
  title: Lerian SISBAJUD API
  description: >-
    API do Lerian SISBAJUD — o rail do lado do participante que integra a
    instituição ao sistema SISBAJUD (Sistema de Busca de Ativos do Poder
    Judiciário) do Banco Central do Brasil para o bloqueio e desbloqueio
    judicial de ativos. Abrange a administração de ordens judiciais, a gestão de
    arquivos de remessa e de retorno, a conciliação, o monitoramento de SLA, as
    solicitações de titulares de dados LGPD e a configuração por instituição e
    as credenciais de conector.
  version: v1.0.0
servers:
  - url: https://sisbajud.sandbox.lerian.net
security: []
tags:
  - name: Admin
    description: >-
      Operações administrativas sobre ordens judiciais: listagem e detalhe,
      reprocessamento de ordens com falha, acesso a arquivos de remessa e de
      retorno, execuções e status de conciliação, monitoramento de risco de SLA,
      estatísticas de processamento, verificação da trilha de auditoria, resumos
      de titulares entre organizações e solicitações e justificativas de
      titulares de dados LGPD.
  - name: Institution
    description: >-
      Configuração por instituição e credenciais de conector: upsert de
      configuração com provisionamento do conjunto de chaves de tokenização,
      leitura segura da configuração e registro e rotação de credenciais de
      conector de saída.
paths:
  /v1/admin/reconciliation/trigger:
    post:
      tags:
        - Admin
      summary: Disparar uma conciliação manual (admin)
      description: >-
        Dispara uma execução de conciliação manual para a instituição resolvida
        e retorna o handle da execução. scope seleciona o conjunto
        (monitoring_orders por padrão, all_pending, specific_order); orderId é
        obrigatório para specific_order e é recusado (422) para qualquer outro
        scope. HTTP 200 significa que a execução foi CRIADA e tentada de forma
        síncrona — NÃO significa que a conciliação teve sucesso: uma execução
        pode finalizar FAILED (por exemplo quando o conector não pode ser
        resolvido) e ainda assim retornar 200 com ordersScheduled=0. Consulte o
        status da execução via GET /v1/admin/reconciliation para saber o
        resultado terminal. jobId é o id da execução; ordersScheduled é o número
        de ordens que esta execução conciliou. A instituição é derivada da
        identidade da solicitação validada, nunca do 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

````