ReceivingServicesReceiveMaterials Method

Records a new shipment of material as received in the system. If a material purchase order is specified and is known to the system, the shipment will be recorded against the appropriate line item. If the received part has a defined receiving process, a receiving batch (GRN) will be generated by the system associated to the appropriate receiving process, and returned by this method. If there is no defined receiving process, the return value of the method will be null.

Namespace: FactoryLogix.xTend.Logistics
Assembly: FactoryLogix.xTend.API (in FactoryLogix.xTend.API.dll) Version: 8.242.0.0 (8.242.0.0)

Syntax

C++

Copy

public Batch ReceiveMaterials(
	Guid sessionId,
	ReceivedMaterial material,
	bool allowAlternatePart = false,
	FileContent[] dataFiles = null
)

Public Function ReceiveMaterials ( 
	sessionId As Guid,
	material As ReceivedMaterial,
	Optional allowAlternatePart As Boolean = false,
	Optional dataFiles As FileContent() = Nothing
) As Batch

public:
virtual Batch^ ReceiveMaterials(
	Guid sessionId, 
	ReceivedMaterial^ material, 
	bool allowAlternatePart = false, 
	array<FileContent^>^ dataFiles = nullptr
) sealed

abstract ReceiveMaterials : 
        sessionId : Guid * 
        material : ReceivedMaterial * 
        ?allowAlternatePart : bool * 
        ?dataFiles : FileContent[] 
(* Defaults:
        let _allowAlternatePart = defaultArg allowAlternatePart false
        let _dataFiles = defaultArg dataFiles null
*)
-> Batch 
override ReceiveMaterials : 
        sessionId : Guid * 
        material : ReceivedMaterial * 
        ?allowAlternatePart : bool * 
        ?dataFiles : FileContent[] 
(* Defaults:
        let _allowAlternatePart = defaultArg allowAlternatePart false
        let _dataFiles = defaultArg dataFiles null
*)
-> Batch

Parameters

sessionId: Type: SystemGuid
The session identifier that was returned by the Connect(String, String, String, String, String) method.
material: Type: FactoryLogix.xTend.DataObjectsReceivedMaterial
A list of ReceivedMaterial objects providing details for the materials that were received.
allowAlternatePart (Optional): Type: SystemBoolean
A boolean flag to verify that the given internal part number is a valid alternate part to the internal part number linked to the purchase order line item.
dataFiles (Optional): Type: FactoryLogix.xTend.DataObjectsFileContent
One of more data files (defined by an FileContent object, containing scans of delivery note papers.

Return Value

Type: Batch
A Batch representing the newly created GRN associated to the receiving process for the received material, or null if the specified material does not have a defined receiving process.

Exceptions

Exception	Condition
ArgumentException	Thrown if the material is invalid.
InvalidSessionException	Thrown if the sessionId parameter is invalid.
NotFoundException	Thrown if the purchase order number is supplied and not found in the system.
ReceivingException	Thrown if the one or more of the properties of the specified ReceivedMaterial is invalid. Thrown if there is an error processing the ReceivedMaterial's UnitOfIssue. The ErrorType property of the exception contains details on the nature of the error.

Reference

ReceivingServices Class

FactoryLogix.xTend.Logistics Namespace

ReceivingServicesAddLanguageSpecificTextSet("LST8E1DC7AC_0?cpp=::|nu=.");ReceiveMaterials Method

Parameters

Return Value

Reference

ReceivingServicesReceiveMaterials Method