微信咨询

微信咨询

13610*910*9

服务热线 7*24小时

电话咨询

棉花果API接口

iamdu2026-01-08 23:58:22 浏览: 206
// 请求域名https://www.58mhg.com

// 棉花果对外API签名
HTTP协议Header头部参数

X-AccessKeyId:
X-Timestamp:
X-Signature:

说明
path为API请求路径 例如:/index/corporations/accessKey
X-Timestamp = 时间戳(秒) 例如: 1736156094
X-Signature计算方式: md5(access_key_secret + '&' + timestamp + '&' + path)


// 新建/修改款式
// 请求路径: /index/category/save
{
  "id": 27723, // 有id为更新
  "cId": "C00175",
  "openId": null,
  "name": "绣花测试",
  "size": [
    "XS"
  ],
  "brand": "",
  "color": [
    "白色"
  ],
  "major": [],
  "minor": [],
  "designer": "",
  "season": [],
  "release": "2021-06-09 00:00:00",
  "type": null,
  "class": null,
  "remark": null,
  "customerId": null, // 客户id
  "department": null, // 生产部门id
  "imageUrl": "",
  "imageUrls": [],
  "imageId": 123, // 主图id
  "imageIds": [1, 2, 3, 4], // 款式子图id
  "colorImages": {
    "白色": ""
  },
  "part": "",
  "gender": "",
  "sizes": null,
  "crafts": null,
  "majors": [],
  "minors": [],
  "masks": [],
  "cloths": [{
    "id": null, // 更新则传后端返回的
    "cloth_id": 1,
    "part": "部位",
    "cloth_color": "黑色", // 布料颜色
    "use_colors": ["黑色"], // 对应款式颜色(为空为通用)
    "dosage": 1, // 用量
    "remark": "备注",
  }], // 布料信息
  "accessories": [{
    "id": null, // 更新则传后端返回的
    "accessory_id": 1, // 辅料id
    "value_id": 1, // 规格id
    "part": "部位",
    "use_colors": ["黑色"], // 对应款式颜色(为空为通用)
    "use_sizes": ["XL"], // 对应款式尺码(为空为通用)
    "dosage": 1, // 用量
    "remark": "备注",
  }], // 辅料信息
  "delClothIds": [1, 2], // 删除的布料id
  "delAccessoryIds": [1, 2], // 删除的辅料id
  "tags": {
    "address": "",
    "cost": 0,
    "factory": "",
    "price": 0,
    "phone": "",
    "quality": "",
    "safeType": "",
    "standard": "",
    "wash": [],
    "color": "ll",
    "size": "size",
    "remark": ""
  },
  "cost": {
    "profit": 0,
    "price": 0,
    "totalCost": 12,
    "mask": 12,
    "affix": 0
  },
  "createTime": 1623223823000,
  "upTime": 1623223823000,
  "htmlSizes": null,
  "operator": "eekrRt7Yo9TLL0FrJeODubMFPrGmelIS",
  "isMulti": false,
  "isReView": false,
  "attachs": null,
  "outsource": [{
    "name": "裁床加工",
    "flow_id": 1,
    "items": [{
      "id": null,
      "to_ltdids": [],
      "price": 1,
      "default": true // 默认单价
    }]
  }],
  "delOutsourceIds": [1, 2], // 删除的外发单价id
  "isMultiPrice": false,
  "multiPrice": 1,
  "isSizesPrice": false,
  "isRoleStep": false,
  "bundleCount": 0,
  "styleNo": "C00175",
  "steps": [],
  "isCopy": false // true为复制款式
}


// 获取款式列表
// 请求路径: /index/category/getList
{
  "pageIndex": 1,
  "pageSize": 10,
  "key": null, // styleNo:款式编号, styleName:款式名称, remark:备注
  "keyWord": "", // 搜索款式关键字
  "class": ["内衣配饰", "女士睡衣", "聚拢文胸"], // 筛选款式分类
  "class2": 1, // 筛选款式高级分类id (传0为未分类)
  "customerId": 1, // 客户id
  "departments": [], // 生产部门,
}

{
  "data": [{
    "id": 27636,
    "cId": "C00142", // 款式编号
    "name": "针织衫", // 款式名称
    "upTime": 1615528176000,
    "imageUrl": "\/upload\/images\/2\/5e538d98e520c.jpg",
    "multiPrice": 1,
    "operator": "操作人",
    "createTime": 1614387564000,
    "remark": null
  }],
  "message": "",
  "code": 200,
  "pageItem": 96
}

// 获取款式明细
// 请求路径: /index/category/get
{
  "id":"29769"
}

