[taler-docs] branch master updated: clarify API

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 456e6ff  clarify API
456e6ff is described below

commit 456e6ff7b7b327eab17fb7f82f50e5a99d019f53
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Mon Apr 5 22:10:21 2021 +0200

    clarify API
---
 core/api-merchant.rst | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 712bb58..4780302 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -1617,17 +1617,15 @@ Creating orders
       fulfillment_url?: string;
     }
 
-  The following fields can be specified if the order is inventory-based.
-  In this case, the backend can compute the amounts from the prices given
-  in the inventory.  Note that if the frontend does give more details
-  (portions of ``ContractTerms``), this will override those details
-  (including total price) that would otherwise computed based on information
-  from the inventory.
-
-  .. ts:def:: ProductSpecification
-
-    type ProductSpecification : (MinimalInventoryProduct | Product);
-
+  The following `ProductSpecification` can be provided if the parts of the
+  order are inventory-based, that is if the `PostOrderRequest` uses
+  ``inventory_products``. For such products, which must be in the backend's 
inventory,
+  the backend can automatically fill in the amount and other details about
+  the product that are known to it from its ``products`` table.
+  Note that the ``inventory_products`` will be appended to the
+  list of ``products`` that the frontend already put into the ``order``.
+  So if the frontend can sell additional non-inventory products together
+  with ``inventory_products``.
 
   .. ts:def:: MinimalInventoryProduct
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.