Order: difference of net_amount_due_money and total_money fields

Reading Order Object - Square API Reference,
can you please add updated documentation or this page to explain how these are different? Or link to a guide which does?

total_money
Read only The total amount of money to collect for the order

net_amount_due_money
Read only The net amount of money due on the order.

I could imagine one gross and one net, and the difference is discounts. But “money to collect” sure sounds like it would be after discounts. Please help us understand when this differs, thanks!

There is also net_amounts (an object) which is clear. It applies after refunds.

net_amounts
Read only The net money amounts (sale money - return money).

I could also imagine e.g. if a payment has been applied but money is still owed, then they might differ. This guide Orders API: How It Works could have a sentence added here to explain it:

In the response, the gross_sales_money elements reflect the item totals, while net_amount_due_money reflects the subtotal for the order ($116.00). [INSERT HERE: The total_money matches the net amount because [reason] although other times [it would not because].]

EDIT: looking at some other example orders I see one (it was a refund exchange order created in app) with a total_money of >0 and net_amount_due_money = 0. That is a case when they differ. Maybe when the order is paid in full net_amount_due_money will change to 0? Whatever the case it really could be documented on the API reference, please. Any guarantees about mutability vs immutability and how it may change based on the state of the order would be helpful in the docs too.

3 posts - 2 participants

Read full topic