Skip to main content

Price Helpers

Helpers for Mapping Supplier Price Data​

To accurately map prices data to our internal model, you can use one of the following helper methods depending on the supplier data format:

BuildNetPrice​

Use this method when the supplier provides a net price with no commission.

public static Price BuildNetPrice(Currency currency, double net, double minimumPrice)
{
  return new Price(
    currency, 
    Price.CalculateBindingFromMinimumPrice(minimumPrice), 
    net, 
    net, 
    minimumSellingPrice: minimumPrice);
}

//Example of how should it be implemented:

// Sample data
Currency currency = Currency.USD; // Example enum value
double netAmount = supplier.NetPrice; // "150.00" Net price given by the supplier
double mspAmount = supplier.MinimumSellingPrice; // "170.00" Minimum selling price given by the supplier

// Method call

Price price = Price.BuildNetPrice(currency, netAmount, mspAmount);

BuildGrossWithCommissionPrice​

Use this method when the supplier provides gross price with commission.

public static Price BuildGrossWithCommissionPrice(
  Currency currency,
  double gross,
  double commission,
  double minimumPrice,
  double priceSurchargesIncluded = 0.0)
{
  if (commission > 1.0 || commission < 0.0)
  {
    throw new ArgumentException("Commission should have a value between 0 and 1");
  }
  double net = Price.CalculateNetFromGrossAndCommission(gross - priceSurchargesIncluded, commission) + priceSurchargesIncluded;
  return new Price(currency, Price.CalculateBindingFromMinimumPrice(minimumPrice), net, gross, minimumSellingPrice: minimumPrice);
}

//Example of how should it be implemented:

// Sample data
Currency currency = Currency.USD; // Example enum value
double grossAmount = supplier.GrossPrice; // "170.00" Gross price given by the supplier
double commission = supplier.Commisison; // "0.1176" Commission fraction given by the supplier
double minimumPrice = supplier.MinimumSellingPrice; // "170.00" Minimum selling price given by the supplier

// Method call

Price price = Price.BuildGrossWithCommissionPrice(currency, grossAmount, commission, minimumPrice);

BuildGrossUnknownNetPrice​

Use this method when the supplier does return the gross without commission.

public static Price BuildGrossUnknownNetPrice(
  Currency currency,
  double gross,
  double minimumPrice)
{
  return new Price(
    currency, 
    Price.CalculateBindingFromMinimumPrice(minimumPrice), 
    0.0, 
    gross, 
    false, 
    minimumPrice);
}

// Example of how should it be implemented:

// Sample data
Currency currency = Currency.USD; // Example enum value
double grossAmount = supplier.GrossPrice; // "170.00" Gross price given by the supplier
double minimumPrice = supplier.MinimumSellingPrice; // "170.00" Minimum selling price given by the supplier

// Method call
Price price = Price.BuildGrossUnknownNetPrice(currency, grossAmount, minimumPrice);

BuildNetGrossPrice​

Use this method when the supplier returns both net and gross prices.

public static Price BuildNetGrossPrice(
  Currency currency,
  double net,
  double gross,
  double minimumPrice)
{
  return new Price(
    currency, 
    Price.CalculateBindingFromMinimumPrice(minimumPrice), 
    net, 
    gross, 
    minimumSellingPrice: minimumPrice);
}

// Example of how should it be implemented:

// Sample data
Currency currency = Currency.USD; // Example enum value
double grossAmount = supplier.GrossPrice; // "170.00" Gross price given by the supplier
double netAmount = supplier.NetPrice; // "150.00" Net price given by the supplier
double minimumPrice = supplier.MinimumSellingPrice; // "170.00" Minimum selling price given by the supplier

// Method call
Price price = Price.BuildNetGrossPrice(currency, grossAmount, minimumPrice);