README.md

Request for Quotation Plug-In

A Request For Quotation (RFQ) interface can be created that permits the buyers to request sellers to offer quotes on a particular item or service. This can be done with the correct set of APIs, custom fields and tables which are identified here.

This sample code is a very basic example of how an RFQ experience can be created for buyers and sellers of a marketplace. The source code's structure is intended to run on an Arcadier Marketplace as a Plug-In.

The CSS and other UI aspects can be easily modified to match your own requirements.

The same sequence of APIs and user flows and be used to recreate the RFQ UX on an external CMS or external web page.

RFQ flow

The 4 main events of this flow are as follows:

• A buyer logs in with the intention of creating an RFQ
• A seller logs in with the intention to view new RFQs and submite a quote for one or more of them
• The buyer logs in to view different quotes submitted by different sellers for their RFQs
• The buyer accepts one of them and initiates the Arcadier quotation and requisition flow.

Features created by the Plug-In

For the buyer

Two links are created for the buyer:

• Create RFQ
• View Proposals

Both of these link to 2 custom pages created via the plugin: /user/create_RFQ.php and /user/view_propsals.php.

create_RFQ.php contains a form to collect inputs from the buyer, and save that input in a custom table called Submitted_RFQs, using Custom Table APIs

view_proposals.php also uses Custom Table APIs to fetch data from a custom table called accepted_RFQs, which contains proposals from sellers who accepted an RFQ.

For the seller

One new link and one custom page

• View RFQs (link)
• /user/merchant_accept_RFQ.php

/user/view_RFQ.php fetches data from theSubmitted_RFQs table and displays them for the seller to see.

Once a seller chooses to submite a quote for an RFQ, merchant_accept_RFQ.php opens up and displays a form to collect data from the seller and save it in a custom table called accepted_RFQs.

Video Demo

RFQ flow - Watch Video

Installation

Composer

This Plug-In uses Arcadier's PHP SDK to function. You can install SDK via composer using the following command line:

composer require arcadier/arcadier-php

💡 Getting Started

Once the SDK is installed in your directory, find the .env file in the vendor/arcadier/arcadier-php/src and input the values that are empty.

Once done, zip the admin, user, and vendor folders together and upload them to your sandbox dashboard to view the plug-in at work.

🔨 List of APIs being used in this project:

• GET /api/v2/plugins/{{packageID}}/custom-tables/{{custom-table-name}}/(Get all Custom Table Contents)
• POST /api/v2/plugins/{{packageID}}/custom-tables/{{custom-table-name}}/rows(Create New Row Entry)
• PUT /api/v2/plugins/{{packageID}}/custom-tables/{{custom-table-name}}/rows/{{rowID}} (Edit Row Entry)
• GET /api/v2/users/{{userID}} (Get User Information)

API Documentation

View our full API collection on Postman here.