上传发票

请求 #

接口概述 #

依据账单开具发票给平台。开票总金额(价税合计)不能超过账单总金额(bill_amount)。 一张账单可以开具多张发票！(蓝票/红票)

注意

此接口上传的发票不是开具给采购人(客户)的，是供应商开具给平台的发票。 供应商只和平台做结算，处理发票。与客户之间没有结算/发票关系。

供应商开具的发票是平台的进项发票。开票的抬头都是固定的（中车智程）

发票种类(invoice_kind)说明: #

值 类型 说明
08 string 纸质增值税电子专用发票
10 string 纸质增值税电子普通发票
81 string 数电票增值税专用发票
82 string 数电票普通发票

发票类型(invoice_type)说明: #

值 类型 说明
1 int 蓝票
2 int 红票

请求URL # 

POST {{host}}/invoices/add

请求头(header) #

参数名 类型 是否必填 说明
Authorization string 是 token

请求参数(body) #

参数名 类型 必选 验证规则 说明
bill_no string 是 账单编号
electronic_no string 是 如果发票种类为数电发票(81,82)必填 电子发票号
invoice_no string 是 如果发票种类为纸质发票(08,10)必填 发票号码
invoice_code string 是 如果发票种类为纸质发票(08,10)必填 发票代码
invoiced_at string 是 datetime=2006-01-02 15:04:05 开票时间
invoice_kind string 是 oneof(08,10,81,82) 发票种类(81数电票增值税专用发票,82数电票普通发票,10纸质增值税电子普通发票,08纸质增值税电子专用发票
invoice_type int 是 oneof(1,2) 发票类型，1:蓝票，2:红票
amount_with_tax float 是 保留两位小数,如果为红票，值必须为负数 价税合计
tax_amount float 是 保留两位小数如果为红票，值必须为负数 税额
seller_tax_no string 是 max=50 销方税号
seller_name string 是 max=100 销方名称
seller_tel string 否 max=20 销方电话
invoice_xml string 否 url,max=500 发票xml
invoice_pdf_url string 是 url,max=500 发票pdf地址
blue_invoice_no string 否 如果为红票且蓝票为纸质票必填 红票对应的蓝票发票号
blue_invoice_code string 否 如果为红票且蓝票为纸质票必填 红票对应的蓝票发票代码
blue_electronic_no string 否 如果为红票且蓝票为数电票必填 红票对应的蓝票电子发票号码

请求参数示例 # 

{
  "bill_no": "2240517538290001",
  "electronic_no": "123456",
  "invoice_no": "123456",
  "invoice_code": "123456",
  "invoiced_at": "2006-01-02 15:04:05",
  "invoice_kind": "81",
  "invoice_type": 1,
  "amount_with_tax": 100.00,
  "tax_amount": 10.00,
  "seller_tax_no": "123456",
  "seller_name": "卖家名称",
  "seller_tel": "123456",
  "invoice_xml": "http://xml.com/xml.zip",
  "invoice_pdf_url": "http://pdf.com/123.pdf",
  "blue_invoice_no": "",
  "blue_invoice_code": "",
  "blue_electronic_no": ""
}

响应 #

响应参数 #

参数名 类型 参数路径 说明
code int 错误码
msg string 错误详情

响应示例 # 

{
  "code": 10000,
  "msg": "success"
}