2.6.1单据新增/修改接口

POST

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

通过该接口，用户可以进行单据的新增或修改操作，已配单的单据不允许修改。
接口请求类型为：application/json

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

czlsh

string

操作流水号

必需

nsrsbh

string

纳税人识别号

必需

docList

array [object {20}]

单据列表

必需

docTypeDesc

string

单据类型描述

可选

docDate

string

单据日期

可选

nsrsbh

string

纳税人识别号

必需

docNum

string

单据编号

必需

传入相同的单据编号，可进行单据更新操作（状态为已匹配时，不允许修改）

docTitle

string

单据标题

可选

docTypeCode

string

单据类型代码

可选

（0：采购单，1：入库单，2：应付单，3：报销单，99：其他单据）

applier

string

申请人

可选

applyDept

string

申请部门

可选

contractNum

string

合同编号

可选

contractName

string

合同名称

可选

supplierTaxNo

string

供应商税号

必需

supplierName

string

供应商名称

可选

docAmount

integer

单据金额(不含税)

必需

amountTotal

integer

价税合计

必需

taxAmountTotal

integer

税额合计

必需

remark

string

备注

可选

docLineCount

integer

单据明细数量

可选

isAutoMatch

string

是否自动配单(是:Y、否:N)

必需

(是:Y、否:N)，默认为N，为Y时，必须定义的自动配单规则，在匹配处理完成后回调，否则不处理匹配

docFphm

string

发票号码

可选

detailList

array [object {10}]

明细列表

可选

示例

{
  "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",
          "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",
                    "preTaxAmount": "100.00",
                    "taxRate": "0.01",
                    "taxAmount": "1.00",
                    "amountTotal": "101.00"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回code

必需

0：成功，其他失败

msg

string

提示信息

必需

success

boolean

必需

示例

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

修改于 2025-04-17 09:16:33

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

公共参数说明