{
    "data": {
        "id": 29769,
        "cId": "6793749276",
        "openId": null,
        "name": "我是你的cc阿 甜系小奶喵~短袖T恤女夏短款修身撞色...",
        "size": [
            "petite S",
            "XXS",
            "petite XS",
            "S",
            "petite XXS"
        ],
        "brand": null,
        "color": [
            "白色"
        ],
        "major": [],
        "minor": [],
        "designer": null,
        "season": [],
        "release": -62170013143000,
        "type": null,
        "class": null,
        "class2": null,
        "customerId": null,
        "department": null,
        "remark": "(TEMU款)",
        "imageUrl": "http:\/\/local-dev.58mhg.com:3070\/image\/4\/46d51986839d3024b9a4ab4e82e9dcf5.jpeg",
        "imageUrls": null,
        "imageId": null,
        "imageIds": null,
        "colorImages": {
            "白色": "http:\/\/local-dev.58mhg.com:3070\/image\/1\/46d51986839d3024b9a4ab4e82e9dcf5.jpeg"
        },
        "part": null,
        "gender": null,
        "sizes": null,
        "sizesSort": null,
        "crafts": null,
        "masks": [],
        "tags": {
            "address": "",
            "cost": 0,
            "factory": "",
            "price": 0,
            "phone": "",
            "quality": "",
            "safeType": "",
            "standard": "",
            "wash": [],
            "color": "ll",
            "size": "size",
            "remark": ""
        },
        "cost": {
            "profit": 0,
            "price": 0,
            "totalCost": 0.3,
            "mask": 0,
            "affix": 0.3
        },
        "createTime": 1753348335000,
        "upTime": 1764297430000,
        "htmlSizes": null,
        "operator": "Vz2fhX1MYT3MQVkrkQqQ5JTGWKKAjlDY",
        "isMulti": false,
        "isReView": false,
        "attachs": null,
        "outsourcePrice": {
            "custome": {},
            "price": 0
        },
        "stepTags": null,
        "source": "temu",
        "isMultiPrice": false,
        "multiPrice": 1,
        "isSizesPrice": false,
        "isRoleStep": false,
        "bundleCount": 0,
        "isDesign": 0,
        "stepAudited": 1,
        "suitId": 0,
        "styleNo": "6793749276",
        "steps": [
            {
                "sid": 696441,
                "pid": null,
                "name": "666工序",
                "isOpen": true,
                "bundlePrice": 0,
                "price": 0.1,
                "remark": "",
                "duration": 0,
                "isRecord": false,
                "recordQuantity": null,
                "imageIds": [],
                "upTime": "2025-11-28 10:37:10",
                "sort": 1,
                "multiPrice": 1,
                "roleIds": [],
                "departmentIds": [],
                "tag": "",
                "unPay": false,
                "isReview": false,
                "prices": [
                    {
                        "id": 708601,
                        "cost": 0.1,
                        "priceSort": 0,
                        "roleId": null,
                        "sizes": null,
                        "roleName": null,
                        "multiPriceId": null
                    }
                ],
                "hashId": "9mLyQj"
            },
            {
                "sid": 696442,
                "pid": null,
                "name": "777工序",
                "isOpen": true,
                "bundlePrice": 0,
                "price": 0.2,
                "remark": "",
                "duration": 0,
                "isRecord": false,
                "recordQuantity": null,
                "imageIds": [],
                "upTime": "2025-11-28 10:37:10",
                "sort": 2,
                "multiPrice": 1,
                "roleIds": [],
                "departmentIds": [],
                "tag": "",
                "unPay": false,
                "isReview": false,
                "prices": [
                    {
                        "id": 708602,
                        "cost": 0.2,
                        "priceSort": 0,
                        "roleId": null,
                        "sizes": null,
                        "roleName": null,
                        "multiPriceId": null
                    }
                ],
                "hashId": "Za05EP"
            }
        ],
        "outsource": [],
        "cloths": [],
        "accessories": []
    },
    "message": "",
    "code": 200
}


// 新建订单
// 请求路径: /index/category/createOrder
{
  "cid": 1234, // 款式主键
  "delivery": "2019-03-31",
  "openid": "o913-0HJjEUn42yFfbzk3AW2pT34",
  "ono": "D00059", // 订单编号
  "customer": 1008, // 客户id
  "amount": 90, // 下单总数
  "quota": { // 订单配额
    "黑色": {
      "M": 20,
      "L": 10,
      "XL": 20
    },
    "白色": {
      "M": 20,
      "L": 10,
      "XL": 20
    }
  },
  "remark": "备注内容",
  "cutControl": false, // 裁量控制
  "multiMachine": false, // 多次编菲
  "department": 20, // 生产部门(部门id)
  "leader": "o913-0HJjEUn42yFfbzk3AW2pT34", // 生产组长
  "cutters": ["o913-0HJjEUn42yFfbzk3AW2pT34"], // 裁床人员
  "materialTag": "螺纹布", // 布料种类
  "bindOrderIds": ["xxxx"], // 关联订单id
  "customName": "定制客户名称",
  "crafts": "工艺要求<html>",
  "sizes": null, // 尺码表
  "useStock": false, // 生成领料单
  "unionOrder": false // 联合外发单
}


