Can get thirdparty by email through API Rest

Dolibarr · Oct 19, 2019 · bb70db8 · bb70db8
1 parent 6742700
commit bb70db8
Showing 1 changed file with 70 additions and 30 deletions.
diff --git a/htdocs/societe/class/api_thirdparties.class.php b/htdocs/societe/class/api_thirdparties.class.php
@@ -71,38 +71,26 @@ public function __construct()
 	 *
 	 * @throws 	RestException
 	 */
-    public function get($id)
+  public function get($id)
 	{
-		if(! DolibarrApiAccess::$user->rights->societe->lire) {
-			throw new RestException(401);
-		}
-		if ($id ==0) {
-			$result = $this->company->initAsSpecimen();
-		} else {
-			$result = $this->company->fetch($id);
-		}
-		if( ! $result ) {
-			throw new RestException(404, 'Thirdparty not found');
-		}
-
-		if( ! DolibarrApi::_checkAccessToResource('societe', $this->company->id)) {
-			throw new RestException(401, 'Access not allowed for login '.DolibarrApiAccess::$user->login);
-		}
-
-		if (! empty($conf->global->FACTURE_DEPOSITS_ARE_JUST_PAYMENTS)) {
-			$filterabsolutediscount = "fk_facture_source IS NULL"; // If we want deposit to be substracted to payments only and not to total of final invoice
-			$filtercreditnote = "fk_facture_source IS NOT NULL"; // If we want deposit to be substracted to payments only and not to total of final invoice
-		} else {
-			$filterabsolutediscount = "fk_facture_source IS NULL OR (description LIKE '(DEPOSIT)%' AND description NOT LIKE '(EXCESS RECEIVED)%')";
-			$filtercreditnote = "fk_facture_source IS NOT NULL AND (description NOT LIKE '(DEPOSIT)%' OR description LIKE '(EXCESS RECEIVED)%')";
-		}
-
-		$absolute_discount = $this->company->getAvailableDiscounts('', $filterabsolutediscount);
-		$absolute_creditnote = $this->company->getAvailableDiscounts('', $filtercreditnote);
-		$this->company->absolute_discount = price2num($absolute_discount, 'MT');
-		$this->company->absolute_creditnote = price2num($absolute_creditnote, 'MT');
+    return $this->_fetch($id);
+  }
 
-		return $this->_cleanObjectDatas($this->company);
+	/**
+	 * Get properties of a thirdparty object by email.
+	 *
+	 * Return an array with thirdparty informations
+	 *
+	 * @param string    $sortfield  Sort field
+	 * @return array|mixed data without useless information
+	 *
+	 * @url     GET byEmail/{email}
+	 *
+	 * @throws RestException
+	 */
+	public function getByEmail($email)
+	{
+	    return $this->_fetch('', '', '', '', '', '', '', '', '', '', $email);
 	}
 
 	/**
@@ -1674,4 +1662,56 @@ private function _validate($data)
         }
         return $thirdparty;
     }
+
+  /**
+   * Fetch properties of a thirdparty object.
+   *
+   * Return an array with thirdparty informations
+   *
+   * @param	   int		$rowid      Id of third party to load
+	 * @param    string	$ref        Reference of third party, name (Warning, this can return several records)
+	 * @param    string	$ref_ext    External reference of third party (Warning, this information is a free field not provided by Dolibarr)
+	 * @param    string	$ref_int    Internal reference of third party (not used by dolibarr)
+	 * @param    string	$idprof1		Prof id 1 of third party (Warning, this can return several records)
+	 * @param    string	$idprof2		Prof id 2 of third party (Warning, this can return several records)
+	 * @param    string	$idprof3		Prof id 3 of third party (Warning, this can return several records)
+	 * @param    string	$idprof4		Prof id 4 of third party (Warning, this can return several records)
+	 * @param    string	$idprof5		Prof id 5 of third party (Warning, this can return several records)
+	 * @param    string	$idprof6		Prof id 6 of third party (Warning, this can return several records)
+	 * @param    string	$email   		Email of third party (Warning, this can return several records)
+	 * @param    string	$ref_alias  Name_alias of third party (Warning, this can return several records)
+   * @return array|mixed data without useless information
+   *
+   * @throws RestException
+   */
+  private function _fetch($rowid, $ref = '', $ref_ext = '', $ref_int = '', $idprof1 = '', $idprof2 = '', $idprof3 = '', $idprof4 = '', $idprof5 = '', $idprof6 = '', $email = '', $ref_alias = '')
+  {
+      if(! DolibarrApiAccess::$user->rights->societe->lire) {
+          throw new RestException(401);
+      }
+
+      $result = $this->company->fetch($rowid, $ref, $ref_ext, $ref_int, $idprof1, $idprof2, $idprof3, $idprof4, $idprof5, $idprof6, $email, $ref_alias);
+      if( ! $result ) {
+          throw new RestException(404, 'Thirdparty not found');
+      }
+
+      if( ! DolibarrApi::_checkAccessToResource('societe', $this->company->id)) {
+          throw new RestException(401, 'Access not allowed for login '.DolibarrApiAccess::$user->login);
+      }
+
+      if (! empty($conf->global->FACTURE_DEPOSITS_ARE_JUST_PAYMENTS)) {
+          $filterabsolutediscount = "fk_facture_source IS NULL"; // If we want deposit to be substracted to payments only and not to total of final invoice
+          $filtercreditnote = "fk_facture_source IS NOT NULL"; // If we want deposit to be substracted to payments only and not to total of final invoice
+      } else {
+          $filterabsolutediscount = "fk_facture_source IS NULL OR (description LIKE '(DEPOSIT)%' AND description NOT LIKE '(EXCESS RECEIVED)%')";
+          $filtercreditnote = "fk_facture_source IS NOT NULL AND (description NOT LIKE '(DEPOSIT)%' OR description LIKE '(EXCESS RECEIVED)%')";
+      }
+
+      $absolute_discount = $this->company->getAvailableDiscounts('', $filterabsolutediscount);
+      $absolute_creditnote = $this->company->getAvailableDiscounts('', $filtercreditnote);
+      $this->company->absolute_discount = price2num($absolute_discount, 'MT');
+      $this->company->absolute_creditnote = price2num($absolute_creditnote, 'MT');
+
+      return $this->_cleanObjectDatas($this->company);
+  }
 }