Consultar totales del mes del RCV

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "description": "Mes AAAA-MM. Sin él, la respuesta trae todos los meses sincronizados y 'sincronizacion' llega null.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$"
    },
    "perspectiva": {
      "description": "compras = la empresa es el receptor; ventas = la empresa es el emisor.",
      "type": "string",
      "enum": [
        "compras",
        "ventas"
      ]
    },
    "tipoDte": {
      "description": "Tipo de documento: 39 boletas, 48 comprobantes de pago, …",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cursor": {
      "description": "Paginación: el valor que devolvió la respuesta anterior, tal cual.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Filas por página.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "totales": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "perspectiva": {
            "type": "string",
            "enum": [
              "compras",
              "ventas"
            ],
            "description": "compras = la empresa es el receptor; ventas = la empresa es el emisor."
          },
          "periodo": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}$",
            "description": "El mes del total, en formato AAAA-MM."
          },
          "estado": {
            "type": "string",
            "enum": [
              "registro",
              "pendiente",
              "no_incluir",
              "reclamado"
            ],
            "description": "La casilla del registro a la que pertenece el total. En ventas es siempre 'registro'."
          },
          "tipoDte": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Tipo de documento: 39 boleta electrónica, 48 comprobante de pago electrónico (pagos con tarjeta), entre otros que el SII informa sólo como total."
          },
          "nombreTipo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El nombre del tipo tal como lo escribe el SII. 'null' si no vino."
          },
          "cantidad": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Cuántos documentos suma el total del mes (por ejemplo, cuántas boletas). Es un conteo, no un folio."
          },
          "montoNeto": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Monto neto del mes, en pesos chilenos."
          },
          "montoIva": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "IVA del mes, en pesos chilenos."
          },
          "montoExento": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Monto exento del mes, en pesos chilenos."
          },
          "montoTotal": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Total del mes tal como lo informa el SII, en pesos chilenos. Úsalo tal cual: en los comprobantes de pago no siempre es la suma de neto, IVA y exento."
          },
          "sumable": {
            "type": "boolean",
            "description": "'true' si el total es una venta del mes que no repite ningún documento y se suma a las ventas de 'sii.rcv.consultar': hoy, las boletas (39) de ventas. 'false' en los comprobantes de pago con tarjeta (48): los informa el procesador del pago y pueden repetir ventas por las que la empresa también emitió boleta o factura, así que depende del caso: súmalos si la empresa no emite otro documento por esas ventas o si corrigió la duplicidad con una nota de crédito (la nota ya resta lo repetido); no los sumes si emitió boleta o factura y no corrigió nada. También 'false' en compras, en 'Otros aumenta/disminuye débito' (920 y 922) y en cualquier tipo que Connect todavía no ha medido: no los sumes sin revisar."
          },
          "fuente": {
            "type": "string",
            "enum": [
              "resumen",
              "historico"
            ],
            "description": "'resumen' = leído del resumen del RCV en la última sincronización; 'historico' = recuperado de un sync anterior al 2026-09-27."
          },
          "sincronizadoEn": {
            "type": "string",
            "description": "Cuándo se leyó este total del SII por última vez, en ISO 8601 UTC."
          }
        },
        "required": [
          "perspectiva",
          "periodo",
          "estado",
          "tipoDte",
          "nombreTipo",
          "cantidad",
          "montoNeto",
          "montoIva",
          "montoExento",
          "montoTotal",
          "sumable",
          "fuente",
          "sincronizadoEn"
        ],
        "additionalProperties": false
      },
      "description": "Un total por mes, perspectiva, estado y tipo. Cada total se actualiza cuando se sincroniza su período: el del mes en curso crece hasta que el mes cierra, y el de un mes cerrado cambia sólo si el SII lo corrige y ese período se vuelve a sincronizar. Nunca se repite un mismo total en dos filas."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "El cursor de la página siguiente, opaco. 'null' significa que no hay más filas; cualquier otro valor se reenvía tal cual en 'cursor' de la próxima llamada y nunca se construye a mano."
    },
    "sincronizacion": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "sincronizadoEn": {
              "type": "string",
              "description": "Cuándo terminó la última sincronización de este período, en ISO 8601 UTC. Es la frescura del dato que estás leyendo."
            },
            "completo": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "'true' = el período se cargó entero. 'false' = quedaron casillas sin traer. 'null' = se está cargando o no hay registro de ese intento."
            },
            "incompletos": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ],
              "description": "Cuántas casillas quedaron sin traer en esa sincronización. 'null' cuando no se puede saber."
            },
            "fueraDeVentana": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ],
              "description": "Sólo aplica a guías: cuántas direcciones cayeron fuera de la ventana de 6 meses que el SII conserva. Un 0 dice que se verificó y no aplicó; 'null', que no aplica o no se conoce."
            },
            "perspectivasFallidas": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "perspectiva": {
                    "type": "string",
                    "enum": [
                      "emitidas",
                      "recibidas"
                    ],
                    "description": "Qué lado falló: 'emitidas' son las que emitió esta empresa y 'recibidas' las que le emitieron."
                  },
                  "code": {
                    "type": "string",
                    "description": "El código del catálogo de errores que explica por qué falló ese lado. Decide por el código, nunca por el texto."
                  }
                },
                "required": [
                  "perspectiva",
                  "code"
                ],
                "additionalProperties": false
              },
              "description": "Qué direcciones fallaron en esa sincronización, con su código de error. La pueblan las guías de despacho y las boletas de honorarios; para los demás llega vacía."
            }
          },
          "required": [
            "sincronizadoEn",
            "completo",
            "incompletos",
            "fueraDeVentana",
            "perspectivasFallidas"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Completitud del último sync del período consultado. Con 'periodo', 'null' y una lista vacía significa que ese mes no está cargado: dilo, no lo informes como cero (revisa 'historico' en 'conexiones.estado.consultar'). Sin 'periodo' siempre es 'null': usa ese bloque para saber qué meses hay."
    }
  },
  "required": [
    "totales",
    "cursor",
    "sincronizacion"
  ],
  "additionalProperties": false
}