Lingxing
切换旧版

查询FBA货件箱子、卡板标签

POST/erp/sc/storage/shipment/printFbaLabels

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/storage/shipment/printFbaLabelsHTTPSPOST1

请求参数

dataarray<object>必填
请求数据
隐藏子属性
shipment_idstring必填
货件编号
page_typestring必填
页面类型：
PackageLabel_A4_2 - 每张A4纸打印2个标签
PackageLabel_A4_4 - 每张A4纸打印4个标签
PackageLabel_Plain_Paper - 每张美国信纸打印1个标签
PackageLabel_Letter_2 - 每张美国信纸打印2个标签
PackageLabel_Letter_6 - 每张美国信纸打印6个标签
PackageLabel_Thermal_NonPCP - 热敏纸(108 x 152 mm)1个标签
PackageLabel_Thermal_AK100 - 热敏纸(100 x 100mm)1个标签
PackageLabel_Thermal_AK100_Mark - 热敏纸(100 x 100mm)1个标签(带水印)
numinteger
页数【非合作承运人货件必填；合作承运人标签无法指定页数，不需要填】
page_start_indexinteger
箱子打印的起始页，默认为1
hide_ship_from_company_nameinteger
隐藏ship from公司名,默认不隐藏,非必填,传值1为开启
hide_ship_to_company_nameinteger
传值1为隐藏ship to公司名,默认不隐藏,非必填,传值1为开启
print_sta_name_pageinteger
传值1为新增任务名称页,默认不新增,非必填,仅打印box箱子标签时生效,传值1为开启
sort_labelinteger
传值1为按箱子顺序重排,默认不按箱子顺序重排,仅打印box箱子子标签时生效(说明:不按箱子顺序重排时,打印文件...
sort_by_packing_task_boxinteger
传值1为按装箱任务箱号重拍，需货件关联了装箱任务时才支持这个选项
print_made_in_chinainteger
传值1为打印MADE IN CHINA
print_product_numinteger
传值1为打印箱子商品数
print_center_idinteger
传值1为打印物流中心编码
print_fnskuinteger
传值1为打印FNSKU
print_product_nameinteger
传值1为打印产品品名
print_packing_task_box_nointeger
传值1为打印货件箱子关联的装箱任务编号
typestring必填
打印类型：box 箱子标签，card 卡板标签
is_return_urlinteger
传值1时，不返回base64字符串，直接返回有10分钟过期时间的url用于下载文件

请求cURL示例

curl --location 'https://openapi.lingxing.com/erp/sc/storage/shipment/printFbaLabels?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "data": [{
        "shipment_id": "FBA16Q9LDF2X",
        "page_type": "PackageLabel_Plain_Paper_CarrierBottom",
        "page_start_index": 1,
        "num": 2
    }],
    "hide_ship_from_company_name": 1,
    "hide_ship_to_company_name": 1,
    "print_sta_name_page": 1,
    "sort_label": 1,
    "sort_by_packing_task_box": 1,
    "print_made_in_china": 1,
    "print_product_num": 1,
    "print_center_id": 1,
    "print_fnsku": 1,
    "print_product_name": 1,
    "print_packing_task_box_no": 1,
    "type": "card",
    "is_return_url": 1
}'

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 17036564-84C9-554E-5225-BEFE9A3733EC
response_timestring必填
响应时间
示例 2022-07-04 18:40:49
totalinteger必填
总数
示例 0
dataobject必填
响应数据
隐藏子属性
file_base64string必填
未传或is_return_url不为1时，返回打印PDF文件的base64编码
示例 xxx
file_urlstring必填
is_return_url=1时返回PDF下载链接（10分钟有效）
示例 https://example.com/file.pdf

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "17036564-84C9-554E-5225-BEFE9A3733EC",
    "response_time": "2022-07-04 18:40:49",
    "total": 0,
    "data": {
        "file_url": "https://example.com/file.pdf"
    }
}