1. Implementing Order Management
  2. Include Price, Discounts, and Shipping Charges in Your Payloads

Include Price, Discounts, and Shipping Charges in Your Payloads

Make sure that the values you send in the payloads you use to integrate with various systems include accurate values for price, discounts, and shipping charges.

Starting in update 20A, Order Management multiplies the unit price by the quantity to determine the total amount, then sends the quantity, unit price, and total amount for each discount or shipping charge of the fulfillment line to Accounts Receivable. Receivables doesn't do any calculation. Instead, it uses these values on the invoice or credit memo. This behavior makes the integration between Order Management and Receivables more consistent for the price, discounts, and shipping charges on the item.

You must make sure the values that you send in the payload that you use to integrate with various systems or applications uses this formula:

HeaderCurrencyUnitPrice equals HeaderCurrencyExtendedAmount divided by Quantity

If you don't use this formula, then Order Management might send an incorrect amount to Accounts Receivable for billing. This requirement applies during order import or with any fulfillment task you set up in Order Management that populates charge or charge component data, such as a task that converts shipping cost to billable charges.

For example, assume your payload includes a quantity of 2, unit price of $10, and amount of $30 for a discount. Order Management will send the quantity of 2 and $10 unit price to Receivables. Order Management will ignore the $30 amount and instead calculate the amount as quantity 2 multiplied by unit price of $10 equals $20, then send $20 as a discount to Receivables. Receivables bills the amount as $20, not $30. Order Management applies the same logic for a shipping charge.

Note

  • If the unit price for the discount or shipping charge isn't available, then Order Management uses the same behavior it uses in updates before 20A.

  • If the $10 unit price isn't available for the discount or shipping charge, and if only the $30 amount and quantity of 2 are available, then Order Management sends only the amount and quantity to Receivables. Receivables calculates the unit price as the $30 amount divided by a quantity of 2 equals $15 for the discount.

  • If the fulfillment line contains a service duration, then Order Management doesn't send the unit price for the item, discounts, or shipping charges. This is the same behavior across the current and earlier updates.

  • You must make sure your payload includes a value for the quantity, unit price, and amount. If you don't include these values, then the amount for the discount or shipping charge between the sales order and billing will be different.

Related Topics