Terms and concepts that you should help you understand the Marketplacer platform quicker!
AdvertAn Advert is essentially a Product in Marketplacer (it is referred to as an Advert for historical reasons). An Advert belongs to 1 Seller and has 1 or more Variants.
Advert VettingAdvert Vetting is an optional workflow that an Operator can enable. Vetting allows the Operator to ensure that Products (Adverts) adhere to their own publishing standards before they can be placed for sale on the marketplace.
Connected IntegrationThis is primary way that Operators will connect their existing eCommerce platform into Markerplacer. With this model the frontend shopper experience, (including checkout and payment), is still provided by the Operators eCommerce platform.
InvoiceAn Invoice is the part of the overall customer order that an individual Seller has to fulfill. An Order will always have at least 1 Invoice (1 Invoice per Seller participating in the Order)
Invoice AmendmentFollowing the completion of an Order (and therefore the creation of Invoices) there may be reasons why those individual Invoices need to be amended, (for example when a customer requires a refund). In such cases an Invoice will have associated Invoice Amendments. An Invoice can have 0 or more Invoice Amendments.
OperatorThe business entity that runs the marketplace and is the merchant of record for the transactions that occur on the marketplace.
Operator APIThe GraphQL API that provides Operators with the ability to build (amongst other things) a Connect Integration
OrderAn Order is the “marketplace-level” object that acts as the container for a customer’s entire purchase. An Order object in Marketplacer will always have at least 1 Invoice attached to it, (1 invoice per seller)
Remittance AdviceRemittance Advices group multiple Remittances together under 1 “advice”. Prior to this feature you had to rely solely on the relationship between a Remittance and an Invoice / Invoice Amendment (a Remittance can only relate to 1 Invoice or Invoice Amendment) which made things like reporting problematic. With the release Remittance Advices, it is now easy to see the relationships between multiple Remittances and the Invoice (and Invoice Amendments) that they are related to.
Remittance ActionThis is a GraphQL object type that models the payout actions to occur, e.g. the use of Hyperwallet to pay a Seller.
Remittance EventThis is a GraphQL object type that models the events on an Remittance Action. e.g. did the action to pay a seller via Xero succeed or fail?
SellerBusiness entity that places products for sale on the marketplace. An Seller is responsible for fulfilling Invoices on an Order, a Seller can only have 1 Invoice per Order. There are usually 10’s, 100’s or event 1000’s of individual Sellers on a single marketplace.
Seller APIThe GraphQL API that allows Sellers to build integrations into Marketplacer. This can take a number of forms but will usually include the following functions: Product Creation, Invoice Retrieval & Shipment Creation
Seller API LegacyThe REST API that allowed Sellers to build integrations into Marketplacer. This API is no longer bing actively developed and has been replaced with the GraphQL alternative.
V2 APISee Seller API Legacy
VariantAn Advert always has to have at least 1 Variant. It is at the Variant level where concepts such as SKU, Barcodes and Inventory sit. When placing an order in Marketplacer, it is the Variant that is actually being purchased.
VettingSee Advert Vetting