Skip to main content

Custom Forms & Application Workflows

Menu Path: Communication > Custom Forms

The Custom Forms module is a comprehensive form-building and application-processing engine. Beyond basic surveys and feedback collection, it serves as the operational gateway for Vendor Onboarding, Brand Registration, and Organization Applications.


1. Defining Form Purpose & Actions​

When creating a new form, select its functional Purpose:

  • Standard / General (STANDARD): Ideal for customer feedback, contact inquiries, and lead generation.
  • Merchant Onboarding (MERCHANT_APPLICATION): Enables prospective vendors to apply for storefront seller accounts. Upon approval, automatically creates a Merchant record, binds the applicant user, and triggers MERCHANT_ONBOARDING_SETUP.
  • Brand Registration (BRAND_APPLICATION): Collects trademark and manufacturer data. Upon approval, automatically provisions the Brand and triggers BRAND_SETUP.
  • Organization Application (ORGANIZATION_APPLICATION): Designed for cooperative, chamber, and association applications, provisioning an Organization upon approval.
  • Survey / Research (SURVEY): Tracks submission metrics, response frequencies, and conversion statistics.

2. Dynamic Field Builder & Smart Attribute Mapping​

Build your form schema by adding dynamic input fields:

  • Standard Inputs: Single-line text, number, email, phone, textarea, date picker, file upload.
  • Option Selectors: Dropdown select, radio buttons, multi-select checkboxes.
  • Nested Groups (OBJECT): Group related fields into reusable sub-objects (e.g., Authorized Representative, Company Address).

Smart Entity Attribute Mapping (mappedAttributeId)​

When a form purpose is linked to an entity (e.g., MERCHANT_APPLICATION), each form field can be mapped directly to an existing attribute from the Common Attribute catalog.

  • Selecting an attribute automatically binds its slug and data type.
  • When the application is approved, responses for mapped fields automatically transfer into the entity's normalized EAV attributes array.

3. Submissions & Application Review Workspace​

Submissions do not simply generate emails; they enter a structured review pipeline:

  1. Submission Queue: View incoming entries filtered by state (PENDING, UNDER_REVIEW, APPROVED, REJECTED, CANCELLED).
  2. 2-Column Review Workspace:
    • Left Column: Displays all submitted answers, structured sections, file downloads, and mapped attribute previews.
    • Right Column: Contains the submission lifecycle status changer, internal team comments, and immutable audit logs.
  3. One-Click Approval:
    • Approving an application triggers the automated entity creation engine.
    • The new entity (Merchant, Brand, or Organization) is immediately created, the applicant's role is updated, and onboarding setup tasks are assigned.
  4. Data Export: Export submission logs and responses to CSV or Excel for compliance audits.