# pdd.dll 使用教程 ## 1.创建DLL工具实例 ### 加载DLL文件 ```gotemplate // PddDLL 拼多多工具DLL结构 type pddDLL struct { dll *syscall.DLL pddGoodsOuterCatMappingGet *syscall.Proc // 类目预测 freeCString *syscall.Proc // 释放C字符串 } // 初始化pddDLL func InitPddDLL() (*pddDLL, error) { dllPath := filepath.Join("dll", "pdd.dll") if _, err := os.Stat(dllPath); os.IsNotExist(err) { return nil, fmt.Errorf("pdd DLL 不存在: %s", dllPath) } if dll, err := syscall.LoadDLL(dllPath); err != nil { return nil, fmt.Errorf("加载pdd DLL 失败: %s", err) } else { return &pddDLL{ dll: dll, pddGoodsOuterCatMappingGet: dll.MustFindProc("PddGoodsOuterCatMappingGet"), freeCString: dll.MustFindProc("FreeCString"), }, nil } } dll, err := InitPddDLL() ``` ### 获取C字符串 ```gotemplate // cStr 获取C字符串 func (m *pddDLL) cStr(p uintptr) string { if p == 0 { return "" } b := []byte{} for i := uintptr(0); ; i++ { c := *(*byte)(unsafe.Pointer(p + i)) if c == 0 { break } b = append(b, c) } s := string(b) if m.freeCString != nil { m.freeCString.Call(p) } return s } ``` ## 2. 使用dll函数示例 ```gotemplate // 类目预测 func (m *pddDLL) PddGoodsOuterCatMappingGet(clientId, clientSecret, accessToken, outerCatId, outerCatName, outerGoodsName string) (string, error) { proc, err := m.dll.FindProc("PddGoodsOuterCatMappingGet") if err != nil { return "", fmt.Errorf("找不到函数 PddGoodsOuterCatMappingGet: %v", err) } clientIdPtr, _ := syscall.BytePtrFromString(clientId) clientSecretPtr, _ := syscall.BytePtrFromString(clientSecret) accessTokenPtr, _ := syscall.BytePtrFromString(accessToken) outerCatIdPtr, _ := syscall.BytePtrFromString(outerCatId) outerCatNamePtr, _ := syscall.BytePtrFromString(outerCatName) outerGoodsNamePtr, _ := syscall.BytePtrFromString(outerGoodsName) resultPtr, _, _ := proc.Call( uintptr(unsafe.Pointer(clientIdPtr)), uintptr(unsafe.Pointer(clientSecretPtr)), uintptr(unsafe.Pointer(accessTokenPtr)), uintptr(unsafe.Pointer(outerCatIdPtr)), uintptr(unsafe.Pointer(outerCatNamePtr)), uintptr(unsafe.Pointer(outerGoodsNamePtr)), ) result := m.cStr(resultPtr) return result, nil } ``` # 接口详情 ## 1. 类目预测--PddGoodsOuterCatMappingGet ### 请求信息 ```gotemplate dll.PddGoodsOuterCatMappingGet(clientId, clientSecret, accessToken, outerCatId, outerCatName, outerGoodsName) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | outerCatId | string | 是 | 外部平台类目ID | | outerCatName | string | 是 | 外部平台类目名称 | | outerGoodsName | string | 是 | 外部商品名称 | ### 响应示例 ```json { "outer_cat_mapping_get_response": { "cat_id2": 16028, "cat_id3": 16031, "cat_id1": 15543, "request_id": "17666480184871649", "cat_id4": 0 } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 2. 快递公司查看--PddLogisticsCompaniesGet ### 请求信息 ```gotemplate dll.PddLogisticsCompaniesGet(clientId, clientSecret) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | ### 响应示例 ```json { "logistics_companies_get_response": { "logistics_companies": [ { "available": 1, "code": "SF", "id": 1, "logistics_company": "顺丰速运" }, { "available": 1, "code": "STO", "id": 2, "logistics_company": "申通快递" } ] } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 3. erp打单信息同步--PddErpOrderSync ### 请求信息 ```gotemplate dll.PddErpOrderSync(clientId, clientSecret, accessToken, logisticsId, orderSn, orderState, waybillNo) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | logisticsId | string | 是 | 物流公司ID | | orderSn | string | 是 | 拼多多订单号 | | orderState | string | 是 | 订单状态 | | waybillNo | string | 是 | 运单号 | ### 响应示例 ```json { "erp_order_sync_response": { "is_success": true, "request_id": "17666480184871650" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 4. 拼多多订单同步--PddOrderSynchronization ### 请求信息 ```gotemplate dll.PddOrderSynchronization(clientId, clientSecret, accessToken, logisticsCompany, logisticsOnlineSendJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | logisticsCompany | string | 是 | 物流公司名称 | | logisticsOnlineSendJson | string | 是 | 拼多多订单同步json字符串 | ### 响应示例 ```json { "erp_order_sync_response": { "is_success": true, "request_id": "17666480184871651" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 5. 商品图片上传接口--PddGoodsImgUpload ### 请求信息 ```gotemplate dll.PddGoodsImgUpload(clientId, clientSecret, accessToken, filePath) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | filePath | string | 是 | 图片文件路径 | ### 响应示例 ```json { "goods_img_upload_response": { "image_url": "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg", "request_id": "17666480184871652" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 6. 商品新增接口--PddGoodsAdd ### 请求信息 ```gotemplate dll.PddGoodsAdd(clientId, clientSecret, accessToken, goodsAddJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | goodsAddJson | string | 是 | 商品信息JSON字符串 | #### 商品信息JSON结构示例 ```json { "goods_name": "测试商品", "goods_desc": "商品描述", "cat_id": 20111, "goods_type": 1, "market_price": 9900, "is_folt": false, "is_pre_sale": false, "is_refundable": true, "shipment_limit_second": 86400, "cost_template_id": 10001, "image_url": "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg", "carousel_gallery": [ "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg" ], "detail_gallery": [ "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg" ], "sku_list": [ { "out_sku_sn": "SKU001", "price": 8900, "quantity": 100, "spec_id_list": "1001:10001", "sku_properties": [ { "ref_pid": 1001, "value": "红色", "vid": 10001, "punit": "个" } ], "is_onsale": 1, "limit_quantity": 10, "multi_price": 8500, "thumb_url": "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg", "weight": 500 } ] } ``` ### 响应示例 ```json { "goods_add_response": { "goods_id": 123456789, "goods_name": "测试商品", "goods_sn": "G202501200001", "request_id": "17666480184871653" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 7. 联合拼多多图片上传的商品新增--SelfPddGoodsAdd ### 请求信息 ```gotemplate dll.SelfPddGoodsAdd(clientId, clientSecret, accessToken, filePath, goodsAddJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | filePath | string | 是 | 图片文件路径 | | goodsAddJson | string | 是 | 商品信息JSON字符串（不需包含image_url）| #### 接口说明 此接口为组合接口，内部执行以下步骤： 1.上传商品主图文件到拼多多服务器 2.获取图片URL并自动填充到商品信息中 3.调用商品新增接口创建商品 #### 商品信息JSON结构示例 ```json { "goods_name": "测试商品", "goods_desc": "商品描述", "cat_id": 20111, "goods_type": 1, "market_price": 9900, "is_folt": false, "is_pre_sale": false, "is_refundable": true, "shipment_limit_second": 86400, "cost_template_id": 10001, "image_url": "", "carousel_gallery": [ "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg" ], "detail_gallery": [ "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg" ], "sku_list": [ { "out_sku_sn": "SKU001", "price": 8900, "quantity": 100, "spec_id_list": "1001:10001", "sku_properties": [ { "ref_pid": 1001, "value": "红色", "vid": 10001, "punit": "个" } ], "is_onsale": 1, "limit_quantity": 10, "multi_price": 8500, "thumb_url": "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg", "weight": 500 } ] } ``` ### 响应示例 ```json { "goods_add_response": { "goods_id": 123456790, "goods_name": "测试商品", "goods_sn": "G202501200002", "request_id": "17666480184871654" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 8. 批量数据解密脱敏接口--PddOpenDecryptMaskBatch ### 请求信息 ```gotemplate dll.PddOpenDecryptMaskBatch(clientId, clientSecret, accessToken, reqJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | reqJson | string | 是 | 信息JSON字符串 | #### 信息JSON结构示例 ```json [ { "data_tag": "251229-272441044622514", "encrypted_data": "~AgAAAAPlscEH0psOJAEXpTdsLOWvDJ9bB7IEjIoqNfiDhhJR9NHOxsdZ+PEFluSSCngCikoDU+CP/sSXZJ92ic7+PdNlJNLA7g/6VUMDWF6RvjW9IeRN+lKNarsjWDQR~0~" } ] ``` ### 响应示例 ```json { "open_decrypt_mask_batch_response": { "data_decrypt_list": [ { "data_tag": "str", "data_type": 0, "decrypted_data": "str", "encrypted_data": "str", "error_code": 0, "error_msg": "str" } ] } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 生成商家自定义的规格--PddGoodsSpecIdGet ### 请求信息 ```gotemplate dll.PddGoodsSpecIdGet(clientId, clientSecret, accessToken, parentSpecId, specName) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | parentSpecId | string | 是 | 拼多多标准规格ID | | specName | string | 是 | 商家编辑的规格值，如颜色规格下设置白色属性 | ### 响应参数 ```json { "goods_spec_id_get_response": { "parent_spec_id": 0, "spec_id": 0, "spec_name": "str" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 修改商品SKU价格--PddGoodsSkuPriceUpdate ### 请求信息 ```gotemplate dll.PddGoodsSkuPriceUpdate(clientId, clientSecret, accessToken, request) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|-----------------------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | request | string | 是 | 价格更新请求JSON字符串 | #### 请求JSON结构 ```json { "goods_id": "必填，商品id，类型为LONG", "ignore_edit_warn": "非必填，是否获取商品发布警告信息，默认为忽略，类型为BOOLEAN", "market_price": "非必填，参考价（单位分），类型为LONG", "market_price_in_yuan": "非必填，参考价（单位元），类型为STRING", "sku_price_list": [ { "group_price": "非必填，拼团购买价格（单位分），类型为LONG", "is_onsale": "非必填，sku上架状态，0-已下架，1-上架中，类型为INTEGER", "single_price": "非必填，单独购买价格（单位分），类型为LONG", "sku_id": "必填，sku标识，类型为LONG" } ], "sync_goods_operate": "非必填，提交后上架状态，0:上架,1:保持原样，类型为INTEGER", "two_pieces_discount": "非必填，满2件折扣，可选范围0-100，0表示取消，95表示95折，设置需先查询规则接口获取实际可填范围，类型为INTEGER" } ``` ### 响应参数 ```json { "goods_update_sku_price_response": { "goods_commit_id": 0, "is_success": true } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 商品库存更新接口--PddGoodsQuantityUpdate ### 请求信息 ```gotemplate dll.PddGoodsQuantityUpdate(clientId, clientSecret, accessToken, request) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|---------------------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | request | string | 是 | 库存更新请求JSON字符串 | #### 请求JSON结构 request 字符串 ```json { "force_update": "非必填，是否强制更新，仅update_type=1(全量更新)时有效，默认值false；force_update=false时，quantity不能小于预扣库存；force_update=true时，代表强制更新，当quantity<预扣库存时，不报错，直接将quantity清0，类型为BOOLEAN", "goods_id": "必填，商品id，类型为LONG", "outer_id": "非必填，sku商家编码，类型为STRING", "quantity": "必填，库存修改值。当全量更新库存时，quantity必须为大于等于0的正整数；当增量更新库存时，quantity为整数，可小于等于0。若增量更新时传入的库存为负数，则负数与实际库存之和不能小于0。比如当前实际库存为1，传入增量更新quantity=-1，库存改为0，类型为LONG", "sku_id": "非必填，sku_id和outer_id必填一个，类型为LONG", "update_type": "非必填，库存更新方式，可选。1为全量更新，2为增量更新。如果不填，默认为全量更新，类型为INTEGER" } ``` ### 响应参数 ```json { "goods_quantity_update_response": { "is_success": false } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 12. 商品图片上传接口（base64方式）--PddGoodsImageUpload ### 请求信息 ```gotemplate dll.PddGoodsImageUpload(clientId, clientSecret, accessToken, fileBase) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | fileBase | string | 是 | 图片base64编码字符串 | ### 响应示例 ```json { "goods_image_upload_response": { "image_url": "http://oms-imageimg.pinduoduo.com/upload/2025/01/20/e9a8c1b6e1a84f1d8d7c3a8b9e2f5c7d.jpg", "request_id": "17666480184871655" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 13. 订单基础信息列表查询接口（根据成交时间）--PddOrderBasicListGet ### 请求信息 ```gotemplate dll.PddOrderBasicListGet(clientId, clientSecret, accessToken, orderBasicListGetJSONStr) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | orderBasicListGetJSONStr | string | 是 | 订单列表查询JSON字符串 | #### 请求JSON结构示例 ```json { "order_status": 1, "refund_status": 1, "start_confirm_at": 1700000000, "end_confirm_at": 1700100000, "page": 1, "page_size": 50 } ``` ### 响应示例 ```json { "order_basic_list_get_response": { "order_list": [ { "order_sn": "250101-123456789", "goods_id": 123456789, "goods_name": "测试商品", "goods_quantity": 1, "order_amount": 8900, "order_status": 1, "confirm_time": 1700000000 } ], "total_count": 100, "request_id": "17666480184871656" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 14. 获取商品提交的商品详情--PddGoodsCommitDetailGet ### 请求信息 ```gotemplate dll.PddGoodsCommitDetailGet(clientId, clientSecret, accessToken, goodsCommitId, goodsId) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | goodsCommitId | string | 是 | 商品提交ID | | goodsId | string | 是 | 商品ID | ### 响应示例 ```json { "goods_commit_detail_get_response": { "goods_id": 123456789, "goods_name": "测试商品", "cat_id": 20111, "goods_desc": "商品描述", "image_url": "http://oms-imageimg.pinduoduo.com/upload/xxx.jpg", "sku_list": [], "request_id": "17666480184871657" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 15. 获取拼多多系统时间--PddTimeGet ### 请求信息 ```gotemplate dll.PddTimeGet(clientId, clientSecret, accessToken) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | ### 响应示例 ```json { "time_get_response": { "time": 1700000000000, "request_id": "17666480184871658" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 16. 查询面单服务订购及面单使用情况--PddWaybillSearch ### 请求信息 ```gotemplate dll.PddWaybillSearch(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 查询参数JSON字符串 | #### 请求JSON结构示例 ```json { "wp_code": "STO" } ``` ### 响应示例 ```json { "waybill_search_response": { "wp_code": "STO", "total_quantity": 1000, "used_quantity": 100, "created_at": 1700000000, "request_id": "17666480184871659" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 17. 电子面单取号--PddFdsWaybillGet ### 请求信息 ```gotemplate dll.PddFdsWaybillGet(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 取号请求JSON字符串 | #### 请求JSON结构示例 ```json { "wp_code": "STO", "order_sn": "250101-123456789", "sender": { "name": "张三", "mobile": "13800000000", "province": "广东省", "city": "深圳市", "town": "南山区", "address": "xx街道xx号" }, "receiver": { "name": "李四", "mobile": "13900000000", "province": "广东省", "city": "广州市", "town": "天河区", "address": "xx街道xx号" } } ``` ### 响应示例 ```json { "fds_waybill_get_response": { "waybill_code": "1234567890", "print_data": "{\"content\": \"打印数据\"}", "request_id": "17666480184871660" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 18. 商家取消获取的电子面单号--PddWaybillCancel ### 请求信息 ```gotemplate dll.PddWaybillCancel(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 取消面单请求JSON字符串 | #### 请求JSON结构示例 ```json { "wp_code": "STO", "waybill_code": "1234567890" } ``` ### 响应示例 ```json { "waybill_cancel_response": { "is_success": true, "request_id": "17666480184871661" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 19. 商品列表接口--PddGoodsListGet ### 请求信息 ```gotemplate dll.PddGoodsListGet(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 商品列表查询JSON字符串 | #### 请求JSON结构示例 ```json { "is_onsale": 1, "page": 1, "page_size": 50 } ``` ### 响应示例 ```json { "goods_list_get_response": { "goods_list": [ { "goods_id": 123456789, "goods_name": "测试商品", "goods_sn": "G202501200001", "goods_status": 1, "goods_type": 1 } ], "total_count": 100, "request_id": "17666480184871662" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 20. 电子面单云打印接口--PddWaybillGet ### 请求信息 ```gotemplate dll.PddWaybillGet(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印请求JSON字符串 | #### 请求JSON结构示例 ```json { "wp_code": "STO", "waybill_code": "1234567890" } ``` ### 响应示例 ```json { "waybill_get_response": { "print_data": "{\"content\": \"打印数据\"}", "request_id": "17666480184871663" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 21. 通过面单号查询面单信息--PddWaybillQueryByWaybillcode ### 请求信息 ```gotemplate dll.PddWaybillQueryByWaybillcode(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 查询面单信息JSON字符串 | #### 请求JSON结构示例 ```json { "wp_code": "STO", "waybill_code": "1234567890" } ``` ### 响应示例 ```json { "waybill_query_by_waybillcode_response": { "wp_code": "STO", "waybill_code": "1234567890", "order_sn": "250101-123456789", "print_data": "{\"content\": \"打印数据\"}", "request_id": "17666480184871664" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 22. 云打印--PddCloudPrint ### 请求信息 ```gotemplate dll.PddCloudPrint(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印请求JSON字符串 | #### 请求JSON结构示例 ```json { "print_data": "{\"content\": \"打印数据\"}", "printer_id": "printer_001" } ``` ### 响应示例 ```json { "cloud_print_response": { "is_success": true, "request_id": "17666480184871665" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 23. 云打印任务查询--PddCloudPrintTaskQuery ### 请求信息 ```gotemplate dll.PddCloudPrintTaskQuery(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印任务查询JSON字符串 | #### 请求JSON结构示例 ```json { "task_id": "task_001" } ``` ### 响应示例 ```json { "cloud_print_task_query_response": { "task_id": "task_001", "task_status": 2, "request_id": "17666480184871666" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 24. 云打印验证码--PddCloudPrintVerifyCode ### 请求信息 ```gotemplate dll.PddCloudPrintVerifyCode(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印验证码请求JSON字符串 | #### 请求JSON结构示例 ```json { "printer_id": "printer_001", "verify_code": "123456" } ``` ### 响应示例 ```json { "cloud_print_verify_code_response": { "is_success": true, "request_id": "17666480184871667" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 25. 云打印机绑定--PddCloudPrinterBind ### 请求信息 ```gotemplate dll.PddCloudPrinterBind(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印机绑定JSON字符串 | #### 请求JSON结构示例 ```json { "printer_id": "printer_001", "printer_name": "前台打印机" } ``` ### 响应示例 ```json { "cloud_printer_bind_response": { "is_success": true, "printer_id": "printer_001", "request_id": "17666480184871668" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 26. 云打印机设置--PddCloudPrinterSetting ### 请求信息 ```gotemplate dll.PddCloudPrinterSetting(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印机设置JSON字符串 | #### 请求JSON结构示例 ```json { "printer_id": "printer_001", "auto_print": 1, "print_count": 1 } ``` ### 响应示例 ```json { "cloud_printer_setting_response": { "is_success": true, "request_id": "17666480184871669" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 27. 云打印机状态查询--PddCloudPrinterStatusQuery ### 请求信息 ```gotemplate dll.PddCloudPrinterStatusQuery(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 云打印机状态查询JSON字符串 | #### 请求JSON结构示例 ```json { "printer_id": "printer_001" } ``` ### 响应示例 ```json { "cloud_printer_status_query_response": { "printer_id": "printer_001", "printer_status": 1, "request_id": "17666480184871670" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 28. 商品上架状态设置--PddGoodsSaleStatusSet ### 请求信息 ```gotemplate dll.PddGoodsSaleStatusSet(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 商品上架状态设置JSON字符串 | #### 请求JSON结构示例 ```json { "goods_id": 123456789, "is_onsale": 1 } ``` ### 响应示例 ```json { "goods_sale_status_set_response": { "is_success": true, "goods_id": 123456789, "request_id": "17666480184871671" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 29. 删除商品接口--PddDeleteGoodsCommit ### 请求信息 ```gotemplate dll.PddDeleteGoodsCommit(clientId, clientSecret, accessToken, requestJson) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | clientId | string | 是 | 拼多多开放平台ClientID | | clientSecret | string | 是 | 拼多多开放平台ClientSecret | | accessToken | string | 是 | 授权令牌 | | requestJson | string | 是 | 删除商品请求JSON字符串 | #### 请求JSON结构示例 ```json { "goods_id": 123456789 } ``` ### 响应示例 ```json { "delete_goods_commit_response": { "is_success": true, "goods_id": 123456789, "request_id": "17666480184871672" } } ``` ### 错误响应示例 ```json { "error_response": { "error_msg": "公共参数错误:type", "sub_msg": "", "sub_code": null, "error_code": 10001, "request_id": "15440104776643887" } } ``` ## 获取商品信息接口 -- OutPddAuthGetCommitDetailt ### 请求信息 ```gotemplate dll.OutPddAuthGetCommitDetailt(goodsCommitId, goodsId, accessToken) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | goodsCommitId | string | 是 | 商品提交ID | | goodsId | string | 是 | 商品ID | | accessToken | string | 是 | 授权令牌 | ### 响应参数 ```json ``` ## 获取商品详情信息接口 -- OutPddAuthGetGoodsDetail ### 请求信息 ```gotemplate dll.OutPddAuthGetGoodsDetail(goodsId, accessToken) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | goodsId | string | 是 | 商品ID | | accessToken | string | 是 | 授权令牌 | ### 响应参数 ```json { "bad_fruit_claim": 0, "buy_limit": 999999, "carousel_gallery_list": [ "https://img.pddpic.com/open-gw/2025-06-30/59c30d4c-193f-40a3-a639-7af59a381ec5.jpeg", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2023-09-07/02a5c39a-7a90-4530-a338-3e87095a21a9.png", "https://img.pddpic.com/open-gw/2025-06-30/4539f740-331b-4687-aa00-5c96855de6cd.jpeg", "https://img.pddpic.com/open-gw/2025-06-30/b0e89e39-c97b-475d-9be2-f1909e30acb5.jpeg" ], "cat_id": 15678, "cost_template_id": 655688447565777, "country_id": 0, "customer_num": 2, "customs": "", "detail_gallery_list": [ "https://img.pddpic.com/open-gw/2025-06-30/b691c104-baf8-42b2-97e2-b7258113114b.jpeg", "https://img.pddpic.com/open-gw/2023-09-07/53e6f7ff-d15e-4e8f-8625-e293717ca1e4.jpeg", "https://img.pddpic.com/open-gw/2023-09-07/ecff591d-32a6-42c9-ba5a-6a42829092a8.jpeg", "https://img.pddpic.com/open-gw/2023-10-16/7034f8a0-5d88-49f8-a96f-608abb8cac80.jpeg", "https://img.pddpic.com/open-gw/2023-10-16/e10c2b6c-d4de-4fdd-8d48-f0a334735e9a.jpeg", "https://img.pddpic.com/open-gw/2023-10-16/c19358fb-0a4d-49ad-bcc8-b2980e938064.jpeg", "https://img.pddpic.com/open-gw/2025-06-30/1deeb9c0-7212-432b-a309-f774db6e1adb.jpeg" ], "goods_desc": "书名：金属工艺学 下 第6版，作者：'邓文英，宋力宏主编'，ISBN：9787040456295，出版社：高等教育出版社", "goods_id": 770621582375, "goods_name": "金属工艺学 下 第6版 邓文英，宋力宏主编 高等教育出版社 978", "goods_property_list": [ { "punit": "", "ref_pid": 425, "template_pid": 401030, "vid": 0, "vvalue": "9787040456295" }, { "punit": "", "ref_pid": 876, "template_pid": 401029, "vid": 0, "vvalue": "金属工艺学 下 第6版" }, { "punit": "页", "ref_pid": 692, "template_pid": 401032, "vid": 0, "vvalue": "157" }, { "punit": "元", "ref_pid": 879, "template_pid": 401034, "vid": 0, "vvalue": "24.70" }, { "punit": "", "ref_pid": 882, "template_pid": 401037, "vid": 0, "vvalue": "邓文英，宋力宏主编" }, { "punit": "", "ref_pid": 880, "template_pid": 401035, "vid": 483761, "vvalue": "高等教育出版社" }, { "punit": "", "ref_pid": 888, "template_pid": 401043, "vid": 0, "vvalue": "平装" } ], "goods_type": 1, "image_url": "", "invoice_status": 0, "is_customs": 0, "is_folt": 0, "is_group_pre_sale": 0, "is_pre_sale": 0, "is_refundable": 1, "is_sku_pre_sale": 0, "market_price": 5948, "order_limit": 999999, "outer_goods_id": "9787040456295", "oversea_type": 0, "pre_sale_time": 0, "privacy_delivery": 0, "quan_guo_lian_bao": 0, "second_hand": 1, "shipment_limit_second": 172800, "sku_list": [ { "is_onsale": 1, "limit_quantity": 999999, "multi_price": 1487, "out_sku_sn": "9787040456295", "price": 1587, "quantity": 0, "reserve_quantity": 0, "sku_id": 1753931570290, "sku_pre_sale_time": 0, "spec": [ { "parent_id": 1216, "parent_name": "尺寸", "spec_id": 27632894279, "spec_name": "单本 无附赠 超七天不退换" } ], "thumb_url": "https://img.pddpic.com/open-gw/2025-06-30/59c30d4c-193f-40a3-a639-7af59a381ec5.jpeg", "weight": 500 } ], "status": 4, "tiny_name": "金属工艺学 下 第6", "two_pieces_discount": 96, "video_gallery": [], "warehouse": "", "warm_tips": "", "zhi_huan_bu_xiu": 0 } ``` ## 生成自定义规格接口 -- OutPddAuthSetSpec ### 请求信息 ```gotemplate dll.OutPddAuthSetSpec(specTypeId, specName, accessToken) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | specTypeId | int | 是 | 规格类型ID | | specName | string | 是 | 规格名称 | | accessToken | string | 是 | 授权令牌 | ### 响应参数 ```json { "parentSpecId": 3820, "specName": "全新", "specId": 1080396526 } ``` ## 修改价格接口 -- OutPddAuthUpdatePrice ### 请求信息 ```gotemplate dll.OutPddAuthUpdatePrice(jsonData) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|-----------------| | jsonData | int | 是 | 价格修改信息JSON字符串 | ### 响应参数 ```json [ { "success": true, "msg": "操作成功" }, { "success": false, "msg": "操作失败" } ] ``` ## 修改库存接口 -- OutPddAuthUpdateStock ### 请求信息 ```gotemplate dll.OutPddAuthUpdateStock(jsonData) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|-----------------| | jsonData | int | 是 | 价格修改信息JSON字符串 | ### 响应参数 ```json [ { "success": true, "msg": "操作成功" }, { "success": false, "msg": "操作失败" } ] ``` ## 12.释放C字符串内存--FreeCString ### 请求信息 ```gotemplate dll.FreeCString(str) ``` ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--|--|--|----------| | str | string | 是 | 需要释放的字符串 |