// 获取订单列表
// 请求路径: /index/orders/getList
{
  "pageSize": 10,
  "pageIndex": 1,
  "keyWord": "", // 关键字搜索
  "startDate": "2019-03-01", // 订单开始时间 开始时间和结束时间必须同时出现
  "endDate": "2019-03-12", // 订单结束时间
  "startOut": "2019-03-01", // 交货开始时间 开始时间和结束时间必须同时出现
  "endOut": "2019-03-12", // 交货结束时间
  "startBuild": "2019-03-01", // 编菲开始时间 开始时间和结束时间必须同时出现
  "endBuild": "2019-03-12", // 编菲结束时间
  "isOutsource": "", // 是否筛选外发 0:本厂 1:外发 2:外接
  "isBuild": true, // 是否编菲 !!!不需要过滤则不传该字段
  "cId": 1234, // 获取款式的订单(款式主键id)(款式工序同步)
  "orderIds": ["xxx"], // 订单hash主键
  "isLock": true, // 是否筛选订单锁 !!!不需要过滤则不传该字段
  "isLockStep": false, // 锁住工序不同步的订单
  "withCutter": true, // 是否显示裁床人员 订单总件数返回在message字段
  "showMachines": true, // 显示多床次
  "class": [], // 类目
  "styleNo": "", // 款式编号
  "brand": "", // 品牌
  "customerIds": [], // 客户id 数组
  "customName": "xxxx", // 定制客户名称
  "merchandisers": [], // 跟单员openid
  "machines": [617, 618], // 床次
  "machine": "", // 床次模糊搜索
  "departments": [], // 生产部门,
  "leaders": [], // 部门组长,
  "cutters": [], // 裁床人员,
  "isUnCut": false, // 未裁订单
  "isComplete": null, // 是否已完成 null(不传):全部 true:100% false: <100%
  "completeStartDate": "2019-03-01", // 完成开始时间(只显示已完成) 开始时间和结束时间必须同时出现
  "completeEndDate": "2019-03-12", // 完成结束时间
  "isMaterial": null, // 订单类型 null(不传):全部 true:辅料单 false: 主订单
  "showMaterial": false, // 是否显示辅料订单
  "materialTag": "标签名", // 订单标签名
  "isDesign": null, // 是否设计单 true:设计单 false:不是设计单
  "dataType": "order", // 数据类型 order:按订单  machine:按编菲床次
  "remark": null, // 订单备注模糊搜索 dataType:machine按子床次
  "purchaseNo": null, // 合同号搜索
}

{
  "data": [{
    "id": "6dwNz",
    "machine": "262",
    "oId": "D200321",
    "orderTime": 1552304212000,
    "delivery": 1553961600000,
    "buildTime": 1552304224000,
    "quantities": {
      "白色": {
        "XS": 10,
        "S": 10,
        "M": 10
      }
    },
    "isOutsource": 0,
    "totalQuantity": 90,
    "remark": "555555555",
    "merchandiser": "蒋", // 跟单员
    "materialTag": "辅料单标签", // 辅料单标签
    "customerName": "达达手套公司",
    "customerNo": "1008",
    "cId": "C00995", // 款式编号
    "name": "测试款111",
    "imageUrl": "http://127.0.0.1/tp5/public/upload/images/2/636885202661679592_l.jpg",
    "cutters": [ // 裁床人员
      "蒋",
      "刘海波",
      "罗瑜文",
      "同"
    ],
    "machines": [
      "605",
      "605-1"
    ]
  }],
  "message": "",
  "code": 200,
  "pageItem": 105
}


// 同步款式工序到订单
// 请求路径: /index/category/syncSteps
{
  "id": 1234, // 款式主键id
  "orderIds": ["xxxx", "xxxxx"],
  "isForce": false, // 强制同步同名工序
  "isSyncInfo": false // 同步款式信息
}

{
  "data": "",
  "message": "",
  "code": 200
}


// 获取裁床汇总(多次编菲)
// 请求路径: /index/orders/getCutSummary
{
  "startDate": "2019-03-01", // 订单开始时间 开始时间和结束时间必须同时出现
  "endDate": "2019-03-12", // 订单结束时间
}

{
  "data": {
    "quantity": {
      "白色": {
        "M": 150,
        "S": 105
      },
      "灰色": {
        "M": 150,
        "S": 105
      }
    },
    "totalQuantity": 510,
    "styles": [{
      "styleNo": "C00139",
      "quantity": {
        "白色": {
          "M": 20,
          "S": 20
        },
        "灰色": {
          "M": 20,
          "S": 20
        }
      },
      "totalQuantity": 80
    }]
  },
  "message": "",
  "code": 200
}


