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

# Iniciar conciliación completa

> Activa la conciliación completa para todos los tipos de clave que actualmente están fuera de sincronización.

Este endpoint detecta qué tipos de clave tienen estado OUT_OF_SYNC y solicita
archivos CID a BTG para cada uno de ellos. El procesamiento real de la conciliación
ocurre de forma asíncrona mediante webhooks cuando los archivos están disponibles.

**Códigos de respuesta:**
- **202 Accepted**: Se crearon uno o más trabajos de conciliación
- **200 OK**: Todos los tipos de clave ya están sincronizados (no se crearon trabajos)



## OpenAPI

````yaml es/openapi/v3-current/indirect-pix.yaml POST /v1/dict/reconciliation/full
openapi: 3.0.3
info:
  title: Plugin BR Pix Indirect - API completa
  description: |
    API completa para el sistema de pagos instantáneos Pix de Brasil, que
    incluye operaciones del diccionario de claves Pix, generación/decodificación
    de códigos QR, transacciones y límites transaccionales.
  version: 1.0.0
servers:
  - url: https://plugin-pix-indirect.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/dict/reconciliation/full:
    post:
      tags:
        - Reconciliation API
      summary: Iniciar conciliación completa
      description: >-
        Activa la conciliación completa para todos los tipos de clave que
        actualmente están fuera de sincronización.


        Este endpoint detecta qué tipos de clave tienen estado OUT_OF_SYNC y
        solicita

        archivos CID a BTG para cada uno de ellos. El procesamiento real de la
        conciliación

        ocurre de forma asíncrona mediante webhooks cuando los archivos están
        disponibles.


        **Códigos de respuesta:**

        - **202 Accepted**: Se crearon uno o más trabajos de conciliación

        - **200 OK**: Todos los tipos de clave ya están sincronizados (no se
        crearon trabajos)
      responses:
        '200':
          description: Todos los tipos de clave sincronizados
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FullReconciliationOutput'
        '202':
          description: Trabajos de conciliación creados
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FullReconciliationOutput'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
      deprecated: false
      security:
        - bearerAuth: []
components:
  schemas:
    FullReconciliationOutput:
      description: Respuesta de la operación de inicio de conciliación completa.
      properties:
        jobs:
          description: Jobs contiene información sobre los trabajos creados.
          items:
            $ref: '#/components/schemas/FullReconciliationJobInfo'
          type: array
        message:
          description: "Message proporciona detalles sobre la operación.\n\t@Example\tCreated 2 full reconciliation jobs"
          example: Created 2 full reconciliation jobs
          type: string
        skippedKeyTypes:
          description: SkippedKeyTypes lista los tipos de clave que se omitieron.
          items:
            $ref: '#/components/schemas/SkippedKeyTypeInfo'
          type: array
      type: object
    ErrorFormat:
      type: object
      description: El mensaje de error de la respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
    FullReconciliationJobInfo:
      description: Información sobre un trabajo de conciliación completa creado.
      properties:
        createdAt:
          description: "CreatedAt es el momento en que se creó el trabajo.\n\t@Example\t2024-01-15T10:30:00Z"
          example: '2024-01-15T10:30:00Z'
          type: string
        expiresAt:
          description: "ExpiresAt es el momento en que expira el estado WAITING_FILE.\n\t@Example\t2024-01-15T12:30:00Z"
          example: '2024-01-15T12:30:00Z'
          type: string
        fileRequestId:
          description: "FileRequestID es el ID devuelto por BTG para la solicitud de archivo.\n\t@Example\t770e8400-e29b-41d4-a716-446655440002"
          example: 770e8400-e29b-41d4-a716-446655440002
          type: string
        jobId:
          description: "JobID es el ID del trabajo creado.\n\t@Example\t550e8400-e29b-41d4-a716-446655440000"
          example: 550e8400-e29b-41d4-a716-446655440000
          type: string
        keyType:
          description: "KeyType es el tipo de clave PIX para este trabajo.\n\t@Example\tCPF"
          example: CPF
          type: string
        status:
          description: "Status es el estado inicial del trabajo.\n\t@Example\tWAITING_FILE"
          example: WAITING_FILE
          type: string
      type: object
    SkippedKeyTypeInfo:
      description: Información sobre un tipo de clave que se omitió.
      properties:
        keyType:
          description: "KeyType es el tipo de clave PIX.\n\t@Example\tCNPJ"
          example: CNPJ
          type: string
        reason:
          description: "Reason explica por qué se omitió el tipo de clave.\n\t@Example\tAlready synchronized (SYNCED)"
          example: Already synchronized (SYNCED)
          type: string
        syncStatus:
          description: "SyncStatus es el estado de sincronización actual de este tipo de clave.\n\t@Example\tSYNCED"
          example: SYNCED
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````