-
Web Service URL: https://[SERVER_ADDRESS]/SupplierOrdersWS/SupplierOrdersData.asmx
-
MPS Version: From 5.3.0
Description
This method marks items in a shipment with the status Dispatched or In Transit as received, provided the shipment was requested from the supplier.
Syntax
public string ReceiveItems(int supplierID, string supplierUserEmail, string supplierUserPassword, int shipmentID, string dateReceived, string utc, string shipmentItemList, string comments)
Parameters
-
supplierID: Supplier ID in the system;
-
supplierUserEmail: Supplier contact email;
-
supplierUserPassword: Encrypted password for the supplier contact;
-
shipmentID: ID of the shipment for which the items are being received;
-
dateReceived: Date (Format: yyyy-MM-dd HH:mm:ss) when the item was actually received; the date provided must be between the date the shipment was forwarded and the current date, otherwise the error ERR_SHIPMENT_INVALIDSENTDATE will be returned;
-
utc: UTC value for the location corresponding to the item’s receipt date, which must be entered with decimal places separated by a period. Example: -3.0;
-
It is important to be aware of UTC variations if daylight saving time is in effect. Example: In Brazil, the standard UTC is -3.0, but during daylight saving time it is -2.0.
-
-
shipmentItemList: List containing the identifiers (shipmentItemID) of the items to be received and their serial numbers, separated by “;” and “|”. Example: 15;SN0001|16;SN0002|17;SN00003;
-
It is not necessary to list all items.
-
-
comments: Additional information regarding the receipt of the items.
Return
Click here to learn more about the return format.
Getting UTC, example in .NET
-
TimeZone zone = TimeZone.CurrentTimeZone;
-
TimeSpan offset = zone.GetUtcOffset(DateTime.Now);
-
string utc = offset.Hours + “.” + offset.Minutes;
Possible errors returned
Click here to check the possible errors that may be returned and learn their reasons.
Restrictions
-
To receive the items, the delivery must have the status Forwarded or In Receipt.