{
  "schema_version": 1,
  "actualizado": "2026-08-03",
  "fuente": "SUNAT — información pública de declaraciones aduaneras de importación",
  "campos": [
    {
      "nombre": "schema_version",
      "etiqueta": "Versión del esquema",
      "tipo": "entero",
      "unidad": "",
      "origen": "sistema",
      "nulos": "nunca",
      "advertencias": "Sube solo con cambios incompatibles.",
      "ejemplo": "1",
      "descripcion": "Versión del contrato de exportación."
    },
    {
      "nombre": "consulta",
      "etiqueta": "Consulta aplicada",
      "tipo": "objeto",
      "unidad": "",
      "origen": "petición",
      "nulos": "nunca",
      "advertencias": "Reproduce el filtro exacto de la URL.",
      "ejemplo": "{\"ambito\": \"partida\", \"clave\": \"8517130000\"}",
      "descripcion": "El filtro con el que se generó el fichero: mismo universo que la página."
    },
    {
      "nombre": "generado",
      "etiqueta": "Fecha de generación",
      "tipo": "fecha ISO",
      "unidad": "",
      "origen": "sistema",
      "nulos": "nunca",
      "advertencias": "",
      "ejemplo": "2026-08-03",
      "descripcion": "Cuándo se produjo el fichero."
    },
    {
      "nombre": "ruc",
      "etiqueta": "RUC",
      "tipo": "texto (11 dígitos)",
      "unidad": "",
      "origen": "SUNAT",
      "nulos": "nunca",
      "advertencias": "Solo personas jurídicas.",
      "ejemplo": "20507398210",
      "descripcion": "Registro Único de Contribuyente de la empresa."
    },
    {
      "nombre": "razon_social",
      "etiqueta": "Razón social",
      "tipo": "texto",
      "unidad": "",
      "origen": "SUNAT",
      "nulos": "nunca",
      "advertencias": "Tal como aparece en la declaración.",
      "ejemplo": "CROSLAND MOTOS S.A.C.",
      "descripcion": "Nombre legal de la empresa importadora."
    },
    {
      "nombre": "operaciones",
      "etiqueta": "Operaciones",
      "tipo": "entero",
      "unidad": "ítems declarados",
      "origen": "derivado",
      "nulos": "nunca",
      "advertencias": "Cuenta ítems de declaración, no contenedores ni embarques.",
      "ejemplo": "10490",
      "descripcion": "Número de ítems declarados en el ámbito y periodo."
    },
    {
      "nombre": "valor_fob_usd",
      "etiqueta": "Valor FOB",
      "tipo": "decimal",
      "unidad": "USD",
      "origen": "SUNAT",
      "nulos": "en serie mensual (no disponible)",
      "advertencias": "FOB: no incluye flete, seguro, aranceles ni IGV.",
      "ejemplo": "12906772.45",
      "descripcion": "Suma del valor FOB declarado."
    },
    {
      "nombre": "primera_operacion",
      "etiqueta": "Primera operación",
      "tipo": "fecha ISO",
      "unidad": "",
      "origen": "derivado",
      "nulos": "nunca",
      "advertencias": "Primera EN NUESTRA SERIE (desde mayo de 2026), no primera histórica.",
      "ejemplo": "2026-05-18",
      "descripcion": "Fecha más antigua observada en la serie."
    },
    {
      "nombre": "ultima_operacion",
      "etiqueta": "Última operación",
      "tipo": "fecha ISO",
      "unidad": "",
      "origen": "derivado",
      "nulos": "nunca",
      "advertencias": "",
      "ejemplo": "2026-07-24",
      "descripcion": "Fecha más reciente observada."
    },
    {
      "nombre": "periodo",
      "etiqueta": "Periodo",
      "tipo": "mes ISO (AAAA-MM)",
      "unidad": "",
      "origen": "derivado",
      "nulos": "nunca",
      "advertencias": "",
      "ejemplo": "2026-07",
      "descripcion": "Mes calendario del agregado."
    },
    {
      "nombre": "precio_mediano",
      "etiqueta": "Precio unitario mediano",
      "tipo": "decimal",
      "unidad": "USD por ítem",
      "origen": "derivado",
      "nulos": "si el mes no supera el umbral de muestra",
      "advertencias": "Mediana con extremos recortados al p1/p99; nunca interpretar sin tamano_muestra.",
      "ejemplo": "165.00",
      "descripcion": "Mediana del precio unitario FOB del mes."
    },
    {
      "nombre": "p25",
      "etiqueta": "Percentil 25",
      "tipo": "decimal",
      "unidad": "USD por ítem",
      "origen": "derivado",
      "nulos": "como precio_mediano",
      "advertencias": "",
      "ejemplo": "90.16",
      "descripcion": "Cuartil inferior del precio unitario."
    },
    {
      "nombre": "p75",
      "etiqueta": "Percentil 75",
      "tipo": "decimal",
      "unidad": "USD por ítem",
      "origen": "derivado",
      "nulos": "como precio_mediano",
      "advertencias": "",
      "ejemplo": "359.79",
      "descripcion": "Cuartil superior del precio unitario."
    },
    {
      "nombre": "tamano_muestra",
      "etiqueta": "Tamaño de muestra",
      "tipo": "entero",
      "unidad": "ítems",
      "origen": "derivado",
      "nulos": "nunca",
      "advertencias": "Una mediana sin su muestra no se publica ni se exporta.",
      "ejemplo": "14030",
      "descripcion": "Observaciones detrás del agregado del mes."
    },
    {
      "nombre": "cantidad",
      "etiqueta": "Cantidad",
      "tipo": "decimal",
      "unidad": "según unidad declarada",
      "origen": "SUNAT",
      "nulos": "siempre en la serie (no agregada todavía)",
      "advertencias": "Columna presente y en null: el hueco es explícito, no silencioso.",
      "ejemplo": "null",
      "descripcion": "Cantidad física agregada del mes."
    },
    {
      "nombre": "tipo",
      "etiqueta": "Tipo de evento",
      "tipo": "texto (catálogo cerrado)",
      "unidad": "",
      "origen": "motor de eventos",
      "nulos": "nunca",
      "advertencias": "Catálogo en /cobertura/; los eventos son observaciones, no juicios.",
      "ejemplo": "nuevo_importador",
      "descripcion": "Qué cambio objetivo se observó."
    },
    {
      "nombre": "semana",
      "etiqueta": "Semana",
      "tipo": "fecha ISO (lunes)",
      "unidad": "",
      "origen": "motor de eventos",
      "nulos": "nunca",
      "advertencias": "",
      "ejemplo": "2026-07-20",
      "descripcion": "Semana en la que ocurre el cambio observado."
    },
    {
      "nombre": "marca_declarada",
      "etiqueta": "Marca declarada",
      "tipo": "texto",
      "unidad": "",
      "origen": "SUNAT",
      "nulos": "vacía si el ítem no declara marca",
      "advertencias": "Texto CRUDO del declarante; puede venir truncado o sucio. Ver marca (canónica).",
      "ejemplo": "WAN",
      "descripcion": "La marca tal como se escribió en la declaración."
    },
    {
      "nombre": "marca",
      "etiqueta": "Marca canónica",
      "tipo": "texto",
      "unidad": "",
      "origen": "resolución de identidad (res-v1)",
      "nulos": "vacía si la identidad está pendiente",
      "advertencias": "Resuelta con reglas deterministas y evidencia; las ambiguas no se resuelven en silencio.",
      "ejemplo": "WANXIN",
      "descripcion": "Forma canónica tras resolver truncados y variantes."
    },
    {
      "nombre": "regla",
      "etiqueta": "Regla generadora",
      "tipo": "texto",
      "unidad": "",
      "origen": "motor de eventos",
      "nulos": "nunca",
      "advertencias": "",
      "ejemplo": "ev-v1:primera-semana,n>=5",
      "descripcion": "La regla exacta y sus umbrales: cada evento es reproducible."
    }
  ]
}