- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ppp-pricing -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ppp-pricing -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ppp-pricing -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ppp-pricing -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-ppp-pricingDel publicador
Use this skill to create or update localized pricing across territories based on purchasing power parity (PPP) or your own regional pricing strategy.
Prefer the current high-level flows:
asc subscriptions setup and asc iap setup for parent creation and pricing,
followed by version-scoped metadata commandsasc subscriptions pricing ... for subscription pricing changesasc iap pricing summary and asc iap pricing schedules ... for IAP pricing changesPrefer native asc commands. Use asc api only when no native command covers
the task; the --resolved reads below already return territory, currency,
customer price, proceeds, and price point ID for every territory.
asc auth login or ASC_* env vars).ASC_APP_ID or pass --app explicitly.USA) and baseline price.asc pricing territories list --paginate if you need supported territory IDs.setupUse setup to create the group and subscription, upload the App Review
screenshot, materialize the complete equalized price matrix, and set sale
availability. Create the API 4.4.1 group and subscription versions afterward;
the localization flags on setup use deprecated v1 resources and must not be
used for new workflows.
asc subscriptions setup \
--app "APP_ID" \
--group-reference-name "Pro" \
--reference-name "Pro Monthly" \
--product-id "com.example.pro.monthly" \
--subscription-period ONE_MONTH \
--review-screenshot "./review.png" \
--price "9.99" \
--price-territory "USA" \
--territories "USA,CAN,GBR" \
--no-verify \
--output json
Capture .groupId and .subscriptionId from the setup JSON, then add
version-scoped metadata. --no-verify is intentional here: without deprecated
v1 localizations, the parent can remain MISSING_METADATA until the v2 steps
finish.
asc subscriptions groups versions list --group-id "GROUP_ID" --state PREPARE_FOR_SUBMISSION --paginate --output json
# If and only if the list has zero matches:
asc subscriptions groups versions create --group-id "GROUP_ID" --output json
# For one match, reuse .data[0].id. For more than one, stop and require an explicit GROUP_VERSION_ID.
asc subscriptions groups versions localizations list --version-id "GROUP_VERSION_ID" --paginate --output json
# If and only if en-US is missing:
asc subscriptions groups versions localizations create --version-id "GROUP_VERSION_ID" --locale "en-US" --name "Pro"
# Otherwise, if and only if the resolved en-US name differs:
asc subscriptions groups versions localizations update --id "GROUP_LOC_ID" --name "Pro"
# Otherwise, do nothing.
asc subscriptions versions list --subscription-id "SUB_ID" --state PREPARE_FOR_SUBMISSION --paginate --output json
# If and only if the list has zero matches:
asc subscriptions versions create --subscription-id "SUB_ID" --output json
# For one match, reuse .data[0].id. For more than one, stop and require an explicit SUBSCRIPTION_VERSION_ID.
asc subscriptions versions localizations list --version-id "SUBSCRIPTION_VERSION_ID" --paginate --output json
# If and only if en-US is missing:
asc subscriptions versions localizations create --version-id "SUBSCRIPTION_VERSION_ID" --locale "en-US" --name "Pro Monthly" --description "Unlock everything"
# Otherwise, if and only if the resolved en-US values differ:
asc subscriptions versions localizations update --id "SUBSCRIPTION_LOC_ID" --name "Pro Monthly" --description "Unlock everything"
# Otherwise, do nothing.
asc subscriptions groups versions localizations list --version-id "GROUP_VERSION_ID" --paginate --output table
asc subscriptions versions localizations list --version-id "SUBSCRIPTION_VERSION_ID" --paginate --output table
asc validate subscriptions --app "APP_ID" --output table
Follow the conditions in the comments exactly: versions cannot be deleted, so
never create a second PREPARE_FOR_SUBMISSION version.
Notes:
setup materializes Apple's complete equalized price matrix from the selected
base price. This split workflow defers final verification until the v2
localizations exist.--no-verify so setup performs its
normal readback verification.--tier or --price-point-id instead of --price when your workflow is tier-driven.MISSING_METADATA with the same selected base price, re-run the setup inputs with --repair to atomically rebuild and re-save the matrix.Use the summary view first when you want a compact current-state snapshot.
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "USA"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --resolved
Use summary for quick before/after spot checks. prices list --resolved
returns the current effective price for every territory (customer price,
currency, proceeds, price point ID). It excludes future-dated prices; use
prices list --paginate for raw records when checking scheduled changes.
Use derive when a target subscription should stay near a fixed multiple of a
source subscription in every territory, such as yearly pricing near 10 times
monthly pricing. Apple ladders scale unevenly across territories, so preview
the selected target points and achieved multiples before applying them.
asc subscriptions pricing derive \
--source-subscription-id "MONTHLY_SUB_ID" \
--target-subscription-id "YEARLY_SUB_ID" \
--multiplier "10" \
--round nearest \
--dry-run \
--output table
Choose how a desired price resolves when Apple does not offer it:
exact fails unless the calculated amount exists on the target ladder.nearest chooses the closest amount; an exact tie chooses the lower one.up chooses the smallest available amount at or above the calculation.down chooses the largest available amount at or below the calculation.The confirmed command fetches current prices and builds a fresh plan; it does
not reuse the preceding dry-run result. When the applied values must match the
reviewed values, rerun --dry-run immediately before confirming, then apply:
asc subscriptions pricing derive \
--source-subscription-id "MONTHLY_SUB_ID" \
--target-subscription-id "YEARLY_SUB_ID" \
--multiplier "10" \
--round nearest \
--confirm \
--output table
The source and target must be distinct subscriptions with existing standard
UPFRONT prices. The operation is a one-time snapshot, not a persistent link.
It fails closed before mutation when any territory cannot resolve, skips target
prices that already match, and verifies applied prices by reading them back.
Use --territory "SWE" for a focused preview or staged one-territory update;
omit it to derive every current source territory.
Approved or live targets are scheduled for tomorrow by default when no
--start-date is supplied because --auto-start-date defaults to true. Pass
--auto-start-date=false to apply immediately, or use an explicit date when
coordinating a rollout.
The command does not change subscription sale availability.
For broad PPP rollouts, prefer the subscription pricing import command instead of manually adding territory prices one by one.
Example CSV:
territory,price,start_date,preserved
IND,2.99,2026-04-01,false
BRA,4.99,2026-04-01,false
MEX,4.99,2026-04-01,false
DEU,8.99,2026-04-01,false
Dry-run first:
asc subscriptions pricing prices import \
--subscription-id "SUB_ID" \
--input "./ppp-prices.csv" \
--dry-run \
--output table
Apply for real:
asc subscriptions pricing prices import \
--subscription-id "SUB_ID" \
--input "./ppp-prices.csv" \
--confirm \
--output table
Notes:
--dry-run validates rows and resolves price points without creating prices.--continue-on-error=false gives you a fail-fast mode.territory, pricecurrency_code, start_date, preserved, preserve_current_price, price_point_idprice_point_id is omitted, the CLI resolves the matching price point for the row's territory and price automatically.For a small number of manual overrides, use the canonical set command.
asc subscriptions pricing prices set --subscription-id "SUB_ID" --price "2.99" --territory "IND"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --tier 5 --territory "BRA"
asc subscriptions pricing prices set --subscription-id "SUB_ID" --price-point "PRICE_POINT_ID" --territory "DEU"
Notes:
--start-date "YYYY-MM-DD" to schedule a future change.--preserved when you want to preserve the current price relationship.Use price-point lookup and equalizations when you want to inspect Apple's localized ladder directly or pin exact price point IDs.
asc subscriptions pricing price-points list --subscription-id "SUB_ID" --territory "USA" --paginate --price "9.99"
asc subscriptions pricing price-points equalizations --price-point-id "PRICE_POINT_ID" --paginate
asc subscriptions pricing price-points adjusted-equalizations --price-point-id "PRICE_POINT_ID" --upfront-price-point-id "UPFRONT_PRICE_POINT_ID" --plan-type MONTHLY --subscription-id "SUB_ID" --paginate
Use equalizations for Apple's standard localized ladder. Use
adjusted-equalizations when you need the API 4.4.1 subscription-specific
adjustments. For a fresh adjusted-equalizations request, pass both
--upfront-price-point-id and --plan-type; --subscription-id and
--territory are optional filters. Treat --next as an opaque continuation
URL. On a resumed equalizations or adjusted-equalizations request, pass only
--next without the original owner --price-point-id, filters, sparse fields,
includes, or limit; the continuation URL already carries that query state.
--paginate and explicit output flags may still be used.
Re-run the summary and raw list views after changes.
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "IND"
asc subscriptions pricing summary --subscription-id "SUB_ID" --territory "BRA"
asc subscriptions pricing prices list --subscription-id "SUB_ID" --resolved
asc subscriptions pricing prices list --subscription-id "SUB_ID" --paginate
After the version metadata exists, you may rerun asc subscriptions setup with
verification enabled to recheck the parent, pricing, screenshot, and
availability state.
The underlying subscription-availability resource is deprecated in App Store Connect API 4.4. Keep this command family only for compatibility when ordinary upfront territory availability still needs it; Apple does not provide a one-for-one replacement for that case. For Monthly with 12-Month Commitment, use asc subscriptions pricing monthly-commitment enable|disable|list instead.
asc subscriptions pricing availability edit --subscription-id "SUB_ID" --territories "USA,CAN,IND,BRA"
asc subscriptions pricing availability view --subscription-id "SUB_ID"
setupUse setup to create the product and initial price schedule. Its localization
flags use the deprecated v1 resource, so add localization through an API 4.4.1
IAP version after setup.
asc iap setup \
--app "APP_ID" \
--type NON_CONSUMABLE \
--reference-name "Pro Lifetime" \
--product-id "com.example.pro.lifetime" \
--price "9.99" \
--base-territory "USA" \
--output json
Capture .iapId from the setup JSON, then create the version and metadata:
asc iap versions list --iap-id "IAP_ID" --state PREPARE_FOR_SUBMISSION --paginate --output json
# If and only if the list has zero matches:
asc iap versions create --iap-id "IAP_ID" --output json
# For one match, reuse .data[0].id. For more than one, stop and require an explicit IAP_VERSION_ID.
asc iap versions localizations list --version-id "IAP_VERSION_ID" --paginate --output json
# If and only if en-US is missing:
asc iap versions localizations create --version-id "IAP_VERSION_ID" --locale "en-US" --name "Pro Lifetime" --description "Unlock everything forever"
# Otherwise, if and only if the resolved en-US values differ:
asc iap versions localizations update --localization-id "IAP_LOC_ID" --name "Pro Lifetime" --description "Unlock everything forever"
# Otherwise, do nothing.
Notes:
setup verifies the created IAP and price schedule by default; verify the
version localization with its version-scoped list command.--start-date for scheduled pricing.--tier or --price-point-id when you want deterministic tier- or ID-based setup.Use asc iap pricing summary as the main current-state summary for PPP work.
asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"
This returns the base territory, current price, estimated proceeds, and scheduled changes for the requested territory.
For a snapshot of every territory, read the price schedule with --resolved.
Take the schedule ID from .data.id of schedules view; it usually equals the
IAP ID, but read it instead of assuming.
asc iap pricing schedules view --iap-id "IAP_ID"
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --resolved --output table
--resolved returns one row per territory with territory, customer price,
currency, proceeds, price point ID, and whether the price is manual.
Both manual-prices --resolved and automatic-prices --resolved combine manual
and automatic prices active today. They exclude future-dated entries. Without
--resolved, these commands return raw schedule records; use --paginate to
include every page when checking scheduled changes.
Look up one territory's ladder with price-points list, one territory per call.
--price filters each fetched page, so always pair it with --paginate.
asc iap pricing price-points list --iap-id "IAP_ID" --territory "IND" --paginate
asc iap pricing price-points list --iap-id "IAP_ID" --territory "IND" --paginate --price "299"
Use equalizations only to see what Apple's equalized ladder gives for a base
price point. Its rows carry price point ID, customer price, and proceeds but no
territory or currency, so do not use it to look up a specific country's price.
asc iap pricing price-points equalizations --id "PRICE_POINT_ID" --paginate
For manual PPP updates, create a price schedule directly.
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --price "4.99" --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --tier 5 --start-date "2026-04-01"
asc iap pricing schedules create --iap-id "IAP_ID" --base-territory "USA" --prices "PRICE_POINT_ID:2026-04-01"
Use these when you are intentionally creating or replacing schedule entries. For deeper inspection:
asc iap pricing schedules view --iap-id "IAP_ID"
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --paginate
asc iap pricing schedules automatic-prices --schedule-id "SCHEDULE_ID" --paginate
Use the summary command again after scheduling or applying pricing changes.
asc iap pricing summary --iap-id "IAP_ID" --territory "USA"
asc iap pricing summary --iap-id "IAP_ID" --territory "IND"
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --resolved --output table
asc iap pricing schedules manual-prices --schedule-id "SCHEDULE_ID" --paginate
asc iap pricing schedules automatic-prices --schedule-id "SCHEDULE_ID" --paginate
For future-dated schedules, run summary for every changed territory to verify
scheduled price-point IDs and dates; keep the raw paginated reads for the full
schedule inventory. The resolved snapshot excludes prices until they take effect.
USA.asc subscriptions pricing ... and asc iap pricing ... in docs and automation; do not use the removed asc subscriptions prices ... path.asc subscriptions pricing prices import --dry-run is the safest subscription batch PPP path today.asc subscriptions setup and asc iap setup already provide built-in post-create verification.--resolved reads for current prices and raw paginated records for scheduled changes.Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands. Use when adjusting prices by country or imple
---name: asc-ppp-pricingdescription: Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing…---# skills/asc-ppp-pricing/SKILL.mdResumen general
Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands. Use when adjusting prices by country or implementing localized PPP strategies.
Preguntas frecuentes
Descarga skills/asc-ppp-pricing/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/rorkai/app-store-connect-cli-skills.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.