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