Richemont.Booster2.PublicApi

<back to all web services

ExportStock

Requires Authentication
The following routes are available for this service:
POST/stock/{brand}/exportExport Stock Data
<?php namespace dtos;

use DateTime;
use Exception;
use DateInterval;
use JsonSerializable;
use ServiceStack\{IReturn,IReturnVoid,IGet,IPost,IPut,IDelete,IPatch,IMeta,IHasSessionId,IHasBearerToken,IHasVersion};
use ServiceStack\{ICrud,ICreateDb,IUpdateDb,IPatchDb,IDeleteDb,ISaveDb,AuditBase,QueryDb,QueryDb2,QueryData,QueryData2,QueryResponse};
use ServiceStack\{ResponseStatus,ResponseError,EmptyResponse,IdResponse,ArrayList,KeyValuePair2,StringResponse,StringsResponse,Tuple2,Tuple3,ByteArray};
use ServiceStack\{JsonConverters,Returns,TypeContext};


class StockRequest implements JsonSerializable
{
    public function __construct(
        /** @description Brand */
        // @ApiMember(Description="Brand", IsRequired=true)
        /** @var string */
        public string $brand='',

        /** @description POS Legacy */
        // @ApiMember(Description="POS Legacy")
        /** @var array<string>|null */
        public ?array $posCodes=null,

        /** @description Article Codes */
        // @ApiMember(Description="Article Codes")
        /** @var array<string>|null */
        public ?array $articleCodes=null,

        /** @description Include Extra Info */
        // @ApiMember(Description="Include Extra Info")
        /** @var bool|null */
        public ?bool $includeExtraInfo=null,

        /** @description Cluster Id */
        // @ApiMember(Description="Cluster Id")
        /** @var array<string>|null */
        public ?array $clusterIds=null,

        /** @description Include Consignment NotAuthorized POS */
        // @ApiMember(Description="Include Consignment NotAuthorized POS")
        /** @var bool|null */
        public ?bool $includeConsignmentNotAuthorizedPOS=null,

        /** @description Include Retail Sales Price in the Output, by default: false */
        // @ApiMember(Description="Include Retail Sales Price in the Output, by default: false")
        /** @var bool|null */
        public ?bool $includeRSP=null,

        /** @description In Stock Since date from  */
        // @ApiMember(Description="In Stock Since date from ")
        /** @var DateTime|null */
        public ?DateTime $dateFrom=null,

        /** @description In Stock Since date to */
        // @ApiMember(Description="In Stock Since date to")
        /** @var DateTime|null */
        public ?DateTime $dateTo=null,

        /** @description Item type, 'standard' OR 'consigned'. By default, all are coming */
        // @ApiMember(Description="Item type, 'standard' OR 'consigned'. By default, all are coming")
        /** @var string|null */
        public ?string $type=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['brand'])) $this->brand = $o['brand'];
        if (isset($o['posCodes'])) $this->posCodes = JsonConverters::fromArray('string', $o['posCodes']);
        if (isset($o['articleCodes'])) $this->articleCodes = JsonConverters::fromArray('string', $o['articleCodes']);
        if (isset($o['includeExtraInfo'])) $this->includeExtraInfo = $o['includeExtraInfo'];
        if (isset($o['clusterIds'])) $this->clusterIds = JsonConverters::fromArray('string', $o['clusterIds']);
        if (isset($o['includeConsignmentNotAuthorizedPOS'])) $this->includeConsignmentNotAuthorizedPOS = $o['includeConsignmentNotAuthorizedPOS'];
        if (isset($o['includeRSP'])) $this->includeRSP = $o['includeRSP'];
        if (isset($o['dateFrom'])) $this->dateFrom = JsonConverters::from('DateTime', $o['dateFrom']);
        if (isset($o['dateTo'])) $this->dateTo = JsonConverters::from('DateTime', $o['dateTo']);
        if (isset($o['type'])) $this->type = $o['type'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->brand)) $o['brand'] = $this->brand;
        if (isset($this->posCodes)) $o['posCodes'] = JsonConverters::toArray('string', $this->posCodes);
        if (isset($this->articleCodes)) $o['articleCodes'] = JsonConverters::toArray('string', $this->articleCodes);
        if (isset($this->includeExtraInfo)) $o['includeExtraInfo'] = $this->includeExtraInfo;
        if (isset($this->clusterIds)) $o['clusterIds'] = JsonConverters::toArray('string', $this->clusterIds);
        if (isset($this->includeConsignmentNotAuthorizedPOS)) $o['includeConsignmentNotAuthorizedPOS'] = $this->includeConsignmentNotAuthorizedPOS;
        if (isset($this->includeRSP)) $o['includeRSP'] = $this->includeRSP;
        if (isset($this->dateFrom)) $o['dateFrom'] = JsonConverters::to('DateTime', $this->dateFrom);
        if (isset($this->dateTo)) $o['dateTo'] = JsonConverters::to('DateTime', $this->dateTo);
        if (isset($this->type)) $o['type'] = $this->type;
        return empty($o) ? new class(){} : $o;
    }
}

