> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar resumen de libro de compras/ventas SII

> Obtiene el resumen de libro de compras y ventas (getResumen del SII) para una entidad y período. Es data agregada por tipo de documento y operación (COMPRA/VENTA), no el detalle línea a línea. Solo devuelve datos para entidades habilitadas explícitamente para este scrape (ver `is_enabled` en la respuesta); si la entidad no está habilitada, `results` viene vacío.



## OpenAPI

````yaml api-reference/openapi-v2.json GET /book-summaries/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /book-summaries/:
    get:
      tags:
        - Libros SII
      summary: Listar resumen de libro de compras/ventas SII
      description: >-
        Obtiene el resumen de libro de compras y ventas (getResumen del SII)
        para una entidad y período. Es data agregada por tipo de documento y
        operación (COMPRA/VENTA), no el detalle línea a línea. Solo devuelve
        datos para entidades habilitadas explícitamente para este scrape (ver
        `is_enabled` en la respuesta); si la entidad no está habilitada,
        `results` viene vacío.
      operationId: listBookSummaries_v2
      parameters:
        - name: master_entity_id
          in: query
          required: true
          description: ID de la entidad maestra. El public ID de la entidad (`ment_...`).
          schema:
            type: string
            example: ment_4829301923847
        - name: period
          in: query
          required: true
          description: Período a consultar, formato YYYYMM.
          schema:
            type: string
            example: '202603'
        - name: operation
          in: query
          required: false
          description: 'Filtra por operación: COMPRA o VENTA. Si se omite, devuelve ambas.'
          schema:
            type: string
            enum:
              - COMPRA
              - VENTA
      responses:
        '200':
          description: Resumen de libro para la entidad y período consultado
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/BookSummaryItem'
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                        nullable: true
                      page_size:
                        type: integer
                        nullable: true
                      total:
                        type: integer
                      total_pages:
                        type: integer
                        nullable: true
                      is_enabled:
                        type: boolean
                        description: >-
                          true si la entidad tiene habilitado el scrape de
                          resumen de libros (BOOK_SUMMARY). Si es false, `data`
                          estará vacío aunque el período sea válido.
                  links:
                    type: object
                    properties:
                      next:
                        type: string
                        nullable: true
                      prev:
                        type: string
                        nullable: true
        '400':
          description: >-
            master_entity_id faltante o inválido, o period faltante o con
            formato inválido
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: period is required in YYYYMM format.
        '403':
          description: >-
            Sin acceso a la entidad, o la API key no tiene el permiso
            book_summary:access
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Access denied.
      security:
        - apiKeyAuth: []
components:
  schemas:
    BookSummaryItem:
      type: object
      properties:
        id:
          type: string
          description: ID de la fila de resumen
          example: bosu_5e8d2c9b7a1f4
        period:
          type: string
          description: Período YYYYMM
          example: '202603'
        operation:
          type: string
          enum:
            - COMPRA
            - VENTA
        dte_type_code:
          type: integer
          nullable: true
          description: Código de tipo de documento SII (33, 34, 46, 61, etc.)
        dte_type_name:
          type: string
          description: Nombre del tipo de documento
        total_docs:
          type: integer
          description: Cantidad de documentos en esta línea del resumen
        net_amount:
          type: integer
          description: Monto neto
        exempt_amount:
          type: integer
          description: Monto exento
        vat_amount:
          type: integer
          description: Monto IVA
        total_amount:
          type: integer
          description: Monto total
        scraped_at:
          type: string
          format: date-time
          description: Fecha/hora en que se obtuvo este resumen desde el SII
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.