Create Product in Universal Bank - Venddor API

← Back to API Documentation
POST {{baseUrl}}/Products

This endpoint allows you to create products in the Universal Bank. The Universal Bank is a central repository of product information that sellers can then use to list products for sale.

Important: Marketplace administrator credentials are required to use this endpoint.

Request Headers

Header Value Description
Authorization Basic Auth Base64 encoded username:password combination

Request Body Parameters

The request body should contain an array of products to create. You can send up to 60 products per request.

Parameter Type Required Description
product_code* string Yes Universal product code (barcode)
ncm string No NCM tax classification code
product* string Yes Product name
brand string No Brand name
category_ids* array Yes Array of category IDs the product belongs to
main_category* number Yes Primary category ID
weight string No Product weight in grams
amount* string Yes Quantity available in stock
qty_step string No Minimum quantity increment (default: "1")
status* string Yes Product status: "A" (active), "D" (disabled), or "H" (hidden)
product_features object No Object containing product features as key-value pairs, where keys are feature IDs and values are the feature values

Example Request

[
  {
    "product_code": "7891404130314",
    "ncm": "18069000",
    "product": "Disney Footwear",
    "brand": "Disney",
    "category_ids": [
      1384,
      1792
    ],
    "main_category": 1384,
    "weight": "180",
    "amount": "230",
    "qty_step": "1",
    "status": "A",
    "product_features": {
      "16": "94",
      "14": "95",
      "20": "Masculino",
      "18": "Disney",
      "9": "36,6cm",
      "8": "23,6cm",
      "19": "31,7cm",
      "4": "0,41kg",
      "7": "PVC"
    }
  }
]

Response

The endpoint returns the ID of the newly created product(s).

Example Response

{
  "product_id": 973732,
  "product_ids": [
    973732
  ]
}
Note: When sending multiple products in a single request, the product_ids array will contain all the created product IDs, and product_id will contain the ID of the last created product.
Tip: To optimize performance, send products in batches of up to 60 products per request. For example, if you need to create 240 products, make 4 separate requests with 60 products each.