Modelo de datos
El esquema completo, con tipos, está en la API reference. Esta página explica el porqué.
| Campo | Tipo | Notas |
|---|---|---|
id |
off_<uuid> |
Estable en el tiempo: la misma oferta conserva su id. |
status |
active · scheduled · expired · withdrawn |
expired = pasó su valid_until; withdrawn = la fuente dejó de publicarla antes de vencer. |
title |
texto | Normalizado por Pangui. |
benefit |
objeto | kind, value, currency, cap y un summary generado por Pangui. |
issuer |
objeto | id (iss_<slug>), slug, name, type, country. |
merchant |
objeto | id (mer_<uuid>), slug, name, website. |
category |
enum | restaurante, salud, viajes, entretenimiento, … |
modality |
enum | presencial, online, delivery, todos. |
valid_days |
lista | monday … sunday. |
valid_from, valid_until |
YYYY-MM-DD |
Fecha calendario en timezone. |
timezone |
America/Santiago |
|
payment_products |
lista | Tarjetas o medios de pago que aplican: type (credit, debit, prepaid) y brand. |
locations |
lista | comuna, region, latitude, longitude (pueden ser null). |
terms |
{ text } |
En beta.1 viaja null; reservado para condiciones cortas estructuradas. |
source_url |
URL | La página del emisor: ahí están las condiciones completas y vinculantes. |
updated_at |
instante UTC | Cuándo cambió por última vez la oferta o su estado. Ver Sincronización. |
Por qué las fechas no son instantes
Sección titulada «Por qué las fechas no son instantes»La vigencia de una oferta es un día calendario en Santiago: una oferta “válida hasta el 31 de
diciembre” vale todo ese día. Si la publicáramos como instante (2026-12-31T03:00:00Z), cualquier
consumidor en otro huso horario la vería vencer un día antes o después. Por eso valid_from y
valid_until son fechas, con timezone explícito, y los instantes se reservan para lo que sí es
un instante: updated_at y data_as_of.
Tipos de emisor
Sección titulada «Tipos de emisor»issuer.type es un enum abierto —pueden aparecer valores nuevos; trátalos como other—:
type |
Ejemplos |
|---|---|
bank |
Banco de Chile, Santander, BCI, Banco Estado |
retail_card |
CMR Falabella, Tarjeta Cencosud Scotiabank, La Polar |
fintech |
MACH, Tenpo, Tapp |
telco |
Entel, Claro Club, Club WOM |
fuel |
Copec Pay, Full Copec, Aramco |
municipal |
Vecino Las Condes, Soy Providencia, Mi Vitacura |
caja |
Caja Los Andes, Coopeuch |
Qué no viaja
Sección titulada «Qué no viaja»No publicamos las descripciones largas de cada fuente ni sus imágenes o logos: son contenido y
marcas de terceros. Para eso está source_url.