Prices considerations
⢠All informed price fields values must NOT be empty nor 0 (zero). All values should be of as higher value than 0 (zero). Do NOT use a zero or negative price value. ⢠All the price fields formats must be a decimal number with a period (.) as a decimal notation, no notation is needed for thousands or millions. The maximum number of decimal digits is 4. For example, 1288.44, 7430 or 7430.00. ⢠The 'Price' (without taxes) and 'PriceWithTaxes' fields must NOT be informed at the same time. It must be one or the other. ⢠The Cost field wonât be mandatory. ⢠The 'SuggestedRetailPrice' field wonât be mandatory. ⢠It will be assumed that the indicated value on the 'SuggestedRetailPrice' field already contains the proportional TAX. ⢠The 'SalesMargin' field wonât be mandatory. Only seller type accounts may inform this value. ⢠The 'SalesMargin' field format must be a decimal number with a period (.) as a decimal notation, no notation is needed for thousands or millions. The maximum number of decimal digits is 2. For example, 25.50, 30 or 45.00. â˘The âMeasurable price with taxesâ 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. ⢠It is mandatory to inform at least ONE of the price fields: 'Price' or 'PriceWithTaxes' or 'SuggestedRetailPrice' or 'SalesMargin' or âCostâ or âMeasurable price with taxesâ. Let us brief a table with a summary of the available price attributes and when to use them:
Price (without taxes)
PriceWithTaxes
Can use this attribute: Yes.
When: Always.
Can use this attribute: No.
When: Always.
Exceptions: Very few and rare cases depending on the wholesaler and seller relation settings.
SuggestedRetailPrice
Can use this attribute: Yes.
When: Always.
Can use this attribute: Yes.
When:
1. When the seller is disconnected from a wholesaler-type account and its product catalog.
2. When the seller is connected to a wholesaler-type account and its product catalog, but the account configuration is set to âdisconnected price modeâ.
Can use this attribute: No.
When:
1. When the seller is connected to a wholesaler-type account and its product catalog, and the account configuration is set to âconnected price modeâ.
Cost
Can use this attribute: No.
When: Never.
Can use this attribute: Yes.
When:
1. When the seller is disconnected from a wholesaler-type account and its product catalog.
2. When the seller is connected to a wholesaler-type account and its product catalog, but the account configuration is set to âdisconnected price modeâ.
Can use this attribute: No.
When:
1. When the seller is connected to a wholesaler-type account and its product catalog, and the account configuration is set to âconnected price modeâ.
SalesMargin
Can use this attribute: No.
When: Never.
Can use this attribute: Yes.
When: Always.
a) When the seller is connected to a wholesaler-type account and its product catalog, and the account configuration is set to âconnected price modeââŚ.
The sales margin will apply to the âCostâ value informed by the wholesaler.
b) When the seller is disconnected from a wholesaler-type account and its product catalogâŚ
The sales margin will apply to the âCostâ or âSuggestedRetailPriceâ value informed by the seller. Depends on the account settings.
c) When the seller is connected to a wholesaler-type account and its product catalog, but the account configuration is set to âdisconnected price modeâ.
The sales margin will apply to the or âCostâ or âSuggestedRetailPriceâ value informed by the seller. Depends on the account settings.
Measurable price with taxes
Can use this attribute: No.
When: Never.
Can use this attribute: Yes.
When: Always.
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.
Last updated
Was this helpful?