Controla lo que gastas en créditos
Los créditos son el dinero del producto, y casi todas las sorpresas de una factura salen de dos columnas y un diálogo que nadie abre. Aquí está dónde viven los números, cómo funciona la multiplicación y cómo estimar antes de gastar en vez de después.
Qué vas a construir
Una lectura de tu periodo que puedes defender: el reparto feed/realtime/account, quién lanzó cada ejecución, qué respuestas vinieron de caché, la aritmética exacta detrás de cualquier cargo y los tres estimadores que ponen precio a un escenario antes de comprometerte.
Cómo funciona
- 01Primero el chip, luego la pantalla
- 02Lee la tabla antes de concluir nada
- 03¿Por qué ha costado *eso*? — el cálculo
- 04Antes de gastar: estima, no adivines
- 05Sacarlo del dashboard
- 06Qué pasa después
Paso a paso
Al terminar sabrás responder tres preguntas con números leídos de la pantalla en vez de a ojo: cuánto he gastado, por qué esa línea concreta ha costado lo que ha costado, y cuánto me costaría hacer X.
Qué necesitas: nada. Todo lo de aquí es gratis de leer, y el simulador es gratis de usar.
Primero el chip, luego la pantalla
El chip de créditos de la cabecera es la versión de un vistazo — consumido en el periodo, y un aviso si te has pasado. Al pulsarlo entras en Billing · Usage, que es donde está la respuesta de verdad.
Empieza por la barra de resumen, porque parte el total igual que cobra el producto:
Los créditos Feed, Realtime y Account son tres economías distintas. El Feed se cobra por ejecución de import — por entidad y por día de visibilidad. El Realtime se cobra por petición. El de Account es casi gratis y solo aparece porque algunos endpoints tienen precio. Súmalos y tienes Total credits; multiplícalo por tu Cost por 1.000 créditos y tienes los euros.
El selector de Period importa más de lo que parece: es el periodo de facturación, y arrastra el plan que estaba vigente entonces. No respondas "cuánto gastamos" desde el periodo actual si la pregunta era del mes pasado.
Lee la tabla antes de concluir nada
Dos columnas hacen casi toda la explicación:
- TRIGGER — quién lo lanzó.
scheduledes tu propia automatización,manuales alguien pulsando el botón en el dashboard,apies tu integración llamando,recoveryes Veetal reintentando un fallo. Cuando una factura te sorprenda, esta columna suele señalar al culpable. - CACHED — si la respuesta vino de caché. Una respuesta cacheada no cobra o cobra menos, y es la primera explicación de "¿por qué esta no me ha costado nada?".
En la tabla de arriba se ve el mes entero de un vistazo: tres ejecuciones de Accommodation Rates a 437 créditos cada una lanzadas por api, una de Reputation a 20 lanzada por scheduled, dos imports de Booking Location Search a 0,32 lanzados a mano, y un puñado de llamadas real-time de Booking Search a 1,18. Tres ejecuciones disparadas por api se llevan más de la mitad del periodo.
¿Por qué ha costado eso? — el cálculo
Esta es la parte que casi nadie encuentra. El último icono de ACTIONS abre Calculation details, y enseña la aritmética, no un resumen de ella:
Léelo de abajo arriba:
0,0328 (base executions) × 19 (alojamientos) × 14 (visibilityDays) × 50 (créditos/unidad) = 436,07
Así que los 437 créditos no eran ningún misterio: 19 hoteles, 14 días de visibilidad hacia delante, 50 créditos por unidad. Lo que te dice de inmediato cuáles son las dos palancas —bajar el número de entidades o bajar la ventana de visibilidad— y más o menos cuánto ahorraría cada una. El diálogo trae además pricePerCreditApplied y costCalculation, para que veas los euros y no solo los créditos.
No reconstruyas esto a mano nunca. La fórmula vive en el producto y cambia según la API; este diálogo es la autoridad.
Antes de gastar: estima, no adivines
Hay dos estimadores que corren antes de que se mueva el dinero:
- El diálogo de import. Todo import Feed enseña un Estimated cost con las entidades y los parámetros que has elegido. Cambia los días de visibilidad y míralo moverse.
- El estimador del schedule. Al crear o editar una programación te enseña el coste por ejecución y el equivalente mensual según la frecuencia elegida. Ese segundo número es el que decide si un schedule diario tiene sentido.
Y para la pregunta grande —"¿cuánto nos costaría cubrir 40 hoteles y 3 ciudades?"— están las Simulaciones: montas el escenario, le añades las APIs con sus parámetros y lees los totales. No gasta nada. Es la herramienta correcta para dimensionar un plan o responder a un cliente, y gana a la cuenta de la servilleta.
Sacarlo del dashboard
Export te da el periodo en XLSX, una fila por línea de consumo, que es lo que quieres para cuadrarlo contra tus propios números. Billing data guarda los datos de facturación, y en Invoices están las facturas emitidas con su PDF.
Una cosa que la API no hace hoy: no hay ningún endpoint público que devuelva tu consumo. GET /v2/account/customer-info te da el plan, los límites de concurrencia, las IPs autorizadas, el webhook y tus schedules —útil para conocer tus techos— pero las cifras de créditos viven en el dashboard y en el export XLSX.
Qué pasa después
Si el patrón que encuentras es "nos pasamos siempre", en Plans se cambia de tramo —mensual o anual, con el descuento anual— y un downgrade pendiente se puede cancelar desde esa misma pantalla hasta que entre en vigor. Si el patrón es "hay una API que se lo come todo", la pestaña Usage de esa API enseña la misma tabla ya filtrada, que suele ser la vía rápida para dar con el schedule culpable.
Preguntas
¿Por qué esta petición no me ha costado nada?
Mira la columna CACHED. Una respuesta servida desde caché no cobra o cobra menos que una fresca. El segundo sitio donde mirar es TRIGGER: una ejecución que no lanzaste tú puede ser un schedule o un reintento de recovery.
¿Qué es exactamente un crédito?
Una unidad de trabajo, con precio distinto según la API. Los endpoints realtime cobran por petición. Los imports Feed cobran por entidad y por día de visibilidad, multiplicado por una cifra de créditos por unidad que es propia de esa API. El diálogo de Calculation details enseña la multiplicación exacta de cualquier línea, que es la única forma fiable de saberlo.
¿Por qué un import son 437 créditos y otro 0,32?
Porque la fórmula multiplica. El de 437 cubría 19 alojamientos por 14 días de visibilidad a 50 créditos por unidad; el de 0,32 era una sola búsqueda de destino para una noche. El número de entidades y la ventana de visibilidad son las dos palancas, y las dos se ven en el diálogo de import antes de lanzar.
¿Cómo sé lo que va a costar algo antes de ejecutarlo?
Tres sitios, de menor a mayor: el Estimated cost del diálogo de import, las cifras por ejecución y mensual del estimador del schedule, y la pestaña de Simulaciones para un escenario entero. Los tres son gratis.
¿Puedo sacar mi consumo por API?
Hoy no. No hay endpoint público de consumo. GET /v2/account/customer-info devuelve tu plan, los límites de concurrencia, las IPs autorizadas, el webhook y tus schedules, pero no los créditos consumidos. Para el consumo, usa el dashboard o el export a XLSX.
El chip dice que me he pasado del plan. ¿Qué pasa ahora?
El consumo por encima de tu plan se factura on demand a tu precio por crédito, que aparece en la barra de resumen como Cost por 1.000 créditos. La pestaña Plans es donde se cambia de tramo si eso pasa a ser la norma y no la excepción.
Construye el tuyo
Empieza gratis con 100 créditos de API. Sin tarjeta ni llamada comercial.
