# 采购发票 API

# 审核采购发票

接口地址:/api/open/v2/invoice/purchase/audit

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "code": "",
    "message": "",
    "result": ""
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
auditParam	auditParam	body	true	RequestParameter«InvoiceAuditParam»	RequestParameter«InvoiceAuditParam»
body			false	InvoiceAuditParam	InvoiceAuditParam
code	销售订单编码		true	string
message	审核人意见		false	string
result	审核人结论,可用值:PASS,REFUSAL		true	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 创建采购发票

接口地址:/api/open/v2/invoice/purchase/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "address": "",
    "bank": "",
    "bankAccount": "",
    "code": "",
    "comment": "",
    "enterpriseCode": "",
    "expectedDate": "",
    "invoiceCategoryCode": "",
    "invoiceDate": "",
    "invoiceNumber": "",
    "invoiceTitle": "",
    "invoiceType": "",
    "orderType": "",
    "records": [
      {
        "itemCode": "",
        "price": 0,
        "quantity": 0,
        "relativeOrderCode": "",
        "taxRate": 0
      }
    ],
    "taxCode": "",
    "telephone": ""
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
customerSaveParamRequestParameter	customerSaveParamRequestParameter	body	true	RequestParameter«InvoiceSaveParam»	RequestParameter«InvoiceSaveParam»
body			false	InvoiceSaveParam	InvoiceSaveParam
address	开票地址		false	string
bank	开户银行		false	string
bankAccount	银行账户		false	string
code			false	string
comment	备注信息		false	string
enterpriseCode	企业编码		true	string
expectedDate	预计开票日期		true	string
invoiceCategoryCode	发票类别代码		false	string
invoiceDate			false	string
invoiceNumber	发票号		false	string
invoiceTitle	发票抬头		true	string
invoiceType	发票类型,可用值:VALUE_ADDED_TAX,COMMERCIAL,FORMAL		true	string
orderType	单据类型,可用值:SALE_ORDER,SALE_OUT,SALE_RETURN,PURCHASE_ORDER,PURCHASE_RECEIPT,PURCHASE_RETURN		true	string
records	发票明细		false	array	Record
itemCode	物料编号		true	string
price	含税单价		true	number
quantity	数量		true	number
relativeOrderCode	关联单据编号		true	string
taxRate	税率		true	number
taxCode	纳税人识别号		false	string
telephone	开票电话		false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 删除采购发票

接口地址:/api/open/v2/invoice/purchase/delete

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

参数是编码

请求示例:

