A supplier is an individual or company that provides products to marketplace providers, enabling them to sell those products to end users. Suppliers represent the source layer in the marketplace ecosystem, where providers purchase inventory for their catalogs.
Suppliers can operate through different business models, either dropshipping or wholesale, maintain ratings and review counts, and be tagged for organization. Each supplier is managed by a specific provider application, tracked via the app ID.
Supplier ID.
Revision number, which increments by 1 each time the Supplier is updated. To prevent conflicting changes, the current revision must be passed when updating the Supplier.
Ignored when creating a Supplier.
Date and time the Supplier was created.
Date and time the Supplier was last updated.
Supplier name. Displayed to providers when browsing and selecting suppliers for their product catalogs.
App ID of the provider application responsible for managing the supplier and its products. Automatically set to the ID of the application making the create request.
Supplier location.
Supplier rating from 1.00 to 5.00. For example, 4.25. Provider applications manage ratings and should update both rating and reviewCount together to maintain consistency.
Whether the supplier has passed verification processes.
Default: false
Supplier business model types. DROPSHIPPING suppliers ship directly to end customers, while WHOLESALE suppliers ship in bulk to the provider who fulfills orders. A supplier can support multiple fulfillment models.
Number of reviews for the supplier. Provider applications should update both rating and reviewCount together to maintain consistency.
Supplier tags for organization and categorization.