保存付款申请单

付款申请单存盘接口

基本信息

信息	值	备注
接口名称	付款申请单保存	根据单据 ID 来新增单据（包括修改）
请求状态	POST	RESTful 方式
接口路径	`http://localhost:23798/api/Bill/SaveBill`	向服务器地址发送 POST 请求
远程模式	`http://www.linkerplus.com/api/ext_erp/Bill/SaveBill`	远程模式向服务器地址发送 POST 请求，需要 ERP 注册号注册远程模式，并在 Headers 添加 sn 参数
支持日期	`2026-08-24`	自该日期起支持

请求参数

Headers

参数名称	是否必须	参数值	备注
Content-Type	是	application/json	用于指定数据的传输类型
LoginId	是	e835943e-55c2-4bf0-832d-6f4166592941	用户登录的 LoginId，取用户登录或账套验证接口返回的 LoginId
sn	否	MGR_REST_1001	远程模式需添加 sn 参数，`MGR_REST_ERP注册号`

Body

参数名称	类型	是否必须	参数值	备注	其它信息
HeadData	object	必须		表头数据
EntryOrderId	string	否	WMS00001	调用方业务编码	调用方唯一编码，关联 ERP 单据，且避免重复提交，当提交的 EntryOrderId 重复时返回提示。为空则没有该项检测
CallId	string	是	PY	调用的单据识别号	"PY"：表示其他费用收入
CallNo	string	修改时必须	PY20268200001	调用的单据号码	传入该值代表修改原单据信息，新增数据时无需添加
CusNo	string	是	CS001	厂商代号
DepNo	string	否	0000	部门代号
SalNo	string	否	010	经办人代号
Rem	string	否	这是表头原因	备注
UsrNo	string	否	ADMIN	制单人	账套验证的 LoginId 需添加 UsrNo，用户登录的 LoginId 则无需添加 UsrNo
ExtendProps	object	否	"PR_DD":"2026-04-30", "ZDY": "表头自定义"	表头扩展功能	包括表头的其它字段以及用户自定义字段，字段名需与数据库表（MF_PR）中的栏位名称一致
NotUseAuditFlow	string	否	T/F	跳过审核流程，自动审核。默认不跳过	当传"T"时，该单据通过接口生成时，不考虑审核流程，直接自动终审
BodyData	array	必须		表身数据	item 类型: array
CallItm	number	修改时必须	1	原单项次	HeadData 中 CallNo 存在并有值时才生效，传入该值代表修改原单据表身对应 TM 列的信息，新增数据时无需添加
ArpNo	string	是	AP20267150001	立账单号
BilId	string	否	PC	立账来源单ID	只有按照单据明细模式生成付款申请单才需要填写；默认是按照立账单号生成的；默认非必填
BilNo	string	否	PC20268040001	立账来源单号	只有按照单据明细模式生成付款申请单才需要填写；默认是按照立账单号生成的；默认非必填
BilItm	number	否	1	立账来源项次	只有按照单据明细模式生成付款申请单才需要填写；默认是按照立账单号生成的；默认非必填
AmtnTem	number	否	100	申请金额
Rem	string	否		表身备注2
IsDelete	string	否	F	删除行	CallItm 存在并有值时才生效，传入该值为 T 代表删除原单据表身对应 PRE_ITM 列，不删除行时无需添加
ExtendProps	object	否	"OBJ_NO":"项目代号0001", "ZDY": "表身自定义"	表身扩展功能	包括表身的其它字段以及用户自定义字段，字段名需与数据库表（TF_PR）中的栏位名称一致

返回数据

参数名称	类型	参数值	备注
EntryOrderId	string	WMS00001	调用方业务编码
CallID	string	PY	调用的单据识别号
CallNO	string	PY20268200001	生成的单据号码
CallOK	string	T	执行是否成功, 是:"T" 否:"F"
Data	string	"TF_TABNAME": "TF_PR", "BIL_ITM": "0", "MF_TABNAME": "MF_PR", "BIL_NO": "PY20268200001", "BIL_ID": "PY"	单据信息，JSON 字符串格式
ErrorStr	string		错误信息

调用范例

Request

