Alephee developers portal
  • Introduction
    • 📘API documentation
      • Introduction to integrations
    • ⚙️Using the API
      • 🔒Authentication
      • 🏹Swagger
    • 📡Overall index of methods
  • Usage limiting
    • 🕑Rate limiting
    • 🔃Limits per request
    • ♒Limits HTTP headers responses
    • ⚠️Usage limits by endpoint
  • Accounts
    • GET methods
      • Accounts
        • ⚠️Usage limiting
        • ⬆️Request and Respone
        • ⌨️Type specifications
        • ⚙️Examples
      • Marketplaces
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • Price Lists
        • ⚠️Usage limiting
        • ⬆️Request and Responses
        • ⌨️Type specifications
        • ⚙️Examples
      • Stores
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • Login Token
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • 📊Business rules
        • Standard usage flow for Alephee B2B portal
        • ⌨️Type specifications
        • ⚙️Examples
    • PUT methods
      • Update account fiscal tax rules
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
  • Orders
    • Logical model
      • ℹ️What is an order?
      • 📂Order model overview
      • 🛒Shopping cart orders
        • 🔳Cart order model overview
        • 〽️Mercado Libre’s shopping cart orders
      • 💴Approved payments and pending payments
      • 🗒️General notes
    • GET methods
      • 👩‍💻Orders
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
        • ⁉️Useful tips
      • 🛒Orders List From A Shopping Cart
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • 📄Orders Document
        • ⚠️Usage limiting
        • ⬆️Request and Response
      • 🧾Order Shipping Label
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⚙️Examples
    • PUT methods
      • 📑Update orders status
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • 👨‍💼Mark orders as integrated
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • POST methods
      • 📑Attach document to an order
        • ⚠️Usage limiting
        • Allowed document types and formats
        • ⬆️Request and Response
        • ⚙️Examples
        • ⚙️Example using POSTMAN via form-data
        • ⚙️Example using POSTMAN via JSON body
      • 📑Split an order
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
      • 📨Send a message to a buyer
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⚙️Examples
      • 📝Create a new order
        • ⚠️Usage limiting
        • Introduction
        • 📊Business rules
        • 📑Order mandatory sections
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • DELETE methods
      • 📑Delete an order
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⚙️Examples
  • Orders shipping
    • GET methods
      • Shipping Packaging Information
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • Shipping Scheduling Information
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • Shipping Transportation Information
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • POST methods
      • Set Shipping Packaging Information
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⚙️Examples
  • Products
    • GET methods
      • Products
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • POST methods
      • Logical model
      • Business Rules
        • Prices considerations
        • Available prices attributes combinations to set prices
        • Stock considerations
        • Alephee B2B portals prices and stock considerations
        • Measurable quantity and price considerations
      • Update Products
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • PUT methods
      • Update product fiscal information
        • ⚠️Usage limiting
        • 🗒️Notes
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • DELETE methods
      • Delete products from a price list
        • ⚠️Usage limiting
        • 📊Business rules
        • ‼️Warnings
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⌨️Result type specifications
        • ⚙️Examples
        • Most common validation error messages and how to fix them.
  • Product listings
    • GET methods
      • Product Listings
        • ⚠️Usage limiting
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • POST methods
      • Set product listings discounts
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
    • PUT methods
      • Update product listings
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
      • Set product listings status
        • ⚠️Usage limiting
        • 📊Business rules
        • ⬆️Request and Response
        • ⌨️Type specifications
        • ⚙️Examples
  • GLOSSARY
    • Conventions
    • Response status codes
    • Marketplaces/Channels ID and names list
    • Product listings status list
    • Orders and shipping glossary
      • Available order statuses codes
      • State transitions diagram
      • Automatic and manual order status updates
      • Attaching documents to orders
      • Shipping labels
  • TROUBLESHOOTING
    • ❗Important tips
    • ✅Best integrations practices
Powered by GitBook
On this page
  • Product
  • ProductPrice
  • ProductStock
  • ProductStockAlert
  • ProductFeatures
  • ProductMeasurableQuantity
  • ProductMeasurablePrice
  • ActionResult
  • ActionResultQuantities
  • ItemResult
  • ValidationMessage

Was this helpful?

  1. Products
  2. POST methods
  3. Update Products

Type specifications

Response from the API endpoint...

Product

Property
Type
Description

Brand

string

Product brand

SKU *

string

Product SKU

Stock

Stock details

Price

Price details

Features

Product features details

ProductPrice

Property
Type
Description

Price

decimal?

Price before taxes

PriceWithTaxes

decimal?

Price after taxes

Already include taxes value.

SuggestedRetailPrice

