Cập Nhật Seller
Đường dẫn
- URL:
/cb-core/api/v1/seller/update - Method:
POST - Mô tả: API cho phép cập nhật thông tin seller trong hệ thống Baokim
Request
Bảng Request
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| request_id | string(50) | Có | Request ID từ merchant. Định dạng: MerchantCode + YYYYMMDDHHMMSS + UniqueId |
| request_time | string(19) | Có | Thời gian request. Định dạng: YYYY-MM-DD HH:MM:SS |
| merchant_code | string(20) | Có | Merchant code được cung cấp bởi Baokim |
| sub_merchant_code | string(20) | Có | Mã sub-merchant. Nếu seller trực thuộc merchant, điền merchant_code |
| seller_id | string(50) | Có | Mã Seller trong hệ thống merchant |
| seller_name | string(255) | Không | Tên đầy đủ của seller |
| platform | array | Không | Thông tin nền tảng |
| - type | string | Có | Loại nền tảng: 1: Website 2: Nền tảng Thương mại điện tử 3: B2B 4: Dịch vụ 5: Khác |
| - links | string(255) | Có* | URL nền tảng (*Bắt buộc nếu type là 1 hoặc 2) |
| - platform_seller_id | string(255) | Có* | Mã Seller trên nền tảng (*Bắt buộc nếu type là 2) |
| files | array | Không | Các tệp tài liệu (tối đa 15 tệp) |
| - type | string | Có | Loại tệp: 1: Giấy phép kinh doanh 2: CMND/Hộ chiếu/Visa 3: Hợp đồng 4: Báo cáo Ngân hàng 5: Khác |
| - file | file | Có | Tải lên tệp (jpg, jpeg, png, pdf, tối đa: 2MB) |
| representative_DOB | string | Không | Ngày sinh của đại diện (Định dạng: YYYY-MM-DD) |
| representative_ID_number | string(255) | Không | Số ID của đại diện |
| representative_name | string(255) | Không | Tên đầy đủ của đại diện |
| representative_nationality | string(255) | Không | Quốc tịch của đại diện |
| representative_address | string(255) | Không | Địa chỉ của đại diện |
| seller_business_type | string | Không | Loại hình kinh doanh: 1: Doanh nghiệp 2: Hộ kinh doanh 3: Cá nhân |
| seller_business_registration_no | string(255) | Có* | Số đăng ký kinh doanh (*Bắt buộc nếu business_type là 1 hoặc 2) |
| seller_phone | string | Không | Số điện thoại liên hệ |
| seller_email | string | Không | Email liên hệ (phải là định dạng email hợp lệ) |
| seller_business_description | string(255) | Không | Mô tả kinh doanh |
| seller_risk_level | string | Không | Mức rủi ro: 1: Thấp 2: Trung bình 3: Cao |
| gc_code | string(10) | Không | Mã nhóm danh mục (phải tồn tại trong hệ thống) Tải excel |
| mcc_code | string(10) | Không | Mã danh mục Merchant (phải tồn tại trong hệ thống) Tải excel |
Ví dụ Request
{
"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
Bảng Response
| Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
| response_code | int | Mã phản hồi từ Baokim |
| response_message | string(255) | Mô tả phản hồi |
| merchant_code | string(20) | Mã Merchant |
| seller_id | string(50) | Mã Seller |
Ví dụ Response
{
"response_code": 200,
"response_message": "Success",
"merchant_code" :"MERCHANT001",
"seller_id": "SELLER123456",
}
Mã Lỗi
| Mã Response | Thông báo Response | Mô tả |
|---|---|---|
| 200 | Thành công | Cập nhật seller thành công |
| 101 | Lỗi Hệ thống | Lỗi hệ thống |
| 422 | Lỗi xác thực | Lỗi xác thực |