> ## 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 Conciliação Completa

> Dispara a conciliação completa para todos os tipos de chave que estão atualmente fora de sincronia.

Este endpoint detecta quais tipos de chave têm o status OUT_OF_SYNC e solicita
arquivos CID do BTG para cada um deles. O processamento real da conciliação
ocorre de forma assíncrona via webhooks quando os arquivos ficam disponíveis.

**Códigos de resposta:**
- **202 Accepted**: Um ou mais jobs de conciliação foram criados
- **200 OK**: Todos os tipos de chave já estão sincronizados (nenhum job criado)



## OpenAPI

````yaml pt/openapi/v3-current/indirect-pix.yaml POST /v1/dict/reconciliation/full
openapi: 3.0.3
info:
  title: Plugin BR Pix Indireto - API Completa
  description: |
    API completa para o sistema brasileiro de pagamentos instantâneos Pix,
    incluindo operações de dicionário de chaves Pix, geração/decodificação de
    QR Code, transações e limites de transações.
  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 Conciliação Completa
      description: >-
        Dispara a conciliação completa para todos os tipos de chave que estão
        atualmente fora de sincronia.


        Este endpoint detecta quais tipos de chave têm o status OUT_OF_SYNC e
        solicita

        arquivos CID do BTG para cada um deles. O processamento real da
        conciliação

        ocorre de forma assíncrona via webhooks quando os arquivos ficam
        disponíveis.


        **Códigos de resposta:**

        - **202 Accepted**: Um ou mais jobs de conciliação foram criados

        - **200 OK**: Todos os tipos de chave já estão sincronizados (nenhum job
        criado)
      responses:
        '200':
          description: Todos os tipos de chave sincronizados
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FullReconciliationOutput'
        '202':
          description: Jobs de conciliação criados
          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: Resposta da operação de início da reconciliação completa.
      properties:
        jobs:
          description: Jobs contém informações sobre os jobs criados.
          items:
            $ref: '#/components/schemas/FullReconciliationJobInfo'
          type: array
        message:
          description: "Message fornece detalhes sobre a operação.\n\t@Example\tCreated 2 full reconciliation jobs"
          example: Created 2 full reconciliation jobs
          type: string
        skippedKeyTypes:
          description: SkippedKeyTypes lista os tipos de chave que foram ignorados.
          items:
            $ref: '#/components/schemas/SkippedKeyTypeInfo'
          type: array
      type: object
    ErrorFormat:
      type: object
      description: A mensagem de erro da resposta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Um identificador único e estável para o erro.
        title:
          type: string
          description: Um breve resumo do problema.
        message:
          type: string
          description: Orientação detalhada para resolver o erro.
    FullReconciliationJobInfo:
      description: Informações sobre um job de reconciliação completa criado.
      properties:
        createdAt:
          description: "CreatedAt é quando o job foi criado.\n\t@Example\t2024-01-15T10:30:00Z"
          example: '2024-01-15T10:30:00Z'
          type: string
        expiresAt:
          description: "ExpiresAt é quando o status WAITING_FILE expira.\n\t@Example\t2024-01-15T12:30:00Z"
          example: '2024-01-15T12:30:00Z'
          type: string
        fileRequestId:
          description: "FileRequestID é o ID retornado pelo BTG para a solicitação do arquivo.\n\t@Example\t770e8400-e29b-41d4-a716-446655440002"
          example: 770e8400-e29b-41d4-a716-446655440002
          type: string
        jobId:
          description: "JobID é o ID do job criado.\n\t@Example\t550e8400-e29b-41d4-a716-446655440000"
          example: 550e8400-e29b-41d4-a716-446655440000
          type: string
        keyType:
          description: "KeyType é o tipo de chave PIX para este job.\n\t@Example\tCPF"
          example: CPF
          type: string
        status:
          description: "Status é o status inicial do job.\n\t@Example\tWAITING_FILE"
          example: WAITING_FILE
          type: string
      type: object
    SkippedKeyTypeInfo:
      description: Informações sobre um tipo de chave que foi ignorado.
      properties:
        keyType:
          description: "KeyType é o tipo de chave PIX.\n\t@Example\tCNPJ"
          example: CNPJ
          type: string
        reason:
          description: "Reason explica por que o tipo de chave foi ignorado.\n\t@Example\tAlready synchronized (SYNCED)"
          example: Already synchronized (SYNCED)
          type: string
        syncStatus:
          description: "SyncStatus é o status de sincronização atual deste tipo de chave.\n\t@Example\tSYNCED"
          example: SYNCED
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````