Professional Documents
Culture Documents
Documentation
Version 3.6.0
Table of Contents
Table of Contents ..........................................................................................................................................................1
Document History ..........................................................................................................................................................3
1. Overview ....................................................................................................................................................................4
2. API Authentication .....................................................................................................................................................4
2.1 API Token.............................................................................................................................................................4
2.2 API Signature .......................................................................................................................................................6
2.2.1 Build the raw signature based on request meta data .................................................................................6
2.2.2 Get the API client secret ..............................................................................................................................6
2.2.3 Hash using HMAC SHA-256 ..........................................................................................................................7
3. API Sandbox ...............................................................................................................................................................7
4 Token Endpoint ...........................................................................................................................................................9
4.1 [POST] Get token for production .........................................................................................................................9
4.2 [POST] Get token for sandbox ...........................................................................................................................11
4.3 [POST] Refresh token ........................................................................................................................................12
5. Product Component API ..........................................................................................................................................13
5.1 [GET] Get Product List .......................................................................................................................................13
5.2 [GET] Get Product Detail ...................................................................................................................................16
5.3 [GET] Get Attribute List .....................................................................................................................................21
5.4 [GET] Get Category Tree ....................................................................................................................................23
5.5 [GET] Get Product Brands .................................................................................................................................25
5.6 [GET] Get Pickup Point ......................................................................................................................................26
5.7.1 [GET] Get Product in Review List ....................................................................................................................28
5.7.2 [GET] Get Product in Review List Version 2 ....................................................................................................30
5.8 [GET] Get Rejected Product List ........................................................................................................................33
6. Maintain Product API ...............................................................................................................................................35
6.1 [GET] Synchronize Product ................................................................................................................................35
6.2 [GET] Unsynchronize Product ...........................................................................................................................36
6.3 [POST] Create Product .......................................................................................................................................37
6.4 [POST] Update Product Summary .....................................................................................................................41
6.5 [POST] Update Detail Product ...........................................................................................................................43
6.6.1 [POST] Upload Product Image (deprecated, please use Upload Image Version 2) ........................................48
6.6.2 [POST] Upload Product Image Version 2 ........................................................................................................50
7. Order Component API .............................................................................................................................................52
7.1 [GET] Get Order List ..........................................................................................................................................52
Merchant can use the API to fetch product and order data as they want (not limited), but stay monitored.
For transaction API like: create product, update product and post image, will be excuted asynchronously
and merchant is able to see the async process status with “Get Feed Status API”.
Async process have limitation, each merchant only able to make 50 concurrent async request in 2 minutes.
Single async request can contains 100 elements of product/image in the body request.
2. API Authentication
To make a connection, merchant should be able:
1. Get API token to authenticated currenct merchant, the API time to live (TTL) is 1 day. Merchant
must be save the token value in their local system. Merchants are advised not to invoke “Get
Token API” for every API call.
2. Generate a valid signature for every API request, the signature is generated base on current
request metadata.
To get the valid token, merchant must have API credential. Merchant can do the API credential registration
in the MTA web page on https://merchant.blibli.com/MTA/api-docs. See registration step below:
The API credential is unique per merchant’s username. After merchant complete the registration, they
can get their token via “Get Token API” and place their credential information like Picture 2.4.
{Request method}
{MD5 of request body}
{Content type}
{Current date}
{URL request}
Raw Signature Example for POST request Raw Signature Example for GET request
POST\ndd50f190b5bce5deca42dfa3dbea08a3\napplication/json\nMon GET\n\n\nMon May 16 14:07:15 WIB
May 16 14:07:15 WIB 2016\n/mtaapi/api/businesspartner/v1/feed/status
2016\n/mtaapi/api/businesspartner/v1/product/updateProduct
The secret key is cached for 1 hour, so if merchant changing the secret key, it will take 1 hour to apply the
changes.
The signature will be attached on every request header for x-blibli-mta-authorization, see Picture 2.6.
3. API Sandbox
MTA API also provide sandbox environment, so it help the customer to do API integration testing without
affecting production data. The sandbox environment provide API contract (request and response
validation) with static data. To work on sandbox environment, you can use this value of mentioned
parameter as follows:
Parameter name Parameter value Response result
Will pass the merchant validation and return the API
businessPartnerCode BLI-17103
response successfully
Will pass the merchant validation and return the null list
businessPartnerCode BLI-27103
of API response
Will pass the category validation and return the API
categoryCode / masterCategoryCode FX-1000004
response successfully
You can use following account to connect (Get Token) in sandbox environment
username: mta-api-sandbox
password: sandbox-secret-key
Authorization request:
Attribute name Attribute value Description
type Basic Auth Authrorization type for get token API
username {api-username} API client username, based on Blibli API agreement for each merchant
password {api-password} API client password, based on Blibli API agreement for each merchant
Header request:
Attribute name Attribute value Description
application/x-www- Content type for get token request using x-www-form-urlencoded
Content-type
form-urlencoded
Accept application/json Accept type for the API result
Body request: (set body type to application/x-www-form-urlencoded)
Attribute name Attribute value Description
grant_type password The value of API grant type
username {mta-username} MTA web username for specified merchant
password {mta-password} MTA web password for specified merchant
Note: if you hit this API with invalid MTA username up to three times, your MTA username will be locked. You
need to reset password for your MTA account.
Success response
{
"access_token": "1e1ab274-b8dd-4b21-9323-0d1c85f7091d",
"token_type": "bearer",
"refresh_token": "0468d301-af86-4482-ba17-144b642e19f5",
"expires_in": 86400,
"scope": "read write trust"
}
Attribute name Description
access_token API token that used as an authentication key
refresh_token Refresh token key that will be used to refresh the token expiration time
expires_in Token expiration time in seconds, 86400 seconds = 1 day
Authorization request:
Attribute name Attribute value Description
type Basic Auth Authrorization type for get token API
{ api-sandbox- API client username, based on Blibli API agreement for each merchant
username
username}
{api-sandbox- API client password, based on Blibli API agreement for each merchant
password
password}
Header request:
Attribute name Attribute value Description
application/x-www- Content type for get token request using x-www-form-urlencoded
Content-type
form-urlencoded
Accept application/json Accept type for the API result
Body request: (set body type to application/x-www-form-urlencoded)
Attribute name Attribute value Description
grant_type client_credentials The value of API grant type
Success response
{
"access_token": "1e1ab274-b8dd-4b21-9323-0d1c85f7091d",
"token_type": "bearer",
"refresh_token": "0468d301-af86-4482-ba17-144b642e19f5",
"expires_in": 86400,
"scope": "read write trust"
}
Attribute name Description
access_token API token that used as an authentication key
refresh_token Refresh token key that will be used to refresh the token expiration time
expires_in Token expiration time in seconds, 86400 seconds = 1 day
Authorization request:
Attribute name Attribute value Description
type Basic Auth Authrorization type for get token API
username {api-username} API client username, based on Blibli API agreement for each merchant
password {api-password} API client password, based on Blibli API agreement for each merchant
Header request:
Attribute name Attribute value Description
application/x-www- Content type for get token request using x-www-form-urlencoded
Content-type
form-urlencoded
Accept application/json Accept type for the API result
Body request: (set body type to application/x-www-form-urlencoded)
Attribute name Attribute value Description
grant_type refresh_token The value of API grant type
client_id {api-username} API client username, based on Blibli API agreement for each merchant
refresh_token {refresh-token} Refresh token key, obtained from “get token API” on section 4.1
Success response
{
"access_token": "1e1ab274-b8dd-4b21-9323-0d1c85f7091d",
"token_type": "bearer",
"refresh_token": "0468d301-af86-4482-ba17-144b642e19f5",
"expires_in": 86400,
"scope": "read write trust"
}
Attribute name Description
access_token API token that used as an authentication key
refresh_token Refresh token key that will be used to refresh the token expiration time
expires_in Token expiration time in seconds, 86400 seconds = 1 day
Note.
This API will return single product item list for current merchant
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
gdnSku {gdn-item-sku} Filter product list by GDN Item SKU, like: TOQ-15130-00060-00001
productName {product-name} Filter product list by product name using “LIKE” operation
categoryCode {category-code} Filter product list by category code
salePrice {sale-price} Filter product list by category code
pickupPointCode {pickup-point-code} Filter product list by pickup point code
stock {product-stock} Filter product list by product stock
Filter product list by stock value is deprecated
page {page-list} Filter product list by page list index, the default value is 0
size {list-size} Filter product list by size list, the default value is 10
Note: the underlined attribute is an optional parameter
Success response
{
"requestId": "4613cbb6-7ca9-4932-9d31-8e4e4634a159",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"gdnSku": "TOA-15142-00069-00001", //this field name is gdnSku but the field value is itemSku, please expect that its contain itemSKU
"productName": "PRO ATT 6 Brick Red",
"productItemCode": "MTA-0300002-00002",
"merchantSku": "SKU-0001",
"regularPrice": 15000,
"sellingPrice": 15000,
"stockAvailableLv2": 36,
"stockReservedLv2": 914,
"productType": "REGULAR",
"pickupPointCode": "PP-3000197",
"pickupPointName": "pick up point argo",
"displayable": false,
"buyable": true,
Note.
This API will return single product item detail based on request parameter value
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
gdnSku {gdn-item-sku} Get product detail by product item GDN SKU, ex: TOQ-15130-00006-00001
username {mta-username} MTA web username for specified merchant
Success response
{
"requestId": "4613cbb6-7ca9-4932-9d31-8e4e4634a159",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"productSku": "TOS-16005-00004",
"productCode": "MTA-0267411",
"businessPartnerCode": "TOS-16005",
"synchronize": false,
"productName": "Xiaomi MI 5 Smartphone - Black [3 GB/ 32 GB/ Garansi Distributor]",
"productType": 2,
"categoryCode": "10249",
"categoryName": "Android",
"categoryHierarchy": "Handphone & Tablet > Handphone > Android",
"brand": "Xiaomi",
"description": "<p>Xiaomi MI 5 Smartphone - Black [3 GB/ 32 GB/ Garansi Distributor], hadir dengan layar berukuran 5.0 Inch
dan sistem operasi Android OS</p>",
"specificationDetail": "<ul><li>Brand<ul><li>Xiaomi</li></ul></li><li>Kamera<ul><li>16 MP & 4 MP</li></ul></li><li>Kapasitas
Baterai<ul><li>3000 mAh</li></ul></li><li>Memory<ul><li>3 GB RAM</li></ul></li><li>Operating System<ul><li>Android
OS, v6.0 (Marshmallow)</li></ul></li><li>Sim Card<ul><li>Dual-SIM\nNano-SIM</li></ul></li><li>Ukuran
Layar<ul><li>5.15 Inch</li></ul></li><li>Memori Internal<ul><li>32 GB ROM</li></ul></li><li>Slot Memori
Eksternal<ul><li>No</li></ul></li><li>Chipset<ul><li>Qualcomm MSM8996 Snapdragon 820</li></ul></li></ul>",
"uniqueSellingPoint": "<ul>\n<li>OS : Android OS, v6.0 (Marshmallow)</li>\n<li>Chipset : Qualcomm MSM8996 Snapdragon
820</li>\n<li>Memori : Internal 32 GB & RAM 3 GB</li>\n<li>Kamera : Belakang 16 MP & Depan 4
MP</li>\n<li>Layar : 5.0 Inch</li>\n</ul>",
"productStory": "",
"items": [
{
Note: if merchant switch the sync status become true, then the product data will be
reloaded like as master data.
productName Product name information
The product type based on shipping method, that is:
• REGULAR : regular product
productType
• BIG PRODUCT : shipped by merchant
• BOPIS : bopis product, like: ticket, voucher, etc
categoryCode Category code for the current product
categoryName Category name for the current product
Category hierarchy for the current product, using “>” as separator. For example:
categoryHierarchy
Handphone & Tablet > Handphone > Android
brand Product brand information
Note.
This API is used to determine the mandatory attribute for current category. It required to build body request for 6.3 Create Product
API.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
categoryCode {category-code} Filter attribute list result by specified category code
Success response
{
"requestId": "bc9795a7-e756-4962-b023-e625eecd5f38",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"categoryCode": "54587",
"name": "Baju Kerja",
"attributes": [
{
"attributeCode": "GA-0036802",
"attributeType": "DESCRIPTIVE_ATTRIBUTE",
"name": "Material"
"options": []
},
{
"attributeCode": "TI-M000161",
"attributeType": "PREDEFINED_ATTRIBUTE",
"name": "Tipe Atasan",
"options": [
"Blouse",
"Tunik",
"Tank Top",
"Polo",
"Kemeja",
"Kaos",
"Etnik",
"Batik"
]
},
Success response
{
"requestId": "efc984b1-5174-4390-aa93-a261388ae52c",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"categoryCode": "CO-1000048",
"categoryName": "Computer",
"children": [
{
"categoryCode": "DE-1000037",
"categoryName": "Desktop"
},
{
"categoryCode": "LA-1000062",
"categoryName": "Laptop"
}
]
},
{
"categoryCode": "10437",
"categoryName": "Fashion Pria",
"children": [
{
"categoryCode": "10467",
"categoryName": "Jam Tangan",
"children": [
{
"categoryCode": "10468",
"categoryName": "Jam Tangan Casual"
},
{
"categoryCode": "10470",
Success response
{
"requestId": "c5ad0d8c-70d0-4f82-97aa-f1e5d20d117e",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": [
"Acerola",
"WR ACERBIS",
"Apacer",
"Acerbis",
"Acer"
]
}
Attribute name Description
value Brands list value information
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"createdDate": 1478498478663,
"createdBy": "account@gdn-commerce.com",
"updatedDate": 1479876246783,
"name": "Haneda Store",
"code": "PP-3000408"
},
{
"createdDate": 1479734383070,
"createdBy": "account@gdn-commerce.com",
"updatedDate": 1479876246836,
"name": "Store Singapore",
"code": "PP-3000495"
},
{
"createdDate": 1479870914182,
"createdBy": "account@gdn-commerce.com",
"updatedDate": 1479876246953,
"name": "tokyo towncenter",
"code": "PP-3000517"
}
]
}
Attribute name Description
name Pickup point name information
code Pickup point code information
createdBy Pickup point data creator
createdDate Pickup point created date, in epoch time format
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"id": "216ab946-e0df-43a0-9ad2-528977b7fd0b",
"storeId": "10001",
"createdDate": 1485424298774,
"createdBy": "system",
"updatedDate": 1485424298774,
"updatedBy": "system",
"businessPartnerId": "BLI-17103",
"productId": "eae2b4dc-ed46-4dc3-a163-3850e3901dbd",
"gdnProductSku": "SKU-00001-00002",
"activated": false,
"productName": "Product name",
"categoryName": "Handphone dan Tablet",
"brand": "Samsung",
"productItemBusinessPartners": [
{
"id": "f5aef2e7-1bf0-475c-98a5-5bbaf587c97a",
"storeId": "10001",
"createdDate": 1485424298774,
"createdBy": "system",
"updatedDate": 1485424298774,
"updatedBy": "",
"productItemId": "2e2bafcf-9452-4715-a24e-bda89958ede4",
"productType": 1,
"gdnProductItemSku": " SKU-00001-00002-00001",
"price": 100000,
"salePrice": 120000,
This API is version 2 from previous API, this API allow merchant to check whether product’s image is already uploaded with valid
mapping or not.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"productCode": "MTA-0307414",
"productName": "Kemeja Bagus",
"brand": "Warwolf",
"length": 2,
"width": 2,
"weight": 0.022,
"height": 2,
"shippingWeight": 0.02,
"url": "-",
"description": "PHA+S2VtZWphIEJhZ3VzPC9wPg==",
"uniqueSellingPoint": "<p>Kemeja Bagus</p>",
"productStory": "-",
"specificationDetail": "<ul><li>Care Label<ul><li>afasdf</li></ul></li><li>Warna<ul><li>Forrest Green</li><li>Brick
Red</li><li>Black/Violet</li></ul></li><li>Material<ul><li>arvserdzfre</li></ul></li><li>Ukuran<ul><li>Semua
Ukuran</li></ul></li><li>Brand<ul><li>Warwolf</li></ul></li></ul>",
"productImages": [
{
"imagePath": "/full/MTA-0307414/warwolf_kemeja-bagus_full01.jpg",
"sequence": 0,
"active": false,
"mainImage": true,
"uploaded": true
},
If you using API integration you must check this attribute to ensure
that your product image is uploaded and well mapped into your
specified product.
categoryCode Category code for the current product
categoryName Category name for the current product
activated If true it already approved in QC phase 1
viewable If trus it already approved in QC phase 2
productItems Product items information, the product item list is generated based on
product varian
generatedItemName Product item name information, it’s generated by Blibli system based
on product name and specified product’s variant
upcCode Universal product code, like barcode and etc
productItemCode Product item code information
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"productName": "Product Merchant 1",
"categoryName": "Smartphone",
"brand": "Lenovo",
"submitDate": 1472203006457,
"initiator": "system",
"rejectedReason": "product description is not valid",
"rejectedDate": 1472469892264,
"productCode": "MTA-0305289"
},
{
"productName": "Product Merchant 54",
"categoryName": "Smartphone",
"brand": "Sony",
"submitDate": 1472203006457,
"initiator": "system",
"rejectedReason": "please improve the product image quality",
"rejectedDate": 1472469892264,
"productCode": "MTA-0305289"
}
],
"pageMetaData": {
"pageSize": 10,
"pageNumber": 0,
"totalRecords": 2
}
}
Attribute name Description
Note.
Product master data for iPhone 6 is “abc”, when merchant change their product web data into “def” then hit this API, his product web
data will become “abc” again, which is returned from product master data.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {request-id} Unique request ID that generated for each client request
productSku {product-sku} Product SKU value
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true
}
Attribute name Description
success As indicator whether the current request is success or not
Note.
Merchant can’t update his product detail if it still synced with master data. So it must unsynced first then merchant will able to update
the product detail data. But 6.5 Product Detail Product API will do product unsynced automatically.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {request-id} Unique request ID that generated for each client request
productSku {product--sku} Product SKU value
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true
}
Attribute name Description
success As indicator whether the current request is success or not
Note.
Create product API have auto correction feature for product’s image path. The default value is true, is you want to deactive this
feature you can set request parameter of “validateImagePath” to false.
]
}
Body attribute name Description
merchantCode Specified merchant code value
products Input of bulk create new product request
categoryCode Category code value for new product
productName Product name value
url Other product promotion url, this attribute is nullable
merchantSku Merchant SKU for new product, this attribute is nullable
tipePenanganan Shipping type for specified product:
• 1 = regular product, shipped by Blibli
• 2 = big product, shipped by merchant partner
• 3 = BOPIS, (Buy Online, Pickup In Store) product
price Product price value
salePrice Product sale price value, the value of salePrice must be <= than price
stock Product stock value
minimumStock Input of current minimum stock, set to 1 if minimum stock is not defined by business agreement
pickupPointCode Pickup point code for the current new product
For example: if the product variant is color = black and red, size = 35 and 36. So the generated
variasi product item will be 4 items:
1. Color red, size 35
2. Color black, size 35
3. Color red, size 36
4. Color black, size 36
Fill product image location with pattern:
[product-brand]_[lowercase-product-name]_full[images-sequence-start-with-1].jpg
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"timeStamp": 1459479692789
}
}
Attribute name Description
requestId This is the request ID for current bulk request, the request ID is generated by Blibli
system. Merchant partner is able to check the bulk status by passing this request ID
into “get queue feed API”
success As indicator whether the current request is success or not
timeStamp The current bulk request created date, in epoch time format
Note.
If merchant only want to change product stock without changing another value like (price, buyable & displayable), then merchant can
set “null” value for unchanged attirbutes.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request:
{
"merchantCode": "TOX-0952",
"productRequests": [
{
"gdnSku": "TOX-15338-00039-00001",
"stock": 20,
"minimumStock": 1,
"price": 20000,
"salePrice": 15000,
"buyable": true,
"displayable": false
},
{
"gdnSku": "TOX-15346-00039-00001",
"stock": -5,
"minimumStock": 1,
"price": null,
"salePrice": null,
"buyable": null,
"displayable": null
},
……… update product summary 3
……… update product summary n
]
}
Note: if you wanna only update some product attribute you can set another field with null value
Body attribute name Description
merchantCode Input input current business partner/merchant code
productRequests Input of bulk update product request
gdnSku Input of product GDN Item SKU that wanna be updated
stock Input of delta stock for current product’s GDN SKU.
Note: if current product stock is 10 and merchant partner wanna updated to 5, then the delta
stock value must be -5.
If current product stock is 10 and wanna updated to 12, then the delta stock value must be 2.
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"timeStamp": 1459479692789
}
}
Attribute name Description
requestId This is the request ID for current bulk request, the request ID is generated by Blibli
system. Merchant partner is able to check the bulk status by passing this request ID
into “get queue feed API”
success As indicator whether the current request is success or not
timeStamp The current bulk request created date, in epoch time format
Note.
1. If merchant hit this API, the current merchant’s product web data will unsynced automatically from master data.
2. To fill the body request for this API, it can got from 5.2 Get Product Detail API. Merchant must remove the value of
https://blibli.com/images/catalog/full// for images -> locationPath.
Example.
“https://blibli.com/images/catalog/full///535/samsung_merchant-product_full01.jpg” must converted into
“/535/samsung_merchant-product_full01.jpg”
Note: if merchant switch the sync status become true, then the product data will be reloaded like as
master data.
productName Product name information
The product type based on shipping method, that is:
• REGULAR : regular product
productType
• BIG PRODUCT : shipped by merchant
• BOPIS : bopis product, like: ticket, voucher, etc
categoryCode Category code for the current product
categoryName Category name for the current product
Category hierarchy for the current product, using “>” as separator. For example: Handphone &
categoryHierarchy
Tablet > Handphone > Android
brand Product brand information
description Product description information
specificationDetail Specification detail for the current product
uniqueSellingPoint Unique selling point for the current product
productStory Product story information
Product items information, usually 1 master product has several product items. The product item
items
is contains different variant.
Product item SKU that generated by Blibli system.
itemSku
Note: product item SKU is not same like productSku, each product item has different product item SKU
skuCode Product item code information, it’s not same like productCode
merchantSku Product item merchant SKU, this SKU is generated by merchant partner
upcCode Universal product code, like barcode and etc
deltaStock Note: if current product stock is 10 and merchant partner wanna updated to 5, then the delta
stock value must be -5.
If current product stock is 10 and wanna updated to 12, then the delta stock value must be 2.
Synchronize stock status:
synchronizeStock • If it true then the product is able to bought based on Lv 1 stock, even the Lv 2 is larger.
• If it false then the product is able to bought based on Lv 2 stock, Lv 1 stock will abandoned.
prices The product prices information for the current product
channelId Channel ID for the current product
price Product price information
salePrice Product sale price information
discountAmount Product discount price information
discountStartDate Product discount start date
discountEndDate Product discount end date
promotionName Promotion name for specified product price
viewConfigs Viewable configuration for current product
Displayable status:
• If it true then the product will displayed on blibli apps
display
• If it false then the product will not displated on blibli apps and only displayed on merchant
apps
Buyable status:
buyable • If it true then the product is able to bought by customer
• If it false then the product is can’t to bought by customer
images Product images information
mainImage Main image flag, if true then it will displayed as main image on product list page
sequence The image sequence on product detail page, start from 0
locationPath Product image location path information
Offline to online flag for the current product. Please contact our trade & partnership PIC about
off2OnActiveFlag
this business flow.
attributes Product attributes information
attributeCode Attribute code information
Atrrbute type information, contains:
• DESCRIPTIVE_ATTRIBUTE: attribute that defined by merchant, like: operating system,
screen size, etc
attributeType
• PREDEFINED_ATTRIBUTE: attribute that defined by Blibli, like: product operating system
that able to sell in Blibli apps, etc
• PREDEFINING_ATTRIBUTE: attribute that indicate the product variant like: size, colour, etc
values Product attribute value information
skuValue • If it true then merchant must fill the attribute data
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"timeStamp": 1459479692789
}
}
Attribute name Description
requestId This is the request ID for current bulk request, the request ID is generated by Blibli
system. Merchant partner is able to check the bulk status by passing this request ID
into “get queue feed API”
success As indicator whether the current request is success or not
timeStamp The current bulk request created date, in epoch time format
Note.
The image file that uploaded must be:
1. have minimum resolution 600x600 px
2. have minmum dpi = 72 dpi
3. maximum file size is 1 Mb
4. image format must be: JPG or PNG
5. use white color of product’s background
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api- API signature is generate by client like explained in section
signature} 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a
reference
Accept application/json Accept type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: multipart/form-data
Attribute name Attribute value Description
merchantCode {merchant-code} Specified merchant code value
productImages[0].brand {product-brand} Specified product brand value
productImages[0].productName {product-name} Specified product name value
productImages[0].images[0] {product-image} Specified product image in .jpg extension type
productImages[0].images[1] {product-image} Specified product image in .jpg extension type
productImages[0].images[n] {product-image} Specified product image in .jpg extension type
productImages[1].brand {product-brand} 2nd product image request
productImages[1].productName {product-name}
productImages[1].images[0] {product-image}
productImages[1].images[1] {product-image}
productImages[100].brand {product-brand} 100th product image request
productImages[100].productName {product-name}
productImages[100].images[0] {product-image}
Parameter request: Not necessary
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"timeStamp": 1459479692789
}
}
Attribute name Description
requestId This is the request ID for current bulk request, the request ID is generated by Blibli
system. Merchant partner is able to check the bulk status by passing this request ID
into “get queue feed API”
Note: Post image API implement different signature pattern for POST request, look at below:
Raw signature example Raw signature example (sandbox)
POST\n\n\nMon May 16 14:07:15 WIB POST\n\n\nMon May 16 14:07:15 WIB 2016\n/mtaapi-
2016\n/mtaapi/api/businesspartner/v1/product/postImage sandbox/api/businesspartner/v1/product/postImage
With this API you can upload the product image specific per product’s item code (optional). You can upload images per product code
also (mandatory).
Note.
The image file that uploaded must be:
1. have minimum resolution 600x600 px
2. have minmum dpi = 72 dpi
3. maximum file size is 1 Mb
4. image format must be: JPG or PNG
5. use white color for image’s background
5. have image ratio 1:1
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api- API signature is generate by client like explained in section
signature} 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a
reference
Accept application/json Accept type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: multipart/form-data
Attribute name Attribute value Description
merchantCode {merchant-code} Specified merchant code value
productCode {product-code} Specified product code value
productImages[0] {product-image} Image 1 for product
productImages[1] {product-image} Image 2 for product
productImages[n] {product-image} Image n for product
productItem[0].productItemCode {product-item-code } Specified product item code value
productItem[0].images[0] {product-item-image} Image 1 product product item
productItem[0].images[1] {product-item-image} Image 2 product product item
productItem[0].images[n] {product-item-image} Image n product product item
….
productItem[n].productItemCode {product-item-code } Specified product product item
productItem[n].images[0] {product-item-image} Image n product product item n
Parameter request: Not necessary
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"timeStamp": 1459479692789
}
}
Attribute name Description
Note: Post image API implement different signature pattern for POST request, look at below:
Raw signature example Raw signature example (sandbox)
POST\n\n\nMon May 16 14:07:15 WIB POST\n\n\nMon May 16 14:07:15 WIB 2016\n/mtaapi-
2016\n/mtaapi/api/businesspartner/v2/product/postImage sandbox/api/businesspartner/v2/product/postImage
Note.
This API will return per order item list information
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
storeId 10001 Default store ID for Blibli
productTypeCode {product-type} Filter order list by product type:
• 1: REGULAR
• 2: BIG PRODUCT
• 3: BOPIS
status {order-status} Filter order list by order status, that is:
• FP : new order for merchant
• PF : partial fulfilled order
• CR : customer request
• CX : in delivery
• PU : ready for pickup
• OS : out of stock
• BP : big product order
• NCX : cash on delivery (COD)
• NDF : COD failure
• DF : delivery failure
• DC : delivery canceled
• D : delivered
• X : canceled
• ES : email sent
page {page-list} Filter order list by page list index, the default value is 0
size {list-size} Filter order list by size list, the default value is 10
logisticCode {logisticProviderCode} Filter order list by logisticProviderCode
orderDate {order-date} Filter order list by orderDate, using format YYYY-MM-DD
Note: the underlined attribute is an optional parameter
Success response
{
"requestId": "4613cbb6-7ca9-4932-9d31-8e4e4634a159",
"errorMessage": null,
"errorCode": null,
If the value:
• “Big Product”: merchant must hit 8.2 Fulfill Big Product Order API
• “BOPIS”: merchant must hit 8.3 Fulfill BOPIS Order API
• Except “Big Product” and “BOPIS” merchant must hit 8.1 Fulfill Regular
Order API
dueDate Due date to fulfill current order, in epoch time format
merchantDeliveryType Merchant delivery type for current order:
• PICKUP: regular product and Blibli courrier will pickup the order to
merchant’s pickup point. Merchant hit 8.1 Fulfill Regular Order API
without awbNo attribute.
• DROPSHIP: regular product and merchant sends the order by himself.
Merchant hit 8.1 Fulfill Regular Order API with awbNo attribute
logisticsOptionName Logistic option code is the type of specified logistic product name. For example is
logistic option code STANDARD. EXPRESS, etc
logisticsProductName Logistic service name information for current order item
pickupPointCode Pickup point code information current order item
itemSku GDN item SKU information for current order item
awbNumber Airwaybill number information for current order shipment
awbStatus Airwaybill status for current order shipment, the status are:
• FAILED : airway bill validation is failed
• INVALID : airway bill is not valid
• VALID : airway bill is valid
• NOT_VALIDATED_YET : airway bill is not validated yet
paid Boolean value to identify whether current order already paid to merchant or not.
This field is used for financial purpose.
productTypeCode The product type code based on shipping method, that is:
• 1 : regular product
• 2 : shipped by merchant
• 3 : bopis product, like: ticket, voucher, etc
productTypeName The product type name based on shipping method, that is:
• REGULAR : regular product
• BIG PRODUCT : shipped by merchant
• BOPIS : bopis product, like: ticket, voucher, etc
pageMetaData Page metadata information for order list result
pageSize Page size for current order item list
pageNumber Page number information for current order item list
totalRecords Total record of order list that able to get by current filter
Success response
{
"requestId": "4613cbb6-7ca9-4932-9d31-8e4e4634a159",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"orderNo": "25000039861",
"orderItemNo": "25000029207",
"qty": 1,
"orderDate": 1505442541562,
"autoCancelDate": 1505840400000,
"productName": "LG G5 SE Smartphone - Titan [32 GB], Sync Stock True Product Black",
"productItemName": "batik indonesia raya L Black/Violet",
"productPrice": 5000000,
"total": 5000000,
"itemWeightInKg": 0.17,
"custName": "Andri Kusnanto",
"orderStatus": "BP",
"orderStatusString": "MENUNGGU DATANG",
"customerAddress": "Jalan Aipda K.S. Tubun II C No. 8, Daerah Khusus Ibukota Jakarta, Indonesia Cadasari",
"customerEmail": "masitha@mailinator.com",
"logisticsService": "JNE Regular",
"currentLogisticService": "JNE Regular",
"pickupPoint": "PP-3000408",
"pickupPointName": "My Warehouse 1",
"pickupPointAddress": "Haneda 87 District 6 Tokyo",
"pickupPointCity": "Kota Jakarta Selatan",
"pickupPointProvince": "DKI Jakarta",
"pickupPointCountry": "ID",
"pickupPointZipcode": "12440",
"gdnSku": "TOS-16005-00001",
"gdnItemSku": "TOS-16005-00001-00001",
If the order product type is BOPIS and Big Product, the value is:
• Big Product: merchant must hit 8.2 Fulfill Big Product Order API
• BOPIS: merchant must hit 8.3 Fulfill BOPIS Order API
pickupPoint Order pickup point code information
pickupPointName Pickup point name information
If merchant their own logistic, he can assign with the their identified courrier
name.
courierType Merchant courier type value must be:
• Merchant courier : if the product is delivered by merchant logistic
• 3PL : if the merchant using other third party logistic like: JNE, NCS, etc
settlementCode Settlement code information for current order
financeSettlementInfo It contain order settlement information, from Blibli to merchant
paymentDate Payment date when Blibli paid the merchant regarding the current order
transactionFee Transaction fee information
commission Commision information
pph23 PPH23 / tax information
merchantPromo Merchant promo amount information
totalPayment Total payment information
reportPath Link to download settlement report file
manifest Contains information about package shipment
logisticProviderCode Logistic provider information
airwaybill Airway bill status
status Delivery status, it’s vary depends on each logistic provider
timestamp Delivery date
picName PIC/courier name that deliver the package
picImageUrl PIC/courier photo profile that deliver the package
picContactInformation PIC/courier contact or phone information that deliver the package
createdDate Order created date, in epoch time format
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"document": "JVBERi0xLjQNCjUgMCBvYmoNCjw8L1R5cGUgL1BhZ2UgL1BhcmVudCAzIDAgUiAvQ29udGVudHMgNiAwIFIgL01
lZGlhQm94IFswIDAgNTk1LjQ0IDg0MS42OF0gL0dyb3VwIDw8IC9DUyAvRGV2aWNlUkdCIC9TIC9UcmFuc3BhcmVuY3kgL1R5cGU
gL0dyb3VwID4+IC9SZXNvdXJjZXM8PC9Gb250PDwvRkFBQUJDIDEyIDAgUiAvRkFBQUFIIDcgMCBSIC9GQUFBQkggMTcgMCBSID4
+L0V4dEdTdGF0ZTw8L0dTMSAyMiAwIFIgL0dTMiAyNCAwIFIgL0dTMyAyNiAwIFIgPj4vWE9iamVjdDw8L1gxIrJDdc51MG4rMnsqu
v4mKtCwmtk2/9fV/15SqIddxU83oHtXmfhFhciV3PYlrOg0uBc7n"
}
}
Attribute name Description
success To indicate whether the download operation is success or not
document The shipping label .pdf document in base64 format
Note. Airwaybill document only available only for Regular Pickup Order and order status is PU (after fulfill order) or CX (in delivery)
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
storeId 10001 Default store ID for Blibli
orderItemNo {order-item-id} Order item number for current order
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"productName": "Samsung Galaxy S7 SM G930 Smartphone - Hitam [32 GB] Jakarta Pusat - Plaza Indonesia Silver",
"quantity": 1,
"packageId": "10003067",
"airwaybillNo": "JNE0313562874",
"airwaybillStatus": "VALID",
"orderStatus": "Pesanan Telah Terkirim",
"logisticProvideName": "JNE YES",
"logisticProvideCode": "EXPRESS",
"logisticOptionName": "Standard",
"logisticOptionCode": "STANDARD",
"logisticEstimationDay": 2,
"originCodeId": "Origin-Jakarta",
"originCode": "CGK",
"destinationCode": "CGK10105",
"destinationLongitude": 113.921327,
"destinationLatitude": -0.789275,
"senderName": "Blibli.com - Toko QA CM 2",
"senderAddress": "Jalan Aipda K.S. Tubun II C No. 8, Daerah Khusus Ibukota Jakarta, Indonesia Cadasari - Kaduela Kab. Pandeglang",
"senderCity": "Jakarta",
"recipientSubDistrict": "Palmerah",
"recipientDistrict": "Palmerah",
"senderProvince": "Jakarta Barat",
"recipientCountry": "Indonesia",
"recipientEmail": "agiesatu@mailinator.com",
"recipientRegion": "Palmerah - Palmerah, Kota Jakarta Barat, DKI Jakarta",
This API only return eligible combine shipping list for REGULAR PICKUP order.
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
requestId {client-request-id} Unique request ID that generated for each client request
storeId 10001 Default store ID for Blibli
orderItemNo {order-item-id} Order item number for current order
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"alreadyCombined": false,
"maxCombinedWeight": 50,
"combineShipping": [
{
"orderNo": "25000013289",
"orderItemNo": "25000013316",
"qty": 1,
"gdnItemSku": "TOB-16791-00028-00001",
"merchantSku": "SKU-00546871",
"productName": "Product Name 412",
"productPrice": 100000,
"total": 400000,
"productTypeCode": "1",
"productTypeName": "Regular",
"productWeight": 1,
"totalWeight": 1
},
{
"orderNo": "25000013278",
"orderItemNo": "25000013305",
"qty": 1,
"gdnItemSku": "TOB-16791-00045-00001",
"merchantSku": "SKU-005468458",
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"createdDate": 1505898403772,
"returnId": "56fa05c75c86205e8d6f16fb",
"returnNo": "RMA1041",
"orderNo": "25000013005",
"orderItemNo": "25000013013",
"customerName": "fefe qa",
"gdnSku": "TOQ-15130-00001-00001",
"productName": "Toko QA CM 2 Reguler 1",
"orderQuantity": 1,
"productSalePrice": 100000,
"orderLogistic": null,
"returnStatusCode": "RMA_REQUEST_APPROVAL",
"returnStatus": "Menunggu persetujuan permohonan retur",
"returnResolution": null,
"reason": "PRODUK_TIDAK_BERFUNGSI_DENGAN_BAIK"
},
{
"createdDate": 1505898403772,
"returnId": "56fa349ce4b01f68b053128d",
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"id": "56e27afbe4b01cfcdf46a1af",
"storeId": "10001",
"createdDate": 1457683195698,
"createdBy": "user-dev-rma",
"updatedDate": 1457683195698,
"updatedBy": null,
"returnId": "56e27afbe4b01cfcdf46a1af",
"returnNo": "RMA486",
"orderNo": "25000013005",
"orderItemNo": "25000013013",
"customerName": "fefe qa",
"gdnSku": "TOQ-15130-00001-00001",
"productName": "Toko QA CM 2 Reguler 1 ",
"orderQuantity": 1,
"productSalePrice": 100000,
"returnStatusCode": "RMA_REQUEST_APPROVAL",
"returnStatus": "Menunggu persetujuan permohonan retur",
"productType": "Regular",
"deliveredDate": null,
"returnReason": "PRODUK_TIDAK_BERFUNGSI_DENGAN_BAIK",
"customerAddress": "Jalan Aipda KS tubun 2C Slipi Jakarta Barat",
"customerVillages": "",
"customerDistricts": "",
"customerCity": "Kota Jakarta Barat",
Note. Airwaybill document only available only for Regular Pickup Order and order status is PU (after fulfill order) or CX (in delivery)
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request: Not necessary
Parameter request:
Attribute name Attribute value Description
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
requestId {client-request-id} Unique request ID that generated for each client request
storeId 10001 Default store ID for Blibli
orderItemNo {order-item-no} Order item number value
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"document": "JVBERi0xLjQNCjUgMCBvYmoNCjw8L1R5cGUgL1BhZ2UgL1BhcmVudCAzIDAgUiAvQ29udGVudHMgNiAwIFIgL01
lZGlhQm94IFswIDAgNTk1LjQ0IDg0MS42OF0gL0dyb3VwIDw8IC9DUyAvRGV2aWNlUkdCIC9TIC9UcmFuc3BhcmVuY3kgL1R5cGU
gL0dyb3VwID4+IC9SZXNvdXJjZXM8PC9Gb250PDwvRkFBQUJDIDEyIDAgUiAvRkFBQUFIIDcgMCBSIC9GQUFBQkggMTcgMCBSID4
+L0V4dEdTdGF0ZTw8L0dTMSAyMiAwIFIgL0dTMiAyNCAwIFIgL0dTMyAyNiAwIFIgPj4vWE9iamVjdDw8L1gxIrJDdc51MG4rMnsqu
v4mKtCwmtk2/9fV/15SqIddxU83oHtXmfhFhciV3PYlrOg0uBc7n"
}
}
Attribute name Description
success To indicate whether the download operation is success or not
document The airway bill .pdf document in base64 format
Note: this value is assigned only for merchantDeliveryType = DROPSHIP, if the shipping is
handled by Blibli courrier (merchantDeliveryType = PICKUP) then you don’t need to assign this
attribute
orderNo Order number information
orderItemNo Order item number information
combineShipping List of orders that want to be shipping combined, you can get the combine shipping data from
“7.5 Get Combine Shipping API”
Note: this value must contain at least 1 element for current order number and order item
number
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
storeId 10001 Default store ID for Blibli
If merchant their own logistic, he can assign with the their identified courrier name.
Merchant courier type information, the value must be:
• Merchant courier : if the product is delivered by merchant logistic, if you use this
merchantCourierType
option then isDeliveredByMerchant flag must be true
• 3PL : if the merchant using other third party logistic like: JNE, NCS, etc
merchantDeliveryDateStart Merchant delivery start date in epoch time format
merchantInstallationDateEnd Merchant delivery end date in epoch time format
isInstallationRequired To indicate that current product is needs to installed
Merchant installation start date infomation, if isInstallationRequired flag is false then set this
merchantInstallationDateStart
value with null
Merchant installation end date infomation, if isInstallationRequired flag is false then set this value
merchantInstallationDateEnd
with null
Merchant installation officer information, if isInstallationRequired flag is false then set this value
merchantInstallationOfficer
with null
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true
}
Attribute name Description
success To indicate whether the fulfill operation is success or not
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true
}
Attribute name Description
success To indicate whether the fulfill operation is success or not
If merchant sent complete quantity = 0, then currect order item statux will become X (canceled). Merchant will get punishment if they
did partial fulfilll with zero quantity (OOS).
Authorization request: No Auth
Header request:
Attribute name Attribute value Description
Authorization bearer {token-key} Token key is obtained from “get token API”
x-blibli-mta-authorization BMA {mta-username}:{api-signature} API signature is generate by client like explained in section 2.2
x-blibli-mta-date-milis {current-milli-second} Get this value from: http://currentmillis.com as a reference
Accept application/json Accept type for the current request
Content-Type application/json Content type for the current request
requestId {client-request-id} Unique request ID that generated for each client request
sessionId {client-session-id} Unique session ID that generated for each client session
username {mta-username} MTA web username
Body request:
{
"orderNo":"25000025367",
"orderItemNo":"25000026170",
"completeQuantity": 2,
"reason":"stock is empty"
}
Body attribute name Description
orderNo Order number information
orderItemNo Order item number information
Complete quantity which able to fulfilled, if it set with 0 value so it’s mean that merchant do “out
completeQuantity
of stock” (OOS) fulfillment for current order
reason Partial / OOS reason
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
storeId 10001 Default store ID for Blibli
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
"errorMessage": null,
"errorCode": null,
"success": true
}
Attribute name Description
success To indicate whether the fulfill operation is success or not
For Big Product, merchant can assign the settlement code with free value based on merchant
needs, like: the merchant’s settlement code itself, merchant’s awb itself, etc.
For BOPIS order, merchant must ask the settlement code to customer. Then merchant can use
it to settle the order.
Parameter request:
Attribute name Attribute value Description
requestId {client-request-id} Unique request ID that generated for each client request
businessPartnerCode {merchant-code} Merchant code value for specified merchant partner
storeId 10001 Default store ID for Blibli
Success response
{
"requestId": "73b87463-9550-4a1d-b7bd-2a955559cdff",
Success response
{
"requestId": "7ab7911e-d679-45c7-b405-76bf3ad1c30c",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"status": "finished",
"action": "updateProduct",
"total": 2,
"success": 2,
"failed": 0
}
}
Attribute name Description
requestId Current request ID for bulk process
success To indicate that current operation is success or not
status Queue status information:
• finished: indicate that current bulk process is finished
• on process: indicate that current bulk process is not finished yet
action Bulk operation action type:
• createProduct: for bulk create product operation
• updateProduct: for bulk update product summary operation
• updateDetailProduct: for bulk update detail product operation
• postImage: for bulk upload image operation
total Number of total bulk operation in 1 bulk request
success Number of total success bulk operation
failed Number of total failed bulk operation
Success response
{
"requestId": "4aaf772e-ed91-4176-a056-cc8129e97f6f",
"errorMessage": null,
"errorCode": null,
"success": true,
"content": [
{
"requestId": "80c7f73f-8aae-43d0-9a58-c472c13133ec",
"action": "updateProduct",
"total": 4,
"successCount": 4,
"failedCount": 0,
"status": "finished",
"timeStamp": 1480420814000
},
{
"requestId": "8ab3ff23-e736-4bbc-9a18-44b1eeb4309e",
"action": "createProduct",
"total": 3,
"successCount": 1,
"failedCount": 0,
"status": "in progress",
"timeStamp": 1480420166000
Success response
{
"requestId": "8ab3ff23-e736-4bbc-9a18-44b1eeb4309e",
"errorMessage": null,
"errorCode": null,
"success": true,
"value": {
"queueFeed": {
"requestId": "8ab3ff23-e736-4bbc-9a18-44b1eeb4309e",
"requestAction": "updateProduct",
"total": 1,
"timeStamp": 1480420166411
},
"queueHistory": [
{
"gdnSku": "TOS-16005-00005-00001",
"timestamp": 1480420168275,
"value": "Samsung Galaxy S7",
"isSuccess": true
},
{
"gdnSku": "TOS-16005-00045-00001",
"timestamp": 1480420168275,
"value": "Samsung Galaxy S7",
"isSuccess": false,
"errorMessage": "product sku is not found",
"errorCode": null
}
]
}
}
Attribute name Description
requestId Request ID for current bulk action, using this value merchant can check the bulk
action status/progress in 'Utility API'
requestAction Bulk operation action type: