Platform Agentexchange Partner Offers Configure

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:

   bash

   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>:

   bash

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

Phase 2 — Apply the preference

3. Write the TransactableMarketplacePrivateOfferSettings metadata file — load assets/org-pref-template.md for the exact XML structure, then write the file at:

   text

   <packageDir>/settings/TransactableMarketplacePrivateOffer.settings

   Set <enableTransactableMarketplaceReceivePartnerOffers>true</enableTransactableMarketplaceReceivePartnerOffers> (or false if disabling).

4. Deploy the metadata to the target org. Before running the deploy, confirm with the user:

   • Confirmed the target org alias with the user (deploying to the wrong org is not easily reversible)
   • Confirmed the desired state (true/false) matches the user's intent
   bash

   sf project deploy start --metadata TransactableMarketplacePrivateOfferSettings --target-org <alias>

Phase 3 — Verify

5. Confirm the change by re-running the Tooling API query from step 1 and verifying the Value column matches the desired state.

6. Report to the user — see Output Expectations below.

Rules / Constraints

Gotchas

Output Expectations

After completing all phases, report:

Org: <alias>Preference: enableTransactableMarketplaceReceivePartnerOffersPrevious value: <true|false|unset>New value: <true|false>File written: <packageDir>/settings/TransactableMarketplacePrivateOffer.settingsDeploy status: Success

Reference File Index