oms打单api
  1. 打单系统
oms打单api
  • 打单系统
    • 获取访问授权
      POST
    • 创建订单
      POST
    • 获取面单接口
      POST
    • 费用试算
      POST
    • 取消订单
      POST
    • 获取发货地址
      GET
    • Scan Form申请接口
      POST
  1. 打单系统

获取面单接口

POST
/api/svc/getLabel
该接口为获取订单的详细信息,如跟踪号、面单这些;如果您的系统没有保存成功面单的话,可以调用此接口进行获取需要的信息;一般对于正常流程中还未获取到面单的订单都是以code 为202做为提示,但是需要注意logistics_err字段是否有错误提示,一旦有错误提示则表示该订单申请面单失败;此接口可以重复执行请求,直到获取到您需要的信息为止,但是请控制请求频率在1Qps(1 Query Per Second),请勿短时间内爆发式请求。

请求参数

Header 参数

Body 参数application/json

示例
{
  "order_code": "J9808202109252597028"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/svc/getLabel' \
--header 'Content-Type: application/json' \
--data-raw '{
  "order_code": "J9808202109252597028"
}'

返回响应

🟢200成功
application/json
Body

示例
{
	"code": 200,
	"result": {
		"reference_no": "Test7886666",
		"order_code": "J00000000000000008",
		"order_address_type": "Commercial",
		"order_status": 2,
		"order_sub_status": 0,
		"order_waiting_status": 0,
		"sync_service_status": 1,
		"logistics_err": "",
		"labels": [{
			"tracking_number": "776819903227",
			"label_url": "http://jinqu-oms-13047873800.cos.ap-shanghai.myqcloud.com/LogisticsOmsService/labels/J000000000000000000008-77000000007-112-7827821-7886666.pdf",
			"file_type": "pdf"
		}],
		"fee": [{
			"ft_code": "shipping",
			"amount": "19.03",
			"currency_code": "USD",
			"ft_name": "运输费"
		}, {
			"ft_code": "ODASR",
			"amount": "3.19",
			"currency_code": "USD",
			"ft_name": "超偏远费"
		}, {
			"ft_code": "AHS-A",
			"amount": "5.03",
			"currency_code": "USD",
			"ft_name": "额外处理费-超重"
		}, {
			"ft_code": "FSC",
			"amount": "4.29",
			"currency_code": "USD",
			"ft_name": "燃油附加费"
		}],
		"fee_detail": [{
			"ft_code": "shipping",
			"amount": "19.03",
			"tracking_number": "",
			"box_code": "J00000000000000008-1",
			"currency_code": "USD",
			"ft_name": "运输费"
		}, {
			"ft_code": "ODASR",
			"amount": "3.19",
			"tracking_number": "",
			"box_code": "J00000000000000008-1",
			"currency_code": "USD",
			"ft_name": "超偏远费"
		}, {
			"ft_code": "AHS-A",
			"amount": "5.03",
			"tracking_number": "",
			"box_code": "J00000000000000008-1",
			"currency_code": "USD",
			"ft_name": "额外处理费-超重"
		}, {
			"ft_code": "FSC",
			"amount": "4.29",
			"tracking_number": "",
			"box_code": "J00000000000000008-1",
			"currency_code": "USD",
			"ft_name": "燃油附加费"
		}]
	},
	"msg": "Success"
}
修改于 2024-11-22 11:40:15
上一页
创建订单
下一页
费用试算
Built with