2.6.1单据新增/修改接口

POST

https://api.baiwangjs.com/swgx-saas/swgx-api/interface/jxgl/saveOrUpdateDoc

通过该接口，用户可以进行单据的新增或修改操作，已配单的单据不允许修改，如需修改必须先撤销配单，再进行修改。isAutoMatch 为是否自动配单，默认为N，当Y的时候，必须在平台《初始设置》-《用票初始化》-《自动配单规则》-《添加（新版）》进行了规则配置并且指派了企业，则该字段才生效，否则不生效。自动配单为异步处理，根据自动配单规则中的回填地址进行异步回填，配单满足条件才进行回填，否则在平台《集中用票》-《智能配单》中进行处理，保存完成后则自动回填业务系统。回填按企业分组分批回填，报文如2.6.2所示。
接口请求类型为：application/json

请求参数

Header 参数

Body 参数application/json

示例

{
    "czlsh": "11123123123",
    "nsrsbh": "12313",
    "docList": [
        {
            "docTypeDesc": "入库单",
            "docDate": "2025-04-11",
            "nsrsbh": "91310230MA1K2F7A5C",
            "docNum": "250411",
            "docTitle": "测试单据1",
            "docTypeCode": "1",
            "applier": "测试人员",
            "applyDept": "测试部门",
            "contractNum": "11231231123",
            "contractName": "测试合同",
            "supplierTaxNo": "923123123123123",
            "supplierName": "测试供应商",
            "docAmount": 100,
            "amountTotal": 101,
            "taxAmountTotal": 1,
            "remark": "测试备注",
            "docLineCount": 1,
            "id": "",
            "detailList": [
                {
                    "lineNum": 0,
                    "goodsName": "苹果",
                    "specification": "",
                    "unit": "",
                    "quantity": "1",
                    "price": "100",
                    "prePrice": "",
                    "preTaxAmount": "100.00",
                    "taxRate": "0.01",
                    "taxAmount": "1.00",
                    "amountTotal": "101.00"
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.baiwangjs.com/swgx-saas/swgx-api/interface/jxgl/saveOrUpdateDoc' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "czlsh": "11123123123",
    "nsrsbh": "12313",
    "docList": [
        {
            "docTypeDesc": "入库单",
            "docDate": "2025-04-11",
            "nsrsbh": "91310230MA1K2F7A5C",
            "docNum": "250411",
            "docTitle": "测试单据1",
            "docTypeCode": "1",
            "applier": "测试人员",
            "applyDept": "测试部门",
            "contractNum": "11231231123",
            "contractName": "测试合同",
            "supplierTaxNo": "923123123123123",
            "supplierName": "测试供应商",
            "docAmount": 100,
            "amountTotal": 101,
            "taxAmountTotal": 1,
            "remark": "测试备注",
            "docLineCount": 1,
            "id": "",
            "detailList": [
                {
                    "lineNum": 0,
                    "goodsName": "苹果",
                    "specification": "",
                    "unit": "",
                    "quantity": "1",
                    "price": "100",
                    "prePrice": "",
                    "preTaxAmount": "100.00",
                    "taxRate": "0.01",
                    "taxAmount": "1.00",
                    "amountTotal": "101.00"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "操作成功",
    "success": true
}

修改于 2025-08-01 09:47:14

2.5.6单据凭证绑定、解绑接口（凭证：单据=1：N）

2.6.2自动配单结果回填