{
  "version": 1,
  "title": "Peru legal-entity taxpayer registry",
  "description": "A taxpayer registration and fiscal-address components.",
  "publisher": "SUNAT, Peru",
  "homepage": "https://www.sunat.gob.pe/descargaPRR/mrc137_padron_reducido.html",
  "coverage": "Legal-entity RUCs beginning with 20 in the reduced taxpayer padron.",
  "record": "A taxpayer registration and fiscal-address components.",
  "identifier": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.",
  "license": {
    "status": "not_verified",
    "name": "No source-specific reuse license verified in this contract."
  },
  "limitations": [
    "departamento is an apartment/unit component, not geography. Taxpayer status and fiscal-address condition are separate."
  ],
  "fields": {
    "razon_social": {
      "description": "Registered legal name.",
      "meaning": "text"
    },
    "estado": {
      "description": "Publisher status; interpret in the context of this dataset.",
      "meaning": "text"
    },
    "condicion": {
      "description": "Published fiscal-address condition; distinct from taxpayer status.",
      "meaning": "text"
    },
    "ubigeo": {
      "description": "Six-digit INEI district code; retain leading zeros.",
      "meaning": "code"
    },
    "tipo_via": {
      "description": "Published street-type abbreviation.",
      "meaning": "text"
    },
    "nombre_via": {
      "description": "Published street name.",
      "meaning": "text"
    },
    "codigo_zona": {
      "description": "Published zone-type abbreviation.",
      "meaning": "text"
    },
    "tipo_zona": {
      "description": "Published zone name.",
      "meaning": "text"
    },
    "numero": {
      "description": "External street number; not a count.",
      "meaning": "text"
    },
    "interior": {
      "description": "Interior/unit address component.",
      "meaning": "text"
    },
    "lote": {
      "description": "Address lot component.",
      "meaning": "text"
    },
    "departamento": {
      "description": "Apartment/unit address component; not the geographic department.",
      "meaning": "text"
    },
    "manzana": {
      "description": "Address block component.",
      "meaning": "text"
    },
    "kilometro": {
      "description": "Address kilometer marker; not a measured company distance.",
      "meaning": "text"
    }
  },
  "evidence": [
    "docs/sources/pe-sunat-padron.md"
  ],
  "source": "pe-sunat-padron",
  "country": "pe",
  "kind": "entity",
  "served": true,
  "schedule": "daily",
  "cardinality": "one",
  "identifier_name": "ruc",
  "identifier_pattern": "^\\d{11}$",
  "normalization": null,
  "observation_field": null,
  "vocabularies": {
    "estado": {
      "id": "pe.sunat.tax_status.v1",
      "scope": "TAX_REGISTRATION",
      "empty_policy": "reject",
      "values": {
        "ACTIVO": {
          "code": "ACTIVE",
          "label_en": "Active",
          "explanation_en": "SUNAT reports the taxpayer registration as active."
        },
        "BAJA DEFINITIVA": {
          "code": "CANCELLED",
          "label_en": "Definitively cancelled",
          "explanation_en": "SUNAT reports the taxpayer registration as definitively cancelled."
        },
        "BAJA DE OFICIO": {
          "code": "CANCELLED",
          "label_en": "Cancelled by SUNAT",
          "explanation_en": "SUNAT reports that it cancelled the taxpayer registration on its own initiative."
        },
        "BAJA NO ACTIV. SISEV": {
          "code": "CANCELLED",
          "label_en": "Cancelled for no activity in SISEV",
          "explanation_en": "SUNAT reports cancellation because no activity was recorded in the SISEV verification system."
        },
        "BAJA PROVISIONAL": {
          "code": "SUSPENDED",
          "label_en": "Provisionally cancelled",
          "explanation_en": "SUNAT reports the taxpayer registration as provisionally cancelled."
        },
        "BAJA PROV. POR OFICI": {
          "code": "SUSPENDED",
          "label_en": "Provisionally cancelled by SUNAT",
          "explanation_en": "SUNAT reports that it provisionally cancelled the taxpayer registration on its own initiative."
        },
        "BAJA MULT.INSCR. Y O": {
          "code": "CANCELLED",
          "label_en": "Cancelled due to multiple registrations or another cause",
          "explanation_en": "SUNAT reports cancellation due to multiple registrations or another official cause."
        },
        "SUSPENSION TEMPORAL": {
          "code": "SUSPENDED",
          "label_en": "Temporarily suspended",
          "explanation_en": "SUNAT reports the taxpayer registration as temporarily suspended."
        },
        "ANUL.PROVI.-ACTO ILI": {
          "code": "SUSPENDED",
          "label_en": "Provisionally annulled for an unlawful act",
          "explanation_en": "SUNAT reports a provisional annulment associated with an unlawful act."
        },
        "ANULACION - ACTO ILI": {
          "code": "CANCELLED",
          "label_en": "Annulled for an unlawful act",
          "explanation_en": "SUNAT reports annulment associated with an unlawful act."
        },
        "ANULACION - ERROR SU": {
          "code": "CANCELLED",
          "label_en": "Annulled due to a SUNAT error",
          "explanation_en": "SUNAT reports that the taxpayer registration was annulled due to an authority error."
        },
        "INHABILITADO-VENT.UN": {
          "code": "SUSPENDED",
          "label_en": "Disabled in the single-window system",
          "explanation_en": "SUNAT reports the taxpayer as disabled in the single-window system."
        },
        "NUM. INTERNO IDENTIF": {
          "code": "UNKNOWN",
          "label_en": "Internal identification number",
          "explanation_en": "SUNAT classifies this record as an internal identification number; no active-state conclusion is made."
        },
        "OTROS OBLIGADOS": {
          "code": "UNKNOWN",
          "label_en": "Other obligated party",
          "explanation_en": "SUNAT classifies this record as another type of obligated party; no active-state conclusion is made."
        },
        "PENDIENTE DE INI. DE": {
          "code": "PENDING",
          "label_en": "Pending start of activities",
          "explanation_en": "SUNAT reports that the taxpayer is pending the start of activities."
        }
      }
    }
  },
  "allowed_values": {
    "condicion": [
      "-",
      "HABIDO",
      "NO APLICABLE",
      "NO HABIDO",
      "NO HALLADO",
      "NO HALLADO CERRADO",
      "NO HALLADO DESTINATA",
      "NO HALLADO FALLECIO",
      "NO HALLADO NO EXISTE",
      "NO HALLADO NRO.PUERT",
      "NO HALLADO OTROS MOT",
      "NO HALLADO RECHAZADO",
      "NO HALLADO SE MUDO D",
      "PENDIENTE",
      "POR VERIFICAR"
    ]
  },
  "attribution": "Source: SUNAT, Peru. https://www.sunat.gob.pe/descargaPRR/mrc137_padron_reducido.html.",
  "fingerprint": "daea838a03ce143ee874125f304ac298b899c9aa791905454391533e71fcfe7d"
}