Storefront Compatibility B2B Package

The Storefront Compatibility B2B Package (SCP-B2B) extends core Adobe Commerce B2B with the storefront-centric GraphQL that B2B drop-ins need — GraphQL for drop-in features that are not part of the core B2B product. SCP-B2B is not the same as Adobe Commerce B2B or the npm drop-ins in your storefront repo.

Version and compatibility requirements

Adobe Commerce 2.4.8 and 2.4.9 only, tested with Adobe Commerce B2B 1.5.2 and 1.5.3. SCP-B2B does not support Adobe Commerce 2.4.7 or Magento Open Source. For tested drop-in versions, see the release suite.

See What you need for backend-specific installation requirements.

What you need

Item	Requirement
Commerce backend	Adobe Commerce as a Cloud Service: Adobe installs SCP-B2B automatically (no merchant Composer step). Commerce on Cloud or on-premises with Adobe Commerce Optimizer: you install SCP-B2B with Composer, same responsibility model as the B2C package. Commerce on Cloud or on-premises without Adobe Commerce Optimizer: SCP-B2B is not available. See Backend options and Find your path.
B2C compatibility package	Required on the same Commerce instance. Install or confirm it before SCP-B2B. See Storefront Compatibility Package.
Adobe Commerce B2B	Separate extension and license on Commerce. Required on your instance before you install SCP-B2B. Contact your Adobe account representative to add it to your contract.
B2B drop-ins in your repo	You install with npm after the backend is ready. See Licensing requirements.

Major features

Adobe releases new GraphQL queries and mutations as part of the Storefront Compatibility B2B Package. The list below summarizes all GraphQL queries and mutations currently available in the package. For details about when a specific query or mutation was introduced, see the changelog and filter for the Storefront Compatibility B2B Package. Quick Order uses core Commerce GraphQL and is not listed here.

GraphQL APIs

This package provides the following GraphQL queries and mutations:

Company hierarchy

Supports Company Management and Company Switcher drop-in.

• assignChildCompany mutation — Company administrators can assign a child company to a parent company within the company hierarchy.

• unassignChildCompany mutation — Company administrators can unassign a child company from its parent company within the company hierarchy.

Requisition lists

Supports the Requisition List drop-in.

• sharedRequisitionList query — Retrieves a read-only shared requisition list for B2B customers, including sender details and associated items, based on the provided token.

• shareRequisitionListByToken mutation — Generates a shareable storefront token that enables B2B customers to share a requisition list with colleagues within the same company.

• shareRequisitionListByEmail mutation — Sends a requisition list to colleagues within the same company via email for B2B customers.

• importSharedRequisitionList mutation — Imports a shared requisition list into the current customer account based on the provided token.

Negotiable quotes

Supports Quote Management drop-in.

• negotiableQuoteTemplates query — Retrieves negotiable quote templates with sales rep, order, and pricing details.

• setQuoteTemplateExpirationDate mutation — Sets an expiration date on negotiable quote templates.

• placeNegotiableQuoteOrderV2 mutation — Transforms a negotiable quote into an order and returns full order details, including an errors array for standardized response handling.

Company Address

• company query – Returns a paginated list of company addresses assigned to the company, the company address book configuration settings, and the company’s default billing and shipping addresses, if set.

• createCompanyAddress mutation – Creates a new company address.

• deleteCompanyAddress mutation – Deletes a company address based on the provided address UID.

• setDefaultCompanyAddress mutation – Sets a company address as the default billing or shipping address based on the provided address UID.

• updateCompanyAddress mutation – Updates an existing company address based on the provided address UID (address type is immutable after creation).

REST endpoints

This package also provides following REST APIs:

• Company address CRUD endpoints:

  • POST /V1/company/:companyId/address – Create a company address.
  • GET /V1/company-address/:addressId – Retrieve a company address.
  • GET /V1/company/:companyId/addresses – Retrieve the list of company addresses.
  • PUT /V1/company-address/:addressId – Update a company address.
  • DELETE /V1/company-address/:addressId – Delete a company address.

• Endpoints to manage default company addresses:

  • GET /V1/companies/:companyId/billingAddress – Retrieve the default billing address.
  • GET /V1/companies/:companyId/shippingAddress – Retrieve the default shipping address.
  • PUT /V1/company-addresses/:addressId/default – Set the default billing or shipping address.

• Company address metadata endpoints:

  • GET /V1/attributeMetadata/companyAddress – Retrieve all company address attribute metadata.
  • GET /V1/attributeMetadata/companyAddress/attribute/:attributeCode – Retrieve metadata for a specific company address attribute.
  • GET /V1/attributeMetadata/companyAddress/form/:formCode – Retrieve company address attributes associated with a specific form.
  • GET /V1/attributeMetadata/companyAddress/custom – Retrieve custom company address attribute metadata.

Release information

For release notes for each Storefront Compatibility B2B Package version, see the changelog and filter for the Storefront Compatibility B2B Package. For tested package and drop-in versions in the current suite, see the release suite.