API
提供大小包关系
更新时间: 2025-06-05 17:54:34 访问次数:59

接口说明

提供大小包关系

接口名称

lma.package.createBatch

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
packageList Array N 大包列表
– customerPackageBarcode String(32) N 客户自定义大包号
选择第三方barcode时,WINIT系统唯一
最大32位,支持英文、数字和部分特殊字符(-./:+)
BC202502141234
– packageBarcodeType String(32) Y baricode类型
WINIT_BARCODE:使用WINIT自动生成的大包barcode生成文件
THIRD_BARCODE:使用客户自定义的大包号(WINIT系统唯一)生成文件
WINIT_BARCODE
– barcodeList Array Y 小包列表
– – barcode String(32) Y 小包barcode

请求示例

  1. {
  2. "action": "lma.package.createBatch",
  3. "app_key": "rebecca",
  4. "data": {
  5. "packageList": [
  6. {
  7. "customerPackageBarcode": "customerPackageBarcode_e9865c6d4987",
  8. "packageBarcodeType": "WINIT_BARCODE",
  9. "barcodeList": [
  10. {
  11. "barcode": "barcode_a9e686747c10"
  12. }
  13. ]
  14. }
  15. ]
  16. },
  17. "format": "json",
  18. "language": "zh_CN",
  19. "platform": "leaddeal",
  20. "sign": "6666",
  21. "sign_method": "md5",
  22. "client_id": "YTZHY2UXYMUTN2VKNI00MZE2LWE1MDGTYMVHYJI5OTA0YZU2",
  23. "client_sign": "FA7B6B98110BE4B5932854E80CB5E1FF",
  24. "timestamp": "2023-04-19 17:03:48",
  25. "version": "1.0"
  26. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必传 说明 示例
packageList Array Y 大包列表
– customerPackageBarcode String(32) N 返回客户自定义大包号
– winitPackageBarcode String(32) N WINIT大包号
– packageLabel String() Y Base64编码的PDF文件
当大包barcode类型=WINIT_BARCODE,则文件中的条码是WINIT barcode。
当大包barcode类型=THIRD_BARCODE,则文件中的条码是入参的客户自定义大包号。

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "packageList": [
  6. {
  7. "customerPackageBarcode": "1xxxxx",
  8. "winitPackageBarcode": "1xxxx",
  9. "packageLabel": "1321321321"
  10. }
  11. ]
  12. }
  13. }
关键词