Breadcrumbs

ReceiveItems

  • Web Service URL: https://[SERVER_ADDRESS]/StockOrdersWS/StockOrdersData.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 Distribution Center.

Syntax 

public string ReceiveItems(string dealerName, string dealerUserEmail, string dealerUserPassword, int shipmentID, string dateReceived, string utc, string shipmentItemList, string comments)

Parameters

  • dealerName: Provider name;

  • dealerUserEmail: Provider user's email address;

  • dealerUserPassword: Encrypted user password;

  • shipmentID: Identifier 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 points 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 of the identifiers (shipmentItemID) for the forwarded items to be received, separated by “;”. Example: 15;16;17;

    • It is not necessary to list all items.

  • comments: Additional information regarding the receipt of the delivery 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 execute this method, the specified user must have Restricted or Full responsibility assigned by the supplier (Distribution Center);

  • The delivery must have the status Dispatched or In Receipt, and the item to be received must have the status Dispatched.