2Service Services API

<back to all web services

GetShipment

The following routes are available for this service:
GET/dealers/shipment/{ShipmentId}Retrieves shipment based on it's ID.
GetShipment Parameters:
NameParameterData TypeRequiredDescription
ShipmentIdpathintYesShipment ID to retrieve the status for.
AuthenticatedRequest Parameters:
NameParameterData TypeRequiredDescription
SessionTokenquerystringYesSession token received from successful authentication.
OperationResult<T> Parameters:
NameParameterData TypeRequiredDescription
ResultmodelTNoResult value
OperationResult Parameters:
NameParameterData TypeRequiredDescription
IsSuccessfulmodelboolNoSpecifies if the operation was successful.
ErrorMessagemodelstringNoStates error message in case of unsuccessful operation.
ShipmentResult Parameters:
NameParameterData TypeRequiredDescription
ShipmentIdformintNoID of the shipment.
HasBeenDispatchedformboolNoDetermines of the shipment has been dispatched.
DispatchDateformDateTime?NoDate/time of dispatch.
ArticlesformList<ShipmentArticleResult>NoList of articles in shipment.
PackagesformList<ShipmentPackageResult>NoList of packages for shipment.
ShipmentArticleResult Parameters:
NameParameterData TypeRequiredDescription
OrderNumberformstringNoOrder number.
ArticleNumberformstringNoArticle number.
QuantityformintNoQuantity.
CustomReferenceformstringNoCustom reference.
ShipmentPackageResult Parameters:
NameParameterData TypeRequiredDescription
ShipmentMethodformstringNoShipment method.
TrackingNumberformstringNoTracking number.
TrackingUrlformstringNoTracking URL.

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /dealers/shipment/{ShipmentId} HTTP/1.1 
Host: services.acct.2service.nl 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Result: 
	{
		ShipmentId: 0,
		HasBeenDispatched: False,
		DispatchDate: 0001-01-01,
		Articles: 
		[
			{
				OrderNumber: String,
				ArticleNumber: String,
				Quantity: 0,
				CustomReference: String
			}
		],
		Packages: 
		[
			{
				ShipmentMethod: String,
				TrackingNumber: String,
				TrackingUrl: String
			}
		]
	},
	IsSuccessful: False,
	ErrorMessage: String
}