Skip to main content

Products & Proposals

Authentication

Any Partner application responsible for handling product data must be permitted to interact with the Products & Proposals endpoint, which requires a valid bearer token in the request headers. This token is obtained by authenticating through the Authentication service.

Onboarding​

It's the fundamental process by which the Brand Partner uploads the products intended for sale.

Products​

The goods or services that the Brand Partner commercializes through the Platform.

Key Elements of Onboarding​

The process has been designed around three key concepts to ensure efficiency and flexibility:

1. Fast​

Rapid onboarding. No friction, no lock-in.​

The required validation is minimal: no rigid constraints exist and no data is lost. It is not necessary to expose the complexity of the Partner's internal systems; exclusively the essential elements are required to go online immediately.

2. Adaptive​

Designed to adapt, not to impose.​

The Partner's data is managed on its terms. Manna does not hinder operability: it is possible to sell effortlessly using only SKU, stock, and basic prices, or to enrich the experience with authentic content (compositions, origin, AI-enriched metadata) to create complete product pages.

3. Bundle​

Clear APIs and specific models for maximum simplicity.​

An all-inclusive "Bundle": integrations are simplified through a single package that encompasses all necessary data.

Process Phases​

Operations are structured around two main activities:

1. Uploading and enrichment of product master data​

2. Uploading of proposals​

Composable

The “composable" approach allows these workflows to be managed either in discrete stages—handling each step in context—or as a single, unified bundle that combines both product master data and proposals.

A summary diagram is provided below to illustrate the workflow.

1. Per Context​

Products-Proposals_Flow

{
  "productId": "O11010351-W01GQ-",
  "brandId": "VIVIENNE_WESTWOOD",
  "styleModelId": null,
  "departmentId": "dresses",
  "genreId": "WOMAN",
  "seasonId": "SS",
  "productName": "Galaxy Dress",
  "taxClassification": "TAX_HIGH_FASHION",
  "colorVariants": [
    {
      "colorId": "PLUM",
      "colorDescription": "PLUM",
      "htmlCode": "#5e263e",
      "sizeVariants": [
        {
          "sku": "O11010351-W01GQ-_PLUM_6",
          "sizeId": "6",
          "variantId": "-",
          "sizeDescription": "6",
          "partnerId": [
            {
              "key": "EAN",
              "value": "8053195453047"
            }
          ]
        }
      ]
    }
  ]
}

2. An all-inclusive "Bundle"​

Products-Proposals_Flow

{"productId":"O11010351-W01GQ-","brandId":"VIVIENNE_WESTWOOD","styleModelId":null,"departmentId":"dresses","genreId":"WOMAN","seasonId":"SS","productName":"Galaxy Dress","productShortDescription":"Designed with a corseted silhouette, the Galaxy dress draws inspiration from Vivienne’s classic Ball Tie gown. Soft draping frames the neckline, while the satin fabric falls smoothly from the hips into a sleek A-line shape, subtly echoing the beauty of ancient Greek statues.","taxClassification":"TAX_HIGH_FASHION","productEnrichment":{"productCopy":[{"dctLanguageId":"en","content":"<ul><li>Features a strapless, draped neckline</li><li>Corseted, slim A-line silhouette</li><li>Cinched waist</li><li>Concealed zipper</li><li>Fully lined interior</li><li>Non-stretchy fabric</li><li>Made in the United Kingdom</li></ul><ul><li>100% Viscose</li></ul>"},{"dctLanguageId":"it","productName":"Galaxy Dress","productShortDescription":"Il vestito Galaxy con silhouette a corsetto trae ispirazione dal classico abito lungo Ball Tie di Vivienne. Un morbido drappeggio incornicia lo scollo, mentre il tessuto in raso scivola fluido dai fianchi creando un’elegante linea a trapezio, che richiama la bellezza delle statue dell’antica Grecia.","content":"<ul><li>Scollo drappeggiato che scopre le spalle</li><li>Silhouette svasata con corsetto</li><li>Vita stretta</li><li>Cerniera nascosta</li><li>Interno completamente foderato</li><li>Tessuto non elasticizzato</li><li>Prodotto nel Regno Unito</li></ul><ul><li>100% viscosa</li></ul>"}],"productMedia":[{"mediaType":"image","path":"https://manna-public-test.s3.eu-west-1.amazonaws.com/catalog/O11010351-W01GQ-_0.jpg","position":0}]},"colorVariants":[{"colorId":"PLUM","colorDescription":"PLUM","htmlCode":"#5e263e","productEnrichment":{"productCopyColorVariantLevel":[{"dctLanguageId":"it","colorDescription":"PRUGNA"}],"productMediaColorVariantLevel":[{"mediaType":"image","path":"https://manna-public-test.s3.eu-west-1.amazonaws.com/catalog/O11010351-W01GQ-_PLUM_0.jpg","position":0},{"mediaType":"image","path":"https://manna-public-test.s3.eu-west-1.amazonaws.com/catalog/O11010351-W01GQ-_PLUM_1.jpg","position":1}]},"sizeVariants":[{"sku":"O11010351-W01GQ-_PLUM_6","sizeId":"6","variantId":"-","sizeDescription":"6","partnerId":[{"key":"EAN","value":"8053195453047"}],"productEnrichment":{"productCopySkuVariantLevel":[{"dctLanguageId":"it","sizeDescription":"6"}],"productMediaSkuVariantLevel":null},"proposals":[{"skuId":"O11010351-W01GQ-_PLUM_6","productId":"O11010351-W01GQ-","colorId":"PLUM","sizeId":"6","extProposalId":null,"storeId":"VIVIENNE_WESTWOOD_0","active":true,"availableQuantity":10,"price":6010,"finalPrice":6010,"pricesIncludeTax":true,"taxAmount":1083.77,"taxRate":0.22,"discountAmount":0,"discountPercentage":0,"activationDate":null,"expirationDate":null}]}]}]}

