Buscar contribuyente en el SII

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "rut": {
      "type": "string",
      "description": "RUT del contribuyente, con dígito verificador. Acepta puntos y guion."
    },
    "incluirDomicilio": {
      "default": true,
      "description": "false para no leer la nómina de domicilios. Por defecto se incluye.",
      "type": "boolean"
    }
  },
  "required": [
    "rut"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "rut": {
      "type": "string",
      "description": "RUT consultado, canonizado como cuerpo-DV."
    },
    "estado": {
      "type": "string",
      "enum": [
        "puede_emitir",
        "sin_inicio_actividades",
        "solo_honorarios",
        "rut_inexistente",
        "no_verificable"
      ],
      "description": "puede_emitir: tiene inicio de actividades en primera categoría. sin_inicio_actividades: el SII lo reconoce sin inicio de actividades. solo_honorarios: no tiene primera categoría; no le impide recibir documentos. rut_inexistente: el SII no reconoce el RUT. no_verificable: el SII no respondió o respondió algo ilegible; NO significa que el RUT no exista, reintenta más tarde."
    },
    "nombre": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Razón social o nombre que informa el SII. null con rut_inexistente o no_verificable."
    },
    "fechaInicioActividades": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "x-emisso-formato": "AAAA-MM-DD",
      "description": "El inicio de actividades en formato AAAA-MM-DD, o null si no vino o no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
    },
    "giros": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "codigo": {
            "type": "string",
            "description": "Código de actividad económica del SII. Es texto: conserva los ceros a la izquierda."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripción de la actividad, tal como la informa el SII. Sirve como giro del receptor de un documento, que admite hasta 40 caracteres: muchas descripciones son más largas y hay que abreviarlas antes de emitir."
          },
          "categoriaTributaria": {
            "type": "string",
            "description": "Categoría tributaria tal como la informa el SII: \"1\" primera categoría, \"2\" segunda."
          },
          "afectoIva": {
            "type": "boolean",
            "description": "true si la actividad está afecta a IVA."
          },
          "fechaInicio": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "x-emisso-formato": "AAAA-MM-DD",
            "description": "El inicio de esta actividad en formato AAAA-MM-DD, o null si no vino o no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
          }
        },
        "required": [
          "codigo",
          "descripcion",
          "categoriaTributaria",
          "afectoIva",
          "fechaInicio"
        ],
        "additionalProperties": false
      },
      "description": "Actividades económicas informadas, afectas y exentas. Puede venir vacío. Elige una como giro del receptor."
    },
    "domicilio": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "direccion": {
              "type": "string",
              "description": "Dirección vigente publicada en la nómina de personas jurídicas del SII, con número, bloque y departamento. Puede superar los 70 caracteres que admite la dirección del receptor de un DTE: revísala antes de emitir."
            },
            "comuna": {
              "type": "string",
              "description": "Comuna de esa dirección. Puede superar los 20 caracteres que admite la comuna del receptor de un DTE."
            },
            "fechaPublicacion": {
              "type": "string",
              "description": "Instante ISO 8601 UTC en que el SII publicó la nómina de la que sale este domicilio. No es la fecha de esta consulta ni confirma que la empresa no se haya mudado después."
            }
          },
          "required": [
            "direccion",
            "comuna",
            "fechaPublicacion"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Domicilio publicado por el SII, o null si no se pidió, si el RUT no está en la nómina (no cubre personas naturales) o si no se pudo leer. La ausencia no dice nada sobre la existencia del RUT."
    }
  },
  "required": [
    "rut",
    "estado",
    "nombre",
    "fechaInicioActividades",
    "giros",
    "domicilio"
  ],
  "additionalProperties": false
}