Receptions Class Reference

Inheritance diagram for Receptions:

Collaboration diagram for Receptions:

Public Member Functions
	__construct ()
	Constructor.
	get ($id)
	Get properties of a reception object.
	index ($sortfield="t.rowid", $sortorder='ASC', $limit=100, $page=0, $thirdparty_ids='', $sqlfilters='', $properties='')
	List receptions.
	post ($request_data=null)
	Create reception object.
	deleteLine ($id, $lineid)
	Get lines of an reception.
	put ($id, $request_data=null)
	Update reception general fields (won't touch lines of reception)
	delete ($id)
	Delete reception.
	validate ($id, $notrigger=0)
	Validate a reception.
	close ($id, $notrigger=0)
	Classify the reception as invoiced.
Public Member Functions inherited from DolibarrApi
	__construct ($db, $cachedir='', $refreshCache=false)
	Constructor.

Protected Member Functions
	_cleanObjectDatas ($object)
	Clean sensible object datas.
Protected Member Functions inherited from DolibarrApi
	_checkValForAPI ($field, $value, $object)
	Check and convert a string depending on its type/name.
	_filterObjectProperties ($object, $properties)
	Filter properties that will be returned on object.
	_checkFilters ($sqlfilters, &$error='')
	Return if a $sqlfilters parameter is valid Function no more used.

Private Member Functions
	_validate ($data)
	Validate fields before create or update object.

Additional Inherited Members
Static Protected Member Functions inherited from DolibarrApi
static	_checkAccessToResource ($resource, $resource_id=0, $dbtablename='', $feature2='', $dbt_keyfield='fk_soc', $dbt_select='rowid')
	Check access by user to a given resource.
static	_forge_criteria_callback ($matches)
	Function to forge a SQL criteria from a Generic filter string.

Detailed Description

Definition at line 30 of file api_receptions.class.php.

Member Function Documentation

_cleanObjectDatas()

Receptions::_cleanObjectDatas ( $object )

protected

Clean sensible object datas.

Parameters

Object

$object

Object to clean

Returns

Object Object with cleaned properties

Reimplemented from DolibarrApi.

Definition at line 690 of file api_receptions.class.php.

References $object.

Referenced by close(), get(), index(), and validate().

_validate()

Receptions::_validate ( $data )

private

Validate fields before create or update object.

Parameters

array

$data

Array with data to verify

Returns

array

Exceptions

RestException

Definition at line 729 of file api_receptions.class.php.

Referenced by post().

close()

Receptions::close	(		$id,
			$notrigger = 0 )

Classify the reception as invoiced.

Parameters

int

$id

Id of the reception

@url POST {id}/setinvoiced

Returns

int

Exceptions

RestException	400
RestException	401
RestException	404
RestException	405 Create a reception using an existing order.

Parameters

int

$orderid

Id of the order

@url POST /createfromorder/{orderid}

Returns

int

Exceptions

RestException	400
RestException	401
RestException	404
RestException	405 Close a reception (Classify it as "Delivered")

Parameters

int	$id	Reception ID
int	$notrigger	Disabled triggers

@url POST {id}/close

Returns

Object

Definition at line 652 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

delete()

Receptions::delete

(

$id

)

Delete reception.

Parameters

int

$id

Reception ID

Returns

array

Definition at line 485 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource().

deleteLine()

Receptions::deleteLine	(		$id,
			$lineid )

Get lines of an reception.

Parameters

int

$id

Id of reception

@url GET {id}/lines

Returns

int Add a line to given reception

Parameters

int	$id	Id of reception to update
array	$request_data	ShipmentLine data

@url POST {id}/lines

Returns

int Update a line to given reception

Parameters

int	$id	Id of reception to update
int	$lineid	Id of line to update
array	$request_data	ShipmentLine data

@url PUT {id}/lines/{lineid}

Returns

object Delete a line to given reception

Parameters

int	$id	Id of reception to update
int	$lineid	Id of line to delete

Returns

array

@url DELETE {id}/lines/{lineid}

Exceptions

RestException	401
RestException	404

Definition at line 408 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource().

get()

Receptions::get

(

$id

)

Get properties of a reception object.

Return an array with reception information

Parameters

int

$id

ID of reception

Returns

Object Object with cleaned properties

Exceptions

RestException

Definition at line 65 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

index()

Receptions::index	(		$sortfield = "t.rowid",
			$sortorder = 'ASC',
			$limit = 100,
			$page = 0,
			$thirdparty_ids = '',
			$sqlfilters = '',
			$properties = '' )

List receptions.

Get a list of receptions

Parameters

string	$sortfield	Sort field
string	$sortorder	Sort order
int	$limit	Limit for list
int	$page	Page number
string	$thirdparty_ids	Thirdparty ids to filter receptions of (example '1' or '1,2,3') {@pattern /^[0-9,]*$/i}
string	$sqlfilters	Other criteria to filter answers separated by a comma. Syntax example "(t.ref:like:'SO-%') and (t.date_creation:<:'20160101')"
string	$properties	Restrict the data returned to these properties. Ignored if empty. Comma separated list of properties names

Returns

array Array of reception objects

Exceptions

RestException

Definition at line 102 of file api_receptions.class.php.

References _cleanObjectDatas(), DolibarrApi\_filterObjectProperties(), dol_syslog(), and forgeSQLFromUniversalSearchCriteria().

post()

Receptions::post

(

$request_data = null

)

Create reception object.

Parameters

array

$request_data

Request data

Returns

int ID of reception created

Definition at line 181 of file api_receptions.class.php.

References DolibarrApi\_checkValForAPI(), _validate(), and sanitizeVal().

put()

Receptions::put	(		$id,
			$request_data = null )

Update reception general fields (won't touch lines of reception)

Parameters

int	$id	Id of reception to update
array	$request_data	Datas

Returns

Object Object with cleaned properties

Definition at line 445 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource(), DolibarrApi\_checkValForAPI(), and sanitizeVal().

validate()

Receptions::validate	(		$id,
			$notrigger = 0 )

Validate a reception.

This may record stock movements if module stock is enabled and option to decrease stock on reception is on.

Parameters

int	$id	Reception ID
int	$notrigger	1=Does not execute triggers, 0= execute triggers

@url POST {id}/validate

Returns

Object

Definition at line 530 of file api_receptions.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

---

The documentation for this class was generated from the following file:

• dolibarr_20.0/htdocs/reception/class/api_receptions.class.php