Product enrichment is an "optional" step, but a crucial one for maximizing the value of your products. Details are provided in the following paragraph.

AI & Searching

Without product copy & media, your products become effectively "invisible" in the storefront, limiting key functionalities such as search and AI agents.

1. Product Master Data​

The product structure follows a precise hierarchy:

  • Base Product: Represents the finished model in its principal identity. Although the platform does not impose rigid rules, association with certain "Standard Properties" is required (brand, gender, department, model, season). This permits uniform search functionalities, the management of fiscal processes (e.g., Tax Free), and the effective utilization of AI functionalities.

  • Variants: Define minor differences of the model that do not alter its nature and identity (e.g., color variants).

  • SKU: Represents the most granular level, the minimum concrete and sellable unit (e.g., size, fit).

    • It is a univocal identifier within the Platform shared among multiple partners/stores.
    • It is fundamental for key processes such as order fulfillment and inventory updates.
    • It supports the association of multiple internal identifiers (ERP) to facilitate integration with the Brand's systems.

OAuth2_Flow

Note

It is not possible to sell directly a Base Product or a Color Variant, as these include N possible variants.
The "one size" is in all respects one, and the only, variant of a color product.

Product Enrichment​

All assets intended to elevate the perceived value and quality of the product, such as materials, components, images, and videos. It represents the content displayed to the end customer in the app.

  • Contents: Brand Partners can enrich the product autonomously using simple HTML, images, and videos to improve positioning in searches.
  • Images: It is preferable to provide an external reference (URL) to the image management system (e.g., PIM). Alternatively, it is possible to upload images directly onto the Platform (subject to service costs and naming rules).

Override hierarchy​

Enrichment follows an inverse priority relative to the product structure:

  1. A HTML content applied to a SKU overrides that of the variant or model.
  2. An image associated with the Color Variant overrides the default one of the model.

2. Proposal​

The Proposal represents the commercial proposal relating to a product and includes details such as availability and price.

  • Points of sale: It is necessary to specify the store in which the proposal is active. To activate the proposal on multiple stores, the data block must be replicated for each of them.
  • Activation: It is possible to create a proposal in inactive state and render it sellable at a subsequent time.
  • Prices: The proposal must include all amounts necessary for the sale (gross, applied taxes, net, taxable base, promo).
Fiscal Management

The Platform does not perform internal VAT extraction operations, or verifications on the amounts.
It is the Partner's responsibility to provide correct data; the value 0 as price is not permitted.

  • Currency: The local currency of the point of sale is used.

Rate limiting​

EnvironmentRequests / minEntities / min
Dev/Quality∞∞