| GET | /principal/get |
|---|
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ApiServiceRequest(IServiceRequest, IHasApiKey, IHasDeviceInfo):
# @ApiMember(DataType="string", Description="The API Key required for authentication", IsRequired=true)
api_key: Optional[str] = None
"""
The API Key required for authentication
"""
# @ApiMember(DataType="double", Description="Latitude of the user making this request")
latitude: Optional[float] = None
"""
Latitude of the user making this request
"""
# @ApiMember(DataType="double", Description="Longitude of the user making this request")
longitude: Optional[float] = None
"""
Longitude of the user making this request
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ApiServiceResponse(IServiceResponse):
# @ApiMember(Description="Information about the response.", IsRequired=true)
description: Optional[str] = None
"""
Information about the response.
"""
# @ApiMember(Description="Heading or summary of the response.", IsRequired=true)
heading: Optional[str] = None
"""
Heading or summary of the response.
"""
# @ApiMember(DataType="boolean", Description="Did the intended operation for this response complete successfully?", IsRequired=true)
was_successful: bool = False
"""
Did the intended operation for this response complete successfully?
"""
response_status: Optional[ResponseStatus] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ProductData:
product_id: Optional[int] = None
principal_id: Optional[int] = None
principal_prefix: Optional[str] = None
name: Optional[str] = None
category: Optional[str] = None
product_code: Optional[str] = None
unit_barcode: Optional[str] = None
carton_quantity: Optional[int] = None
shrink_quantity: Optional[int] = None
unit_quantity: Optional[int] = None
carton_measurement: Optional[str] = None
shrink_measurement: Optional[str] = None
unit_measurement: Optional[str] = None
carton_weight: Optional[float] = None
shrink_weight: Optional[float] = None
unit_weight: Optional[Decimal] = None
carton_price: Optional[Decimal] = None
shrink_price: Optional[Decimal] = None
unit_price: Optional[Decimal] = None
unit_of_measure_id: Optional[int] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ProductDataCategory:
unit_barcode: Optional[str] = None
products: Optional[List[ProductData]] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class StockStatusData:
id: Optional[int] = None
name: Optional[str] = None
photo_required: Optional[bool] = None
batch_code_mandatory: Optional[bool] = None
color: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class PrincipalData:
principal_id: Optional[int] = None
name: Optional[str] = None
logo_image_url: Optional[str] = None
products: Optional[List[ProductDataCategory]] = None
uplift_prefix: Optional[str] = None
contact_name: Optional[str] = None
contact_number: Optional[str] = None
contact_email: Optional[str] = None
has_logo: Optional[bool] = None
allow_product_lookup: Optional[bool] = None
capture_serial_number: Optional[bool] = None
show_production_date: Optional[bool] = None
show_expiry_date: Optional[bool] = None
show_batch_code: Optional[bool] = None
seal_number_per_product: Optional[bool] = None
allowed_product_stock_statuses: Optional[List[StockStatusData]] = None
enabled: Optional[bool] = None
show_seal_number: Optional[bool] = None
show_seal_weight: Optional[bool] = None
consolidation_enabled: Optional[bool] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class GetPrincipalResponse(ApiServiceResponse):
data: Optional[PrincipalData] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class GetPrincipal(ApiServiceRequest):
principal_id: Optional[int] = None
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=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
}
}
}