Sample Data Add-On

The Sample Data add-on installs demo data for B2B Quote so implementation teams can test workflows without creating every quote, project, rule, and attachment manually.

This add-on is:

  • Composer package: mageb2b/b2b-quote-sample-data
  • Magento module: MageB2B_B2BQuoteSampleData
  • Requires the base module: MageB2B_B2BQuote

What It Installs

The add-on builds a connected example workflow rather than a set of unrelated records. Its CSV fixtures create:

  • customers, customer addresses, and products
  • quote statuses and allowed status transitions
  • categories, tags, pricing rules, and workflow rules
  • customer projects and quotes with line items
  • agreements and agreement call-off items
  • quote fees, messages, attachments, and addresses
  • category and tag assignments
  • revision history

This makes the data useful for demonstrations, acceptance testing, and administrator training. It is not intended for a production catalog.

Installation

1) Require package

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/b2b-quote-sample-data:*

2) Enable module + run setup

php bin/magento module:enable MageB2B_B2BQuoteSampleData
php bin/magento setup:upgrade
php bin/magento cache:flush

The data patch runs during setup:upgrade. It installs dependencies first, followed by quote configuration, rules, projects, quotes, related records, and revision history. Individual fixture errors are printed during installation, so review the command output instead of assuming every record was created.

CLI Commands

Verify the core sample set:

php bin/magento sampledata:verify:b2b-quote

The verifier checks customers, products, projects, quotes, quote items, categories, tags, pricing rules, and workflow rules. It does not currently validate every agreement, fee, message, attachment, address, or revision record.

Reset the sample set:

php bin/magento sampledata:reset:b2b-quote

The reset command asks for confirmation and deletes records identified by the module's fixtures. It also removes the sample-data patch entry so that a later setup:upgrade can install the fixtures again.

Use reset only in a local, demo, or staging environment. Take a database backup first if people have worked with or modified the installed examples. To reinstall after reset:

php bin/magento setup:upgrade
php bin/magento sampledata:verify:b2b-quote

No Admin UI

This add-on does not add a separate admin page. It is fixture and CLI driven.

Use the normal B2B Quote admin pages to inspect the created records:

Troubleshooting

If sample data is incomplete:

  1. Run sampledata:verify:b2b-quote.
  2. Review the previous setup:upgrade output for fixture warnings.
  3. Check whether the fixture customers and products exist; quotes depend on them.
  4. Check var/log/system.log and var/log/exception.log.
  5. Reset and rerun setup:upgrade only if the environment can safely lose the sample records.