Skills

Platform Agentexchange Partner Offers Configure

Enable or disable the org preference that controls whether a Salesforce org can receive...

Install

npx skills add forcedotcom/sf-skills --skill platform-agentexchange-partner-offers-configure -g -a claude-code -y
Repository
forcedotcom/sf-skills1.1k
Category
DevOps
Updated
5d ago
License
Apache-2.0
Context cost
Lightabout 1,276 tokens
Runs scripts
No, instructions only

What it does

Enable or disable the org preference that controls whether a Salesforce org can receive partner offers from the Transactable Marketplace. Use this skill when the user wants to turn partner offer reception on or off for an org. TRIGGER when: user asks to enable or disable partner offers, configure TransactableMarketplaceReceivePartnerOffers, configure enableTransactableMarketplaceReceivePartnerOffers, set up marketplace partner offer reception, toggle the TM partner offers setting, edit a TransactableMarketplacePrivateOffer.settings file, or configure org preferences related to transactable marketplace. DO NOT TRIGGER when: user needs to create or manage the partner offer records themselves, configure marketplace listing settings, or work with SfdcPartnerOffer objects (use platform-metadata-deploy or platform-apex-generate instead).

Enabling Transactable Marketplace Receive Partner Offers Org Preference

This skill configures the enableTransactableMarketplaceReceivePartnerOffers org preference via the TransactableMarketplacePrivateOfferSettings Metadata API type, which controls whether a Salesforce org is eligible to receive partner offers through the Transactable Marketplace. It is required for subscriber orgs that participate in the TM partner offer flow.

Scope

  • In scope: Reading the current value of the pref, enabling or disabling it via Metadata API (TransactableMarketplacePrivateOfferSettings), and verifying the change took effect.
  • Out of scope: Creating or managing partner offer records, configuring marketplace listings, or any Apex/trigger changes related to offer processing.

Required Inputs

  • Target org alias or username: The org where the pref should be set. Ask if not provided.
  • Desired state: true (enable) or false (disable). Default: true.

Workflow

Phase 1, Check current state

  1. Query the current preference value by running:

    sf data query -q "SELECT Preference, Value FROM OrgPreference WHERE Preference = 'TransactableMarketplaceReceivePartnerOffers'" --target-org <alias> --use-tooling-api
    

    If the record exists and Value = true, the pref is already enabled, confirm with the user before proceeding. If the query returns no rows, the pref is not yet set (defaults to false).

  2. Resolve the org's package directory to determine where to write metadata. Run this and use its output as <packageDir>:

    jq -r '.packageDirectories[0].path // "force-app/main/default"' sfdx-project.json
    

Phase 2, Apply the preference

Read the whole SKILL.md on GitHub

More in DevOps