{
    "HeadData": {// 必须,表头数据
        "EntryOrderId": "WMS00001", // 非必须,调用方业务编码
        "CallId": "PY",// 必须,调用的单据识别号,"PY":表示付款申请单
        "CallNo": "PY20268200001", // 非必须，修改原单时必须，调用的单据号码，传入该值代表修改原单据信息，新增数据时无需添加
        "CusNo": "CS0001",// 必须，厂商代号
        "DepNo": "0000",// 非必须
        "SalNo": "010",// 非必须
        "Rem": "001"// 非必须
    },
    "BodyData": [// 必须,表身数据
        {
            "CallItm": 1, // 非必须，修改原单时必须，原单项次，传入该值代表修改原单据表身对应ITM列的信息，新增数据时无需添加
            "ArpNo": "AP20267150002",// 必须,立帐单号
            "Rem": "111",// 非必须
            "AmtnTem": 3.39// 非必须
        }
    ]
}

{
    "HeadData": {// 必须,表头数据
        "EntryOrderId": "WMS00001", // 非必须,调用方业务编码
        "CallId": "PY",// 必须,调用的单据识别号,"PY":表示付款申请单
        "CallNo": "PY20268200001", // 非必须，修改原单时必须，调用的单据号码，传入该值代表修改原单据信息，新增数据时无需添加
        "CusNo": "CS0001",// 必须，厂商代号
        "DepNo": "0000",// 非必须
        "SalNo": "010",// 非必须
        "Rem": "001"// 非必须
    },
    "BodyData": [// 必须,表身数据
        {
            "CallItm": 1, // 非必须，修改原单时必须，原单项次，传入该值代表修改原单据表身对应ITM列的信息，新增数据时无需添加
            "ArpNo": "AP20268040001",// 必须,立帐单号
            "BilId": "PC",// 必须,立账来源单ID
            "BilNo": "PC20268040001",// 必须,立帐来源单号
            "BilItm": "1",// 必须,立账来源项次
            "Rem": "222",// 非必须
            "AmtnTem": 10// 非必须
        }
    ]
}

Response

{
    "EntryOrderId": "WMS00001", // 调用方业务编码
    "CallID": "PY", // 调用的单据识别号
    "CallNO": "PY20268200001", // 生成的单据号码
    "CallOK": "T", // 执行是否成功，是:"T" 否:"F"
    "Data": "{\r\n  \"TF_TABNAME\": \"TF_PR\",\r\n  \"BIL_ITM\": \"0\",\r\n  \"MF_TABNAME\": \"MF_PR\",\r\n  \"BIL_NO\": \"PY20268200001\",\r\n  \"BIL_ID\": \"PY\"\r\n}", // 单据信息， JSON字符串格式
    "ErrorStr": "" // 错误信息
}

备注

必须在 Headers 里面传入用户登录或账套验证的LoginId。
当采用的是账套验证获取的LoginId，那么 HeadData 中UsrNo就是制单人，不能为空。采用用户登录的LoginId则无需添加UsrNo，用户即制单人。
Body 中 JSON 字段，尽量不要添加赋空值的字段。
ExtendProps中为拓展字段，需要对应数据库表的字段，自定义字段同样在这里处理。
统一字段与接口所需数据库表字段重复时，只取统一字段的值。
接口程序不处理审核，没有审核流直接终审，有审核流就处于未审状态。
可查看后台表LOG_BILLSAVE查看执行信息。
当 HeadData 中 EntryOrderId 不为空时，可查看后台表LOG_OTHERSAVE查看单据关联信息。

EntryOrderId

EntryOrderId：为同一次调用动作的唯一 ID，全局唯一，建议采用随机 uuid/guid；例如调用方请求第一次时，无响应信息或者响应错误后再请求一次时，该 EntryOrderId 应相同，为同一次调用动作。相反，调用方第一次调用返回成功信息后，删除了单据（无论删除 ERP 单据还是调用方单据），再重新调用一次，此时 EntryOrderId 是不能与没删除前的 EntryOrderId 相同。简而言之，只要调用接口返回成功信息后的 EntryOrderId 就不能再重复调用。

付款申请单存盘接口​

基本信息​

请求参数​

Headers​

Body​

返回数据​

调用范例​

Request​

Response​

备注​