XCMG NS API


回传销售订单发货接口

简介
  • PMS接收NS传的销售订单后,对销售订单发货时调用此接口将销售发货回传到NS
请求URL
请求方式
  • POST
请求参数说明
Parameter Required Type Description field leval
interfaceCode True String 固定值"itemfulfillment_001" 0
sourceSystemCode True String 固定值"PMS" 0
sn True String 报文唯一性标识,用于重复性校验 0
requestDateTime True String 请求时间(YYYY-MM-DD HH24:MI:SS) 0
totalCount True String 此报文需要处理的单据量,即head汇总数量 0
head True Array 头节点
documentKey True String 来源系统主键,PMS出库记录的id 1
sourceSystemNumber True String 来源系统的单据编号,此处传输PMS出库事务处理的单号 1
createdFrom True String 发货对应的销售订单,传输之前NS传给PMS的销售订单号 1
memo False String 备注 1
subsidiary False String PMS发货单对应的子公司ID 1
date True String PMS发货单的出库日期,YYYY-MM-DD 1
line True Array 行节点
soLineId True String 发货对应的销售订单,传输之前NS传给PMS的销售订单号的行号 2
item True String PMS发货单的物料编码 2
location True String PMS发货出库的仓库 2
quantity True Number PMS发货出库的数量 2
示例
    {
    "interfaceCode":"itemfulfillment_001",
    "sourceSystemCode":"PMS",
    "sn":"Testlzx001",
    "requestDateTime":"2023-06-06 09:39:00",
    "totalCount":"1",
    "head":[
        {
            "documentKey":"Testlzx001",
            "sourceSystemNumber":"PMS",
            "createdFrom":"SO-00000022",
            "memo":"测试",
            "subsidiary":"徐工集团加拿大有限公司",
            "date":"2023/06/06",
            "line":[
                {
                    "soLineId":"1",
                    "item":"CV83PDU",
                    "location":"location_test",
                    "quantity":"1"
                },
                {
                    "soLineId":"2",
                    "item":"CV123PDU",
                    "location":"location_test",
                    "quantity":"1"
                }
            ]
        }
    ]
}
响应参数说明
Parameter Type Description
sn String 报文唯一性标识,用于重复性校验
sourceSystemCode String 固定值"PMS"
success Boolean 是否处理成功:true,false
message String 错误信息
totalCount Number 此报文需要处理的单据量,即head汇总数量
successCount Number 处理成功的单据量
datas Array 返回数据信息
documentKey Array 返回数据信息
nsTransactionNum String NS事务处理文档编号
nsTransactionId String 返回数据信息
success Boolean 是否处理成功:true,false
message String 错误信息
返回报文示例
//success
{
    "sn":"Testlzx001",
    "sourceSystemCode":"PMS",
    "success":true,
    "message":"",
    "totalCount":1,
    "successCount":1,
    "datas":[
        {
            "documentKey":"Testlzx001",
            "nsTransactionNum":"",
            "nsTransactionId":"",
            "success":true,
            "message":"success"
        }
    ]
}

// Error
{
    "sn":"Testlzx001",
    "sourceSystemCode":"PMS",
    "success":true,
    "message":"SN已存在,请勿重复推送;",
    "totalCount":1,
    "successCount":0,
    "datas":[

    ]
}
备注

页面列表

ITEM_HTML