class ExportStockResponse implements JsonSerializable
{
    public function __construct(
        /** @description Unique Identifier of the Export Request created */
        // @ApiMember(Description="Unique Identifier of the Export Request created", IsRequired=true)
        /** @var string */
        public string $asyncTaskId=''
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['asyncTaskId'])) $this->asyncTaskId = $o['asyncTaskId'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->asyncTaskId)) $o['asyncTaskId'] = $this->asyncTaskId;
        return empty($o) ? new class(){} : $o;
    }
}

class ProductCategory implements JsonSerializable
{
    public function __construct(
        /** @description Brand Category ID */
        // @ApiMember(Description="Brand Category ID")
        /** @var string|null */
        public ?string $brandCategoryId=null,

        /** @description Grand Category ID */
        // @ApiMember(Description="Grand Category ID", IsRequired=true)
        /** @var string */
        public string $grandCategoryId='',

        /** @description Master Category ID */
        // @ApiMember(Description="Master Category ID")
        /** @var string|null */
        public ?string $masterCategoryId=null,

        /** @description Category ID */
        // @ApiMember(Description="Category ID")
        /** @var string|null */
        public ?string $categoryId=null,

        /** @description Sub Category ID */
        // @ApiMember(Description="Sub Category ID")
        /** @var string|null */
        public ?string $subCategoryId=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['brandCategoryId'])) $this->brandCategoryId = $o['brandCategoryId'];
        if (isset($o['grandCategoryId'])) $this->grandCategoryId = $o['grandCategoryId'];
        if (isset($o['masterCategoryId'])) $this->masterCategoryId = $o['masterCategoryId'];
        if (isset($o['categoryId'])) $this->categoryId = $o['categoryId'];
        if (isset($o['subCategoryId'])) $this->subCategoryId = $o['subCategoryId'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->brandCategoryId)) $o['brandCategoryId'] = $this->brandCategoryId;
        if (isset($this->grandCategoryId)) $o['grandCategoryId'] = $this->grandCategoryId;
        if (isset($this->masterCategoryId)) $o['masterCategoryId'] = $this->masterCategoryId;
        if (isset($this->categoryId)) $o['categoryId'] = $this->categoryId;
        if (isset($this->subCategoryId)) $o['subCategoryId'] = $this->subCategoryId;
        return empty($o) ? new class(){} : $o;
    }
}

class ExportStock extends StockRequest implements JsonSerializable
{
    /**
     * @param string $brand
     * @param array<string>|null $posCodes
     * @param array<string>|null $articleCodes
     * @param bool|null $includeExtraInfo
     * @param array<string>|null $clusterIds
     * @param bool|null $includeConsignmentNotAuthorizedPOS
     * @param bool|null $includeRSP
     * @param DateTime|null $dateFrom
     * @param DateTime|null $dateTo
     * @param string|null $type
     */
    public function __construct(
        string $brand='',
        ?array $posCodes=null,
        ?array $articleCodes=null,
        ?bool $includeExtraInfo=null,
        ?array $clusterIds=null,
        ?bool $includeConsignmentNotAuthorizedPOS=null,
        ?bool $includeRSP=null,
        ?DateTime $dateFrom=null,
        ?DateTime $dateTo=null,
        ?string $type=null,
        /** @description Product Categories */
        // @ApiMember(Description="Product Categories")
        /** @var array<ProductCategory>|null */
        public ?array $productCategories=null,

        /** @description Export Request ID of the API Consumers */
        // @ApiMember(Description="Export Request ID of the API Consumers", IsRequired=true)
        /** @var string */
        public string $downloadRequestId=''
    ) {
        parent::__construct($brand,$posCodes,$articleCodes,$includeExtraInfo,$clusterIds,$includeConsignmentNotAuthorizedPOS,$includeRSP,$dateFrom,$dateTo,$type);
    }

    /** @throws Exception */
    public function fromMap($o): void {
        parent::fromMap($o);
        if (isset($o['productCategories'])) $this->productCategories = JsonConverters::fromArray('ProductCategory', $o['productCategories']);
        if (isset($o['downloadRequestId'])) $this->downloadRequestId = $o['downloadRequestId'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = parent::jsonSerialize();
        if (isset($this->productCategories)) $o['productCategories'] = JsonConverters::toArray('ProductCategory', $this->productCategories);
        if (isset($this->downloadRequestId)) $o['downloadRequestId'] = $this->downloadRequestId;
        return empty($o) ? new class(){} : $o;
    }
}

PHP ExportStock DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /stock/{brand}/export HTTP/1.1 
Host: dev-api-booster.richemont.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"productCategories":[{"brandCategoryId":"String","grandCategoryId":"String","masterCategoryId":"String","categoryId":"String","subCategoryId":"String"}],"downloadRequestId":"String","brand":"String","posCodes":["String"],"articleCodes":["String"],"includeExtraInfo":false,"clusterIds":["String"],"includeConsignmentNotAuthorizedPOS":false,"includeRSP":false,"dateFrom":"\/Date(-62135596800000-0000)\/","dateTo":"\/Date(-62135596800000-0000)\/","type":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"asyncTaskId":"00000000000000000000000000000000"}