{
  "body": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
requestParameter	requestParameter	body	false	RequestParameter«string»	RequestParameter«string»
body			false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 作废采购发票

接口地址:/api/open/v2/invoice/purchase/prohibit

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
code	code	body	false	RequestParameter«string»	RequestParameter«string»
body			false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 查询采购发票列表

接口地址:/api/open/v2/invoice/purchase/query

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "codeLike": "",
    "codes": [],
    "pagingParam": {
      "length": 0,
      "start": 0
    }
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
queryParamRequestParameter	queryParamRequestParameter	body	true	RequestParameter«InvoiceQueryParam»	RequestParameter«InvoiceQueryParam»
body			false	InvoiceQueryParam	InvoiceQueryParam
codeLike	按发票编码模糊匹配		false	string
codes	按发票编码完全匹配		false	array	string
pagingParam			false	PagingParam	PagingParam
length			false	integer
start			false	integer

响应状态:

状态码	说明	schema
200	OK	ListPagingResponse«InvoiceDTO»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		ListPagingResponseData«InvoiceDTO»	ListPagingResponseData«InvoiceDTO»
length		integer(int32)
list		array	InvoiceDTO
applicantCode	申请人工号	string
applicantName	申请人名称	string
code	单据编码	string
comments	单据备注	string
createTime	创建时间	integer
createType	开票单据类型,可用值:SALE_ORDER,SALE_OUT,SALE_RETURN,PURCHASE_ORDER,PURCHASE_RECEIPT,PURCHASE_RETURN	string
currency	币种	string
customerCode	企业编码	string
customerName	企业名称	string
invoiceCode	发票号	string
invoiceTitle	发票抬头	string
invoiceType	发票类型,可用值:VALUE_ADDED_TAX,COMMERCIAL,FORMAL	string
invoiceTypeCode	发票类别代码	string
items		array	Detail
comments	行备注	string
itemAttributes	物料规格	object
itemCode	物料编码	string
itemName	物料名称	string
price	价格	number
quantity	数量	number
relatedOrderCode	关联业务单号	string
tax	税额	number
staffCode	开票人工号	string
staffName	开票人名称	string
status	审核状态,可用值:PASS,REFUSAL	string
taxCode	纳税人识别号	string
recordsTotal		integer(int32)
start		integer(int32)
message		string

响应示例:

{
	"code": 0,
	"data": {
		"length": 0,
		"list": [
			{
				"applicantCode": "EM-13",
				"applicantName": "黎明",
				"code": "INC-20211011-001",
				"comments": "票不要乱开",
				"createTime": 1636271847899,
				"createType": "SALE_ORDER",
				"currency": "RMB",
				"customerCode": "SH-1001",
				"customerName": "上海新核云信息科技有限公司",
				"invoiceCode": "XT-123",
				"invoiceTitle": "上海新核云信息科技有限公司",
				"invoiceType": "VALUE_ADDED_TAX",
				"invoiceTypeCode": "XT-123",
				"items": [
					{
						"comments": "最后一卷为残卷",
						"itemAttributes": "颜色：蓝色；材质：304",
						"itemCode": "P-10101",
						"itemName": "钢卷料",
						"price": 20,
						"quantity": 20,
						"relatedOrderCode": "S-20211001-001",
						"tax": 20
					}
				],
				"staffCode": "XT-32",
				"staffName": "王伟",
				"status": "",
				"taxCode": "S-101001"
			}
		],
		"recordsTotal": 0,
		"start": 0
	},
	"message": ""
}

# 修改采购发票

接口地址:/api/open/v2/invoice/purchase/update

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "address": "",
    "bank": "",
    "bankAccount": "",
    "code": "",
    "comment": "",
    "enterpriseCode": "",
    "expectedDate": "",
    "invoiceCategoryCode": "",
    "invoiceDate": "",
    "invoiceNumber": "",
    "invoiceTitle": "",
    "invoiceType": "",
    "orderType": "",
    "records": [
      {
        "itemCode": "",
        "price": 0,
        "quantity": 0,
        "relativeOrderCode": "",
        "taxRate": 0
      }
    ],
    "taxCode": "",
    "telephone": ""
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
customerSaveParamRequestParameter	customerSaveParamRequestParameter	body	true	RequestParameter«InvoiceSaveParam»	RequestParameter«InvoiceSaveParam»
body			false	InvoiceSaveParam	InvoiceSaveParam
address	开票地址		false	string
bank	开户银行		false	string
bankAccount	银行账户		false	string
code			false	string
comment	备注信息		false	string
enterpriseCode	企业编码		true	string
expectedDate	预计开票日期		true	string
invoiceCategoryCode	发票类别代码		false	string
invoiceDate			false	string
invoiceNumber	发票号		false	string
invoiceTitle	发票抬头		true	string
invoiceType	发票类型,可用值:VALUE_ADDED_TAX,COMMERCIAL,FORMAL		true	string
orderType	单据类型,可用值:SALE_ORDER,SALE_OUT,SALE_RETURN,PURCHASE_ORDER,PURCHASE_RECEIPT,PURCHASE_RETURN		true	string
records	发票明细		false	array	Record
itemCode	物料编号		true	string
price	含税单价		true	number
quantity	数量		true	number
relativeOrderCode	关联单据编号		true	string
taxRate	税率		true	number
taxCode	纳税人识别号		false	string
telephone	开票电话		false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

← 销售发票 API 库存 API →