// 订单汇总	 参数同getList
// 请求路径: /index/orders/getSummary
{
  "pageSize": 10,
  "pageIndex": 1,
  "keyWord": "", // 关键字搜索
  "startDate": "2019-03-01", // 订单开始时间 开始时间和结束时间必须同时出现
  "endDate": "2019-03-12", // 订单结束时间
  "startOut": "2019-03-01", // 交货开始时间 开始时间和结束时间必须同时出现
  "endOut": "2019-03-12", // 交货结束时间
  "isOutsource": "", // 是否筛选外发 1:外发 2:外接
  "isBuild": true, // 是否编菲 !!!不需要过滤则不传该字段
  "cId": 1234, // 获取款式的订单(款式主键id)(款式工序同步)
  "isLock": true, // 是否筛选订单锁 !!!不需要过滤则不传该字段
  "withCutter": true, // 是否显示裁床人员 订单总件数返回在message字段
  "showMachines": true, // 显示多床次
  "class": [], //	类目
  "brand": "", //品牌
  "customerIds": [], //客户id 数组
  "merchandisers": [], //	跟单员openid
  "machines": [617, 618], //床次
  "machine": "", //床次模糊搜索
  "groupBy": "build" // build:按裁货数量汇总 order:按下单数量汇总 product:按成品数量汇总
}

{
  "data": {
    "orderCount": 6,
    "categorys": [{
      "styleNo": "C00127",
      "name": "记数+登记",
      "imageUrl": "http://127.0.0.1/mhg_php/public/upload/images/2/5ed8a065820b3.jpg",
      "orderCount": 4,
      "totalQuantity": 110,
      "orderSummary": {
        "黑色": {
          "S": 40,
          "M": 30
        },
        "白色": {
          "S": 30,
          "M": 10
        }
      },
      "orders": [{
        "id": "BQRzO",
        "machine": "878",
        "oId": "D00544",
        "orderTime": 1591777233000,
        "delivery": 1593446400000,
        "buildTime": 1591777250000,
        "quota": null,
        "quantities": {
          "黑色": {
            "S": 10,
            "M": 10
          },
          "白色": {
            "S": 10,
            "M": 10
          }
        },
        "orderQuantity": 0,
        "totalQuantity": 40,
        "remark": "",
        "process": 1,
        "isLock": false,
        "isOutsource": 0,
        "multiMachine": false,
        "multiPrice": 1,
        "cutters": [],
        "merchandiser": null,
        "avatar": null,
        "customerName": null,
        "customerNo": null,
        "cId": "C00127",
        "name": "记数+登记",
        "size": [
          "S",
          "M"
        ],
        "color": [
          "黑色",
          "白色",
          "灰色"
        ],
        "imageUrl": "http://127.0.0.1/mhg_php/public/upload/images/2/5ed8a065820b3.jpg",
        "colorImages": {
          "黑色": "",
          "白色": "",
          "灰色": ""
        }
      }]
    }, ]
  },
  "message": "",
  "code": 200
}

// 获取员工列表
// 请求路径: /index/employee/getEmployee
{
  "keyword": "xxxxx",
  "isDuty": true,
  "pageIndex": 1,
  "pageSize": 10
}

{
  "data": [{
    "name": "ccc",
    "openid": "vQPXCmEvBZ876cN7CUvVOW9Y7XHfUhHJ",
    "mobile": "18178599140",
    "sex": 1,
    "imageUrl": null,
    "idCard": null,
    "bankCard": null,
    "aliPay": null,
    "avatarUrl": null,
    "serial": "07550002090",
    "isAdmin": 0,
    "joinTime": 1681462978000,
    "outTime": 0,
    "ltdId": 2,
    "roleId": 367,
    "staff": "ccc",
    "teams": [{
      "id": 666,
      "name": "客服"
    }]
  }, ],
  "message": "",
  "code": 200,
  "pageItem": 33
}


// 获取菲票带登记
// 请求路径: /index/work/getPieces

{
  "pno": "xxx", //菲票编号
  "pnos": ["xxx", "xxx"], //拿多张菲
  "orderId": "xxxxx", //订单id 获取订单全部菲票
  "machine": "xxxxx", //子床次过滤
  "sid": 1245, //工序id 筛选订单的工序 前提orderId必传
}


// 登记工序
// 请求路径: /index/work/checkIn
{
  "pnos": "xxx", //菲票编号或菲票数组
  "sids": 12345, //工序id或工序id数组
  "openid": 123564, //协助登记
  "completed": 10, //多人登记情况传
  "setUpTime": "2020-12-23" // 指定登记时间
}