Asociar medidor al plan
Asocia un medidor a un plan existente como precio medido: créditos incluidos por ciclo más el precio por unidad adicional.
403 PRODUCT_NOT_ENABLED.- Al crear: envía
meters[](con la misma estructura que el cuerpo de esta solicitud) a Crear plan. Las entradas demeter_idduplicadas se rechazan con409. - En un plan activo: llama a este endpoint una vez por medidor, o envía
{ "meters": [ ... ] }aPATCH /subscriptions/plans/{plan_id}: ese PATCH solo permite asociar y es atómico: si alguna entrada de la lista no es válida (ya asociada, medidor desconocido o inactivo, precio incorrecto), no se asocia nada. Cualquier otro campo del plan en ese cuerpo (name,base_amount, …) se ignora sin aviso: los planes siguen siendo inmutables fuera demeters[].
USD y el medidor tiene un default_price, puedes omitir price_per_credit: se aplica el valor predeterminado del medidor y el precio medido se devuelve con price_per_credit: null. En cualquier otro caso (la moneda de price_per_credit siempre debe ser igual a la moneda base del plan), envíalo de forma explícita. Solo se pueden asociar medidores ACTIVE; un medidor archivado se rechaza con 400 METER_NOT_FOUND.pricing_strategyPER_UNIT usa price_per_credit/country_prices. PACKAGE usa package_size, package_price y, de forma opcional, package_country_prices. TIERED usa tiers[] (límites up_to ascendentes, el último nivel con up_to: null). Enviar campos de configuración de una estrategia distinta de la que seleccionaste se rechaza con 400 PLAN_METER_PRICING_CONFIG_UNSUPPORTED. Una vez asociada, la configuración PACKAGE/TIERED no se puede cambiar: consulta Actualizar medidor del plan.Authorizations
Headers
El account_id que se encuentra en tu Yuno Dashboard (UUID). Obligatorio: si lo omites, se devuelve 400 BAD_REQUEST ("Invalid x-account-code header.").
Body
El identificador único del medidor que se va a asociar (MAX 64; MIN 36). Debe ser un medidor ACTIVE existente de la cuenta: un medidor desconocido o INACTIVE se rechaza con 400 METER_NOT_FOUND. Un medidor solo se puede asociar a un plan una vez; de lo contrario, 409 PLAN_METER_ALREADY_ASSIGNED.
Cómo se calcula el precio del uso que excede credits: PER_UNIT (unidades facturables × price_per_credit), PACKAGE (paquetes de N unidades; un paquete parcial cuenta como uno completo) o TIERED (niveles graduados, cada tramo con su propia tarifa).
PER_UNIT, PACKAGE, TIERED Solo para pricing_strategy: PACKAGE. El tamaño del paquete: las unidades facturables se redondean hacia arriba al múltiplo entero más cercano. Debe ser > 0; se aceptan decimales y notación científica (1e3) y se convierten. Se almacena redondeado a 4 decimales. Obligatorio cuando pricing_strategy es PACKAGE; se rechaza con 400 PLAN_METER_PRICING_CONFIG_UNSUPPORTED para cualquier otra estrategia.
Solo para pricing_strategy: TIERED. Tramos de precio graduados y ordenados. Obligatorio cuando pricing_strategy es TIERED (al menos una entrada). Cada nivel, excepto el último, necesita un up_to estrictamente ascendente; el up_to del último nivel debe ser null (sin límite). Todos los niveles deben compartir la misma moneda (y los mismos países de country_rates, si se usan).
Response
201