decimal?

Suggested retail price

SalesMargin

decimal?

Sales margin to apply to the product price or suggested retail price.

Cost

decimal?

Product cost (purchasing cost, manufacturing cost, etc).

B2BDiscountRate

decimal?

Extra discount rate for the product. (Only for Alephee B2B portals)

MeasurablePriceWithTaxes

Product measurable price with taxes.

This object is intended to replace the other price fields, using measurable price. It should only be used by those accounts that work with measurable products, such as supermarkets and other similar-type accounts.

DO NOT USE this object unless you are absolutely certain that your products use measurable quantities.

ProductStock

Property
Type
Description

Quantity

integer?

Set the current product available stock.

Movement

integer?

Sets and executes a stock inventory movement on the current product’s stock.

Positive integer values ADD the movement quantity to the product stock.

Negative integer values SUBSTRACT the movement quantity to the product stock.

(Please note that the GET product method does not return this value.)

MinPublicationQuantity

integer?

Set the minimum stock to pause the marketplace’s publications (if any) that belongs to the product.

By default, Alephee pauses the product’s product listings when the stock value reach zero units.

Can only be used when accountID belongs to a seller or official store Alephee’s account type.

MaxPublicationQuantity

integer?

Set the maximum stock to set on the marketplace’s publication.

Can only be used when accountID belongs to a seller or official store Alephee’s account type

B2BQuantity

integer?

Set the current product available stock for the B2B portal.

(Only for Alephee B2B portals)

Alert

Stock alert details.

(Only for Alephee B2B portals)

Measurable quantity

ProductMeasurableQtyType?

Product measurable quantity.

This object is intended to replace the other stock fields, using measurable quantities. It should only be used by those accounts that work with measurable products, such as supermarkets and other similar-type accounts.

DO NOT USE this object unless you are absolutely certain that your products use measurable quantities.

PublishQuantity

Obsolete and deprecated. Do not use this attribute because it has no effect.

Regardless of whether this attribute appears in Swagger document, it should not be used.

ProductStockAlert

Property
Type
Description

RedQty

integer?

Red Quantity

(Only for Alephee B2B portals)

YellowQty

integer?

Yellow Quantity

(Only for Alephee B2B portals)

ProductFeatures

Property
Type
Description

Visibility

integer?

Sets the product visibility.

(Only for Alephee B2B portals)

Allowed values are:

0 = Product not visible.

1 = Product visible.

2 = Product visible, but not purchasing allowed.

ProductMeasurableQuantity

Property
Type
Description

Quantity

decimal

The decimal numeric quantity

Unit

string

The measurement unit of the quantity. Available values are:

Mass units:

"kg", "g", "mg", "cg", "mcg", "t", "lb", "lbs", "oz"

Length units:

"m", "mi", "yd", "km", "hm", "dm", "cm", "mm", "ft", "in", "nm"

Pressure units:

"bar", "psi", "atm", "pa", "at"

ProductMeasurablePrice

Property
Type
Description

Price

decimal

The decimal numeric quantity

Unit

string

The measurement unit of the quantity. Available values are:

Mass units:

"kg", "g", "mg", "cg", "mcg", "t", "lb", "lbs", "oz"

Length units:

"m", "mi", "yd", "km", "hm", "dm", "cm", "mm", "ft", "in", "nm"

Pressure units:

"bar", "psi", "atm", "pa", "at"

ActionResult

Property
Type
Description

Quantities

ActionResultQuantitiesType

Quantity Totals

Items

Items result details

ActionResultQuantities

Property
Type
Description

Total

integer

Total Products Processed

Ok

integer

Ok Products quantity

Error

integer

Products with errors quantity

Warning

integer

Products with warnings quantity

Info

integer

Products with information quantity

ItemResult

Property
Type
Description

ItemNumber

integer

Item number

ValidationLevel

{

Id (integer),

Name(string)

}

Worst validation Level

99 = Ok,

2 = Info, 1 = Warning,

0 = Error

KeyField

string

Fixed: SKU

KeyValue

string

Product SKU

Messages

Validation Messages

ValidationMessage

Property
Type
Description

Level

{

Id (integer), Name(string)

}

Severity Level:

99 = Ok,

2 = Info,

1 = Warning, 0 = Error

Code

integer

Unique error code

Message

string

Error description

ValidatedValue

string

Validated Value (ex: Price, Sky, Qty)

PreviousRequest and ResponseNextExamples

Last updated 6 months ago

Was this helpful?

⌨️
ProductStock
ProductPrice
ProductFeatures
ProductMeasurablePrice
ProductStockAlert
ItemResult
ValidationMessage