NEW Get a payment list of a given invoice using the REST API

Add the getpayments method to retrieve a list of payments of a given invoice

htdocs/compta/facture/class/api_invoices.class.php

@@ -665,6 +665,47 @@ class Invoices extends DolibarrApi
     }
 
 
+    /**
+     * Get a payment list of a given invoice
+     *
+     * @param int   $id             Id of invoice
+     *
+     * @url     GET {id}/getpayments
+     *
+     * @return array
+     * @throws 400
+     * @throws 401
+     * @throws 404
+     * @throws 405
+     */
+    function getPayments($id) {
+
+        if(! DolibarrApiAccess::$user->rights->facture->creer) {
+                throw new RestException(401);
+        }
+        if(empty($id)) {
+                throw new RestException(400, 'Invoice ID is mandatory');
+        }
+
+        if( ! DolibarrApi::_checkAccessToResource('facture',$id)) {
+                throw new RestException(401, 'Access not allowed for login '.DolibarrApiAccess::$user->login);
+        }
+
+        $result = $this->invoice->fetch($id);
+        if( ! $result ) {
+                throw new RestException(404, 'Invoice not found');
+        }
+
+        $result = $this->invoice->getListOfPayments();
+        if( $result < 0) {
+                throw new RestException(405, $this->invoice->error);
+        }
+        
+        return $result;
+    }
+
+
+
     /**
      * Clean sensible object datas
      *