Update Seller

Path

• URL: /cb-core/api/v1/seller/update
• Method: POST
• Description: This API allows update seller information into the Baokim system

Request

Request table

Params	Data Type	Required	Description
request_id	string(50)	Yes	Request ID from merchant. Format: MerchantCode + YYYYMMDDHHMMSS + UniqueId
request_time	string(19)	Yes	Request timestamp. Format: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Yes	Merchant code provided by Baokim
sub_merchant_code	string(20)	Yes	Sub-merchant code. If seller belongs to merchant directly, fill in merchant_code
seller_id	string(50)	Yes	Seller ID in merchant system
seller_name	string(255)	No	Full name of seller
platform	array	No	Platform information
- type	string	Yes	Platform type: 1: Website 2: E-commerce Platform 3: B2B 4: Service 5: Other
- links	string(255)	Yes*	Platform URL (*Required if type is 1 or 2)
- platform_seller_id	string(255)	Yes*	Seller ID on platform (*Required if type is 2)
files	array	No	Document files (maximum 15 files)
- type	string	Yes	File type: 1: Business License 2: ID Card/Passport/Visa 3: Contract 4: Bank Statement 5: Other
- file	file	Yes	File upload (jpg, jpeg, png, pdf, max: 2MB)
representative_DOB	string	No	Representative's date of birth (Format: YYYY-MM-DD)
representative_ID_number	string(255)	No	Representative's ID number
representative_name	string(255)	No	Representative's full name
representative_nationality	string(255)	No	Representative's nationality
representative_address	string(255)	No	Representative's address
seller_business_type	string	No	Business type: 1: Enterprise 2: Household 3: Individual
seller_business_registration_no	string(255)	Yes*	Business registration number (*Required if business_type is 1 or 2)
seller_phone	string	No	Contact phone number
seller_email	string	No	Contact email (must be valid email format)
seller_business_description	string(255)	No	Business description
seller_risk_level	string	No	Risk level: 1: Low 2: Medium 3: High
gc_code	string(10)	No	Group Category code (must exist in system) Dowload excel
mcc_code	string(10)	No	Merchant Category Code (must exist in system) Dowload excel

Request Example

{
    "request_id": "MERCHANT12345678901234510281",
    "request_time": "2024-11-15 14:36:00",
    "merchant_code": "MERCHANT001",
    "sub_merchant_code": "MERCHANT001",
    "seller_id": "SELLER123456",
    "seller_name": "Nguyễn Văn A",
    "platform": [
        {
            "type": "2",
            "links": "https://shopee.vn/seller123",
            "platform_seller_id": "SHOPEE123456"
        }
    ],
    "files": [
        {
            "type": "1",
            "file": "[binary file data]"
        },
        {
            "type": "2",
            "file": "[binary file data]"
        }
    ],
    "representative_DOB": "1990-01-01",
    "representative_ID_number": "001099012345",
    "representative_name": "Nguyen Van A",
    "representative_nationality": "Vietnam",
    "representative_address": "1 Dai Co Viet Street, Hai Ba Trung District, Ha Noi",
    "seller_business_type": "2",
    "seller_business_registration_no": "0123456789",
    "seller_phone": "0912345678",
    "seller_email": "[email protected]",
    "seller_business_description": "Online retail store selling electronics",
    "seller_risk_level": "1",
    "gc_code": "5045",
    "mcc_code": "5399"
}

Response

Response table

Params	Data Type	Description
response_code	int	Response code from Baokim
response_message	string(255)	Response description
merchant_code	string(20)	Merchant code
seller_id	string(50)	Seller ID

Response Example

{
    "response_code": 200,
    "response_message": "Success",
    "merchant_code" :"MERCHANT001",
    "seller_id": "SELLER123456",
}

Error Codes

Response Code	Response Message	Description
200	Success	Update seller successfully
101	System Error	System error
422	Validation Error	Validation Error