Curosa
Supplier Portal API Reference New

Products

Product Imports and Inventory Management

Import, update, and manage your products, stock levels, inbound shipments, and factory inventory.

Product Pricing

Product pricing determines how much you sell your products to Curosa. The Product Pricing section appears once you've added a product to at least one Curosa website, and displays pricing information for each site where the product is available.

Understanding Product Pricing

The price you set is the wholesale price you're selling the product to Curosa for. Curosa is responsible for setting the final retail price shown to customers. The retail price includes:

  • Your wholesale price
  • Platform costs (digital marketing, customer service support, etc.)
  • Delivery costs (if not included in your price)
  • Platform fees and margins

This means you set one price, and Curosa handles all customer-facing pricing decisions.

Editing Product Prices

To edit pricing for a product:

  1. Navigate to the product details page

  2. Locate the Product Pricing section

  3. Click on any price value you want to edit

  4. A modal window will appear with the following fields:

    • Cost Price (tax included) - The price you're selling the product to Curosa for, including tax
    • Purchase Tax Rate - Select the appropriate tax rate from the dropdown menu (based on your supplier currency and location)
    • Pre-order Discount % - Percentage discount applied for pre-orders (defaults from your supplier profile, but can be overridden per product)
    • Factory Stock Discount % - Percentage discount for factory stock orders (defaults from your supplier profile, but can be overridden per product)
  5. Enter or adjust the values as needed

  6. Click Save to apply the changes

Pricing Strategy: Including Delivery Costs

We strongly recommend including your standard delivery costs in your product price. This allows you to offer "free delivery" to customers, which is a significant sales boost and competitive advantage.

How it works:

  • Include your standard delivery cost in the product price
  • The product will be displayed as having "free delivery" to customers
  • Use the Product Delivery Costs section (see below) to add additional charges only for areas where delivery costs are higher than your standard rate

Example: If your standard delivery cost is £5 and your product costs £50, set your product price to £55. Customers will see "free delivery," and you can use delivery cost profiles to add extra charges for remote areas (like Northern Ireland or the Scottish Highlands) where delivery costs more.

This approach allows you to:

  • Offer free delivery to the majority of customers
  • Cover higher delivery costs for remote areas through delivery cost profiles
  • Improve conversion rates (free delivery significantly boosts sales)
  • Maintain profitability across all regions

Product Delivery Costs

While we recommend including standard delivery costs in your product price, you can configure additional delivery charges for specific geographic areas where delivery costs are higher than your standard rate.

How Delivery Cost Profiles Work

For each distribution center where your product is stocked, you can select a Delivery Cost Profile that defines additional delivery charges for specific regions or areas.

Default behavior:

  • Products automatically use your default delivery cost profile (set in your supplier settings)
  • You can override this per product by selecting a different profile
  • If no profile is selected, only the delivery cost included in your product price applies

Setting Up Delivery Costs

  1. Navigate to the product details page
  2. Locate the Product Delivery Costs section
  3. For each distribution center, select the appropriate Delivery Cost Profile from the dropdown
  4. The selected profile will apply additional delivery charges for the regions it covers

When to Use Delivery Cost Profiles

Delivery cost profiles are ideal for handling geographic variations in delivery costs. Common scenarios include:

UK Example:

  • Standard delivery to England, Wales, and Southern Scotland: Included in product price (free delivery)
  • Delivery to Northern Ireland: Higher cost due to ferry charges
  • Delivery to Scottish Highlands and Islands: Higher cost due to remote location

In this case, you would:

  1. Include standard UK delivery cost in your product price (offering free delivery)
  2. Create a delivery cost profile that adds extra charges for Northern Ireland and Scottish Highlands/Islands
  3. Apply this profile to products that ship from relevant distribution centers

Benefits:

  • Offer free delivery to the majority of customers
  • Cover higher costs for remote areas without losing money
  • Maintain competitive pricing in main markets
  • Improve sales conversion (free delivery is a major sales driver)

Managing Delivery Cost Profiles

You can create and manage delivery cost profiles in your Settings section. Each profile can define:

  • Specific geographic regions or postcodes
  • Additional delivery charges for those areas
  • Different rates for different distribution centers

See the "Managing Delivery Cost Profiles" documentation in the Settings section for detailed setup instructions.

Tip: Free delivery is a significant sales boost. By including standard delivery in your product price and using delivery cost profiles only for high-cost areas, you maximize your competitive advantage while maintaining profitability.

Distribution Centre, Inbound and Factory Stock Pricing

Curosa's tiered pricing system allows you to offer different prices based on where your stock is located and how quickly it can be delivered. This powerful strategy helps you maximize sales, manage inventory efficiently, and offer customers flexible delivery options at different price points.

Understanding Stock Location Pricing

Products can be available from three different stock locations, each with different delivery times:

  1. Distribution Centre Stock - Stock already in the distribution centre, ready for immediate shipment
  2. Inbound Shipment Stock - Stock currently in transit to the distribution centre (on an inbound shipment)
  3. Factory Stock - Stock still at the factory, not yet shipped to the distribution centre

How Tiered Pricing Works

You can set discount levels on the product record to reflect the lower costs incurred for stock that isn't stored in the distribution centre. This creates a pricing structure that rewards customers for choosing longer delivery times while protecting your immediate-availability inventory.

