API开放平台

TIP

# 开票申请接口

# 查询开票申请数据

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/billing/v1/queryBillingData/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "page": 1,
    "rows":"1000",
	"status":"1",
	"serialNo":"INV20221208000002",
	"billingKind":"1",
	"approveStatus":"1",
	"startCreateDate":"2022-12-01 10:00:00",
	"endCreateDate":"2022-12-02 10:00:00",
	"startModifyDate":"2022-12-01 10:00:00",
	"endModifyDate":"2022-12-02 10:00:00"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 否 页码默认1
rows INT 否 每页默认1000条
status CHAR(1) 否 记录状态：0 已删除 1 正常
serialNo VARCHAR(32) 否 开票申请编号
billingKind CHAR(1) 否 发票种类：1：正常、2：红冲、3：作废
approveStatus VARCHAR(32) 否 审批状态：0：待审批，1：已通过，2：已打回，3：审批中
startCreateDate VARCHAR(32) 否 开始创建时间。格式：YYYY-MM-DD hh:mm:ss
endCreateDate VARCHAR(32) 否 结束创建时间。格式：YYYY-MM-DD hh:mm:ss
startModifyDate VARCHAR(32) 否 修改时间开始。格式：yyyy-MM-dd HH:mm:ss
endModifyDate VARCHAR(32) 否 修改时间结束。格式：yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
	{
		"accountBankName":null,
		"applicantName":"zhoukun",
		"approveStatus":"1",
		"bankAccount":null,
		"billingAmount":6,
		"billingDate":"2022-12-08",
		"billingKind":"1",
		"billingName":null,
		"billingStatus":"1",
		"billingType":null,
		"companyAddress":null,
		"companyTel":null,
        "email": "",
		"createTime":"2022-12-08 17:18:22",
		"creatorName":"zhoukun",
		"customerCode":"STORE20210812000182",
		"customerName":"000201-近江超市",
		"modifyName":null,
		"modifyTime":null,
		"orders":[
			{
				"creditMemoAmount":null,
				"orderAmount":115790000.65,
				"orderBillingAmount":3,
				"orderNo":"DD20220926000005",
				"oriBillingAmount":null
			},
			{
				"creditMemoAmount":null,
				"orderAmount":119000000.65,
				"orderBillingAmount":2,
				"orderNo":"DD20220926000004",
				"oriBillingAmount":null
			},
			{
				"creditMemoAmount":null,
				"orderAmount":1161000000.65,
				"orderBillingAmount":1,
				"orderNo":"DD20220926000003",
				"oriBillingAmount":null
			}
		],
		"oriBillingNo":null,
		"oriSerialNo":null,
		"receiverAddress":null,
		"receiverName":null,
		"receiverPhone":null,
		"receiverProvince":"",
		"receiverTel":null,
		"remarks":null,
		"serialNo":"INV20221208000002",
		"status":"1",
		"taxpayerNo":null
	}
]

参数说明：

参数 类型 必填 说明
serialNo VARCHAR(32) 是 开票申请编号
status VARCHAR(1) 是 记录状态 0：已删除，1：正常
customerName VARCHAR(200) 是 客户名称
customerCode VARCHAR(100) 是 客户编码
billingAmount NUMERIC(12,2) 是 发票金额
applicantName VARCHAR(200) 是 申请人
applicantId VARCHAR(200) 是 申请人id
applicantSourceCode VARCHAR(200) 是 申请人第三方系统id
applicantCode VARCHAR(200) 是 申请人登录帐号
billingType VARCHAR(1) 是 发票类型
approveStatus VARCHAR(1) 是 审批状态 0：待审批，1：已通过，2：已打回，3：审批中
billingStatus VARCHAR(1) 是 开票进度 0：待处理，1：待开票，2：已开票，3：待红冲，4：已红冲
billingDate VARCHAR(32) 是 开票日期
billingKind VARCHAR(1) 是 发票种类 1：正常 2：红冲 3：作废
remarks TEXT 否 备注
ori_serial_no VARCHAR(32) 否 关联原始发票 发票种类是红冲时有值
billingNo VARCHAR(32) 否 发票号码
creatorName VARCHAR(200) 是 提交人
creatorId VARCHAR(200) 是 提交人id
creatorSourceCode VARCHAR(200) 是 提交人第三方系统id
creatorCode VARCHAR(200) 是 提交人登录帐号
createTime VARCHAR(32) 是 提交时间
modifyName VARCHAR(200) 是 最近修改人
modifyId VARCHAR(200) 是 最近修改人id
modifySourceCode VARCHAR(200) 是 最近修改人第三方系统id
modifyCode VARCHAR(200) 是 最近修改人登录帐号
modifyTime VARCHAR(32) 是 最近修改时间
billingName VARCHAR(200) 否 开票名称
taxpayerNo VARCHAR(100) 否 纳税人识别号
companyAddress VARCHAR(200) 否 单位地址
email VARCHAR(100) 否 郵箱地址
companyTel VARCHAR(32) 否 电话号码
accountBankName VARCHAR(200) 否 开户银行名称
bankAccount VARCHAR(32) 否 银行账户号码
receiverName VARCHAR(200) 否 收货人
receiverTel VARCHAR(32) 否 固定电话
receiverPhone VARCHAR(32) 否 手机号码
receiverProvince VARCHAR(100) 否 省市区
receiverAddress VARCHAR(200) 否 详细地址
orders[].orderNo VARCHAR(32) 否 订单号
orders[].orderAmount NUMERIC(12,2) 否 订单金额 发票种类为正常或作废时有值
orders[].orderBillingAmount NUMERIC(12,2) 否 本次开票金额 发票种类为正常或作废时有值
orders[].oriBillingAmount NUMERIC(12,2) 否 关联发票开票金额 发票种类是红冲时有值
orders[].creditMemoAmount NUMERIC(12,2) 否 本次红冲金额 发票种类是红冲时有值

# 编辑开票申请数据

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/billing/v1/editBillingData/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "serialNo": "20230830001",
    "billingDate":"2023-08-30",
	"billingStatus":"1",
	"billingNo":"1",
	"remarks":"",
	"attachmentUrl":"https://image-test.waiqin365.com/5433137911322455965/std_task_assgin_v2/202307/20230711195807969_4753500308778943250_0.jpg"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
serialNo INT 否 开票申请编号
billingDate INT 否 开票日期
billingStatus CHAR(1) 否 开票进度 0：待处理，1：待开票，2：已开票，3：待红冲，4：已红冲
billingNo VARCHAR(32) 否 发票号码
remarks TEXT 否 备注
attachmentUrl VARCHAR(4000) 否 附件

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

← 开票申请数据推送 →