ReceivePartRequest(String,Int32,Location,Boolean) Method

Causes the specified part request to have units received against it.

This overload takes a set of required parameters for the API.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function ReceivePartRequest( _
   ByVal partRequestDetailIDNum As String, _
   ByVal quantity As Integer, _
   ByVal toLocation As Location, _
   ByVal useTransitions As Boolean _
) As ToolkitResult

public ToolkitResult ReceivePartRequest( 
   string partRequestDetailIDNum,
   int quantity,
   Location toLocation,
   bool useTransitions
)

Parameters

partRequestDetailIDNum: Part Request Detail Identifier
quantity: The number of parts being received for this Part Request
toLocation: Inventory location (or expense GL) into which the stock will be received
useTransitions: Specifies whether or not to change the Part Request condition

Return Value

A ToolkitResult instance with no properties set. The properties (Objid, IDNum, etc.) are not relevant to this API.

Remarks

This API creates the part transaction (including standard costs), part instance records, receive parts records, activity logs and, optionally, generates a time bomb (for business rule notification). This API ensures that the transition from the current condition to the Received condition (for the specified user) is allowed is useTransitions is true (the default), that an inventory location's bin does not have a negative level of any part (except for expense GLs), and part authorization levels for auto-replenishment (and will automatically work with that engine).

This API supports a partial receive similar to the functionality in Clarify (as of Clarify 7.0). If only part of the Part Request is received, this API will create a new part request to handle the rest (unreceived) units of the part request.

To use a primary bin suggestion/recommendation that has been previously configured, use the special constructor for the Location object and set the isPrimaryBinSuggestion parameter to true.

To allow for multiple calls to this API to be performed without extra complex transitions being added to the system, set the UseTransitions property of the ReceivePartRequestSetup object, or the useTransitions parameter of the respective overloads to false. Note that the last call to ReceivePartRequest in the chain of calls should have this value set to true to ensure the transitions are checked and the condition/status is updated properly.

NOTE: This API must be called in conjunction with the PartTransfer API to work correctly.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Reference

LogisticsToolkit Class
LogisticsToolkit Members
Overload List