Pricing Strategy:

  • Distribution Centre Stock - Premium price (no discount) for customers who want immediate delivery
  • Inbound Shipment Stock - Slight discount for customers willing to wait for stock arriving soon
  • Factory Stock - Increased discount for customers willing to wait the longest for factory stock

Curosa Discount Matching

Important: Curosa will match any discount percentage you offer by reducing their own margin by the same percentage. This means when you offer a discount, Curosa shares the discount with customers by reducing their profit margin proportionally, resulting in better prices for customers.

How it works:

Curosa applies a margin to your supplier price to determine the customer price. When you offer a discount:

  1. Your discount reduces the supplier price - If you offer 10% discount, Curosa pays you 10% less
  2. Curosa matches by reducing their margin - Curosa reduces their margin percentage by the same amount (e.g., if their margin is 30%, they reduce it by 10% to 20%)
  3. Customer receives a better price - The combination of your discount and Curosa's margin reduction results in a lower customer price

Example:

  • Base scenario: Supplier price £100, Curosa margin 30% → Customer price £130
  • With 10% supplier discount: Supplier price £90, Curosa margin reduced to 20% → Customer price £108

The customer receives a discount of £22 (from £130 to £108), which is approximately 17% off the original customer price. This is more than your 10% supplier discount because Curosa has also reduced their margin.

Key points:

  • Curosa matches your discount percentage by reducing their margin by the same percentage
  • This applies to both Pre-order Discount % and Factory Stock Discount %
  • Customers receive better prices than they would from your discount alone
  • This matching program helps incentivize customers to choose longer delivery times

This matching program significantly increases the value proposition for customers choosing longer delivery times, helping you move inventory more effectively while customers enjoy greater savings.

Benefits of Tiered Pricing

This strategy maximizes your selling potential in several ways:

1. Protect Immediate Stock

  • Charge a premium for distribution centre stock (ready for immediate shipment)
  • This ensures you don't sell out of your fastest-moving inventory too quickly
  • Customers who need items urgently are willing to pay more for immediate availability

2. Maximize Sales Across All Stock Levels

  • Offer slight discounts for inbound shipment stock to incentivize customers to wait
  • This helps move stock that's already in transit, improving inventory turnover
  • Customers get a better price for slightly longer wait times

3. Clear Factory Inventory

  • Offer increased discounts for factory stock (longest wait time)
  • This helps move inventory that hasn't been shipped yet, reducing storage costs
  • Customers willing to wait the longest get the best prices

4. Customer Choice and Flexibility

  • Customers can choose their preferred balance of price vs. delivery speed
  • More price-sensitive customers can save money by waiting
  • Urgent customers can pay premium for immediate delivery

Setting Up Stock Location Discounts

To configure discounts for different stock locations:

  1. Navigate to the product details page
  2. Locate the Product Pricing section
  3. Click on the price to open the pricing modal
  4. Set the discount percentages:
    • Pre-order Discount % - Discount for inbound shipment stock (stock on the way to distribution centre)
    • Factory Stock Discount % - Discount for factory stock (stock not yet shipped)

Example Pricing Structure:

Assuming Curosa applies a 30% margin:

  • Base price: Supplier £100
  • Distribution Centre Stock: Supplier £100 (0% discount) → Customer pays £130 (0% customer discount) - Immediate delivery
  • Inbound Shipment Stock: Supplier £95 (5% discount, Curosa margin reduced to 25%) → Customer pays £118.75 (8.7% customer discount) - Delivery in 1-2 weeks
  • Factory Stock: Supplier £90 (10% discount, Curosa margin reduced to 20%) → Customer pays £108 (16.9% customer discount) - Delivery in 3-4 weeks

Note: The customer prices reflect both your supplier discount and Curosa's matching margin reduction. Curosa reduces their margin percentage by the same amount as your discount percentage, resulting in better customer prices than your discount alone would provide. The exact customer discount percentage depends on Curosa's base margin.

Stock Visibility Rules

Important: If you do not set discounts for inbound or factory stock, these stock levels will not be visible to customers unless you have run out of stock in the distribution centre.

How it works:

  • With discounts set: All available stock locations are shown to customers with their respective prices and delivery times
  • Without discounts set: Only distribution centre stock is shown until it runs out, then inbound/factory stock becomes visible

Best Practice: Always set discounts (even small ones) for inbound and factory stock to maximize visibility and sales opportunities. This ensures customers can see all available options and make informed purchasing decisions.

Strategic Considerations

When setting your discount levels, consider:

  • Your storage costs - Higher discounts for factory stock reflect lower storage costs
  • Customer demand patterns - How price-sensitive are your customers?
  • Inventory levels - Use discounts to balance stock across all locations
  • Competitive positioning - Ensure your pricing remains competitive while maximizing revenue

Example Strategy:

  • Distribution Centre: 0% discount (premium for immediate delivery)
  • Inbound Shipment: 3-5% discount (Curosa matches by reducing their margin proportionally)
  • Factory Stock: 8-12% discount (Curosa matches by reducing their margin proportionally)

This creates a clear value proposition: customers pay more for speed, or save money by waiting. Remember that Curosa matches your discounts by reducing their margin, so customers receive better prices than your discount alone would provide, making longer delivery times more attractive.

Tip: Start with conservative discounts and adjust based on sales data. Monitor which stock locations sell fastest and adjust your discount strategy accordingly. Remember, even small discounts can significantly increase sales volume for slower-moving stock.