Antel Merchandiser App API

GetPrincipal

The following routes are available for this service:
GET	/principal/get

**GetPrincipal** Parameters:
Name	Parameter	Data Type	Required	Description
PrincipalId	query	int	No

**ApiServiceRequest** Parameters:
Name	Parameter	Data Type	Required	Description
ApiKey	form	string	Yes	The API Key required for authentication
Latitude	form	double	No	Latitude of the user making this request
Longitude	form	double	No	Longitude of the user making this request

**GetPrincipalResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Data	form	PrincipalData	Yes

**ApiServiceResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Description	form	string	Yes	Information about the response.
Heading	form	string	Yes	Heading or summary of the response.
WasSuccessful	form	boolean	Yes	Did the intended operation for this response complete successfully?
ResponseStatus	form	ResponseStatus	Yes

**PrincipalData** Parameters:
Name	Parameter	Data Type	Required
PrincipalId	form	int	No
Name	form	string	Yes
LogoImageUrl	form	string	Yes
Products	form	List<ProductDataCategory>	Yes
UpliftPrefix	form	string	Yes
ContactName	form	string	Yes
ContactNumber	form	string	Yes
ContactEmail	form	string	Yes
HasLogo	form	bool	No
AllowProductLookup	form	bool	No
CaptureSerialNumber	form	bool	No
ShowProductionDate	form	bool	No
ShowExpiryDate	form	bool	No
ShowBatchCode	form	bool	No
SealNumberPerProduct	form	bool	No
AllowedProductStockStatuses	form	List<StockStatusData>	Yes
Enabled	form	bool	No
ShowSealNumber	form	bool	No
ShowSealWeight	form	bool	No
ConsolidationEnabled	form	bool	No

**ProductDataCategory** Parameters:
Name	Parameter	Data Type	Required	Description
UnitBarcode	form	string	Yes
Products	form	List<ProductData>	Yes

**ProductData** Parameters:
Name	Parameter	Data Type	Required
ProductId	form	int	No
PrincipalId	form	int	No
PrincipalPrefix	form	string	Yes
Name	form	string	Yes
Category	form	string	Yes
ProductCode	form	string	Yes
UnitBarcode	form	string	Yes
CartonQuantity	form	int	No
ShrinkQuantity	form	int	No
UnitQuantity	form	int	No
CartonMeasurement	form	string	Yes
ShrinkMeasurement	form	string	Yes
UnitMeasurement	form	string	Yes
CartonWeight	form	double	No
ShrinkWeight	form	double	No
UnitWeight	form	decimal	No
CartonPrice	form	decimal	No
ShrinkPrice	form	decimal	No
UnitPrice	form	decimal	No
UnitOfMeasureId	form	int	No

**StockStatusData** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	Yes
PhotoRequired	form	bool	No
BatchCodeMandatory	form	bool	No
Color	form	string	Yes

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 /principal/get HTTP/1.1 
Host: returnit-api-dev.happen.zone 
Accept: text/jsv

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Data: 
	{
		PrincipalId: 0,
		Name: String,
		LogoImageUrl: String,
		Products: 
		[
			{
				UnitBarcode: String,
				Products: 
				[
					{
						ProductId: 0,
						PrincipalId: 0,
						PrincipalPrefix: String,
						Name: String,
						Category: String,
						ProductCode: String,
						UnitBarcode: String,
						CartonQuantity: 0,
						ShrinkQuantity: 0,
						UnitQuantity: 0,
						CartonMeasurement: String,
						ShrinkMeasurement: String,
						UnitMeasurement: String,
						CartonWeight: 0,
						ShrinkWeight: 0,
						UnitWeight: 0,
						CartonPrice: 0,
						ShrinkPrice: 0,
						UnitPrice: 0,
						UnitOfMeasureId: 0
					}
				]
			}
		],
		UpliftPrefix: String,
		ContactName: String,
		ContactNumber: String,
		ContactEmail: String,
		HasLogo: False,
		AllowProductLookup: False,
		CaptureSerialNumber: False,
		ShowProductionDate: False,
		ShowExpiryDate: False,
		ShowBatchCode: False,
		SealNumberPerProduct: False,
		AllowedProductStockStatuses: 
		[
			{
				Id: 0,
				Name: String,
				PhotoRequired: False,
				BatchCodeMandatory: False,
				Color: String
			}
		],
		Enabled: False,
		ShowSealNumber: False,
		ShowSealWeight: False,
		ConsolidationEnabled: False
	},
	Description: String,
	Heading: String,
	WasSuccessful: False,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}