GetQcStatus

Definition

Use this call to get the quality control status of items being listed.

Request URI: https://api.sellercenter.lazada.sg?Action=GetQcStatus

Parameters

FieldTypeDescription
ActionstringGetQcStatus
Name of the API that is to be called. Mandatory.
FormatstringThe response format, with XML as the default. Can be XML or JSON. Optional.
TimestampdatetimeThe current time in ISO8601 format (e.g., Timestamp=2016-04-01T10:00:00+02:00 for Berlin). Mandatory.
UserIDstringThe ID of the user making the call. Mandatory.
VersionstringThe API version against which this call is to be executed. The current version is "1.0". Mandatory.
SignaturestringThe cryptographic signature, authenticating the request. You must create this value by computing the SHA256 hash of the request, using the API key of the user specified in the UserID parameter. Mandatory.
LimitintegerThe maximum number of QC status entries that can be returned. If you omit this parameter, the default value of 100 is used.
OffsetintegerNumber of QC status entries to skip (i.e., an offset into the result set; together with the Limit parameter, simple result set paging is possible; if you do page through results, note that the list of QC status entries might change during paging).
SkuSellerListarray of stringsQC status will be returned for SKUs in this list only. Can either be a JSON array (e.g., [“E213”,”KI21”,”HT0”]) or a serialized PHP array (e.g., a:3:{i:0;s:4:”E213”;i:1;s:4:”KI21”;i:2;s:3:”HT0”;}).

Code sample

# GetQcStatus cURL example
# to run, update Timestamp and recompute Signature
#
url = "https://api.sg.ali-lazada.com/"
get
data-urlencode Action=GetQcStatus
data-urlencode Timestamp=2015-07-01T11:11+0000
data-urlencode [email protected]
data-urlencode Version=1.0
data-urlencode Signature=9ade00fb4b9ab9ed1b8a4d189f1a13e1029edc25dd963235480ec69226fd9f39
data-urlencode SellerSkuList=["ABC"]
//init request with list of seller sku
List<String> skus = new ArrayList<>();
skus.add("ASC Test 12 Multisourced - ME");
skus.add("ASC Test 12 Normal - EL");
skus.add("ASC Test 12 Non-COD - EL");
GetQcStatus request = new GetQcStatus(skus);
//fire request and check resualt
try {
  GetQcStatusResponse response = request.execute();
  for(QcStatus qcStatus: response.getBody()) {
    System.out.println(qcStatus);
  }
} catch (LazadaException e) {
  System.out.println(e.getResponseStr());
}

Result sample

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
     <Head>
          <RequestId/>
          <RequestAction>GetQcStatus</RequestAction>
          <ResponseType>State</ResponseType>
          <Timestamp>2016-04-28T15:09:01+0200</Timestamp>
     </Head>
     <Body>
          <Status>
               <State>
                    <SellerSKU>TestProduct2030</SellerSKU>
                    <Status>approved</Status>
                    <DataChanged>1</DataChanged>
               </State>
               <State>
                    <SellerSKU>TestProduct2031</SellerSKU>
                    <Status>approved</Status>
                    <DataChanged>1</DataChanged>
               </State>
               <State>
                    <SellerSKU>TestProduct2032</SellerSKU>
                    <Status>pending</Status>
               </State>
               <State>
                    <SellerSKU>TestProduct2033</SellerSKU>
                    <Status>pending</Status>
               </State>
               <State>
                    <SellerSKU>TestProduct2034</SellerSKU>
                    <Status>rejected</Status>
                    <Reason>Wrong Description; Wrong Translation</Reason>
               </State>
               <State>
                    <SellerSKU>TestProduct2035</SellerSKU>
                    <Status>rejected</Status>
                    <Reason>Price Not Reasonable; Image Corrupt</Reason>
               </State>
          </Status>
     </Body>
</SuccessResponse>

Documentation

🚧

Request parameter restrictions

SkuSellerList - Be aware that the parameter can ONLY be sent as an array so in the case you want to use it with only one element it should be still an array with one element.

For example, SkuSellerList = [“E213”].

Sending a string instead of an array will trigger an error.

📘

Expected result

The method will not return old QC results, but only recent ones. Provided you have a live product with several variations approved previously, then you add a new variation and query by all product variation SKUs. Result of such call will consist of 1 entry - a new variation status.