2.上传发票销售单接口

测试环境(除税控、数电和扫码开票外的接口）

POST

/m5/bill/save/salesOrder

上传发票销售单接口

正确返回码	描述
0000	保存数据成功

错误返回码	描述
0520	开票方企业税号不能为空
00552	销售单编号不能为空
00553	销售单日期不能为空
00554	销售单发票类型不能为空
00555	分盘号不能为空
00556	销售单明细不能为空
00550	销售单开票金额不能为空
00551	销售单金额不能为空
00548	销售单编号超过规定长度40位
00549	销售单备注超过规定长度230位
00505	买方银行账号超过规定长度100位
00506	买方地址电话超过规定长度100位
00579	买方邮箱超长
00544	买方手机号码超长
0581	买方税号超长
00504	抬头超过规定长度100位
00565	销售单已存在，不能重复导入
00559	商品名称不能为空
00560	商品编码长度必须为19位
00561	优惠使用标识参数错误
00562	发票使用标记为1时，增值税特殊管理不能为空
00563	明细金额不能为空
00564	明细税率不能为空
00509	单位超过规定长度20位
00508	规格型号超过规定长度40位
00507	货物名称超过规定长度90位
00581	企业自编码超过规定长度
00580	订单总折扣金额大于0时，折扣方式不能为空
00583	明细税率为零时，必须有零税率标识
00569	明细金额之和不等于总金额
00568	总金额减去折扣额不等于开票金额
00567	折扣金额大于可折扣比例金额
0001	保存数据失败

请求参数

Path 参数

access_token

string

必需

Query 参数

access_token

string

必需

reqid

string

当前时间戳，13位

必需

Body 参数application/json

saleNo

string

订单编号

必需

saleDate

string

必需

订单日期，格式2015-11-12 17:43:51

invoiceType

string

必需

1:普通电子发票2：电子专用发票

totalAmount

number

必需

订单总金额，含税，单位：元（2位小数）。订单总金额=开票金额+整单折扣金额。

totalDiscount

number

必需

整单折扣金额，含税，单位：元（2位小数），指本订单总的折扣金额，订单使用的优惠券、会员卡赠金等不开票的金额可以通过该字段传输，不传则默认没有该类不开票的优惠金额。

invoiceAmount

number

必需

开票金额，含税，单位：元（2位小数）

discountedPortion

number

必需

折扣比例，整单折扣金额不能超过订单总金额的比例，可传0至100的正整数，传值后将校验。例如折扣比例为20，订单总金额为100，则整单折扣的金额不能超过20，比例超过20时，不允许导入

discountType

string

必需

折扣方式，整单折扣金额的折扣方式。 1-按行折扣（将整单折扣金额分摊至最大的正数商品行，如正数行金额已被抵扣完，按金额顺序往金额第二的正数行分摊折扣。） 2-按比例分摊折扣。（将整单折扣金额按比例分摊至各正数明细行，最后一行做减法。当某行本身带折扣行时，折扣金额在原有基础上累加，折扣总金额不可超过被折扣行金额。

termValidity

number

必需

开票有效期，单位有每天，不超过365天

remark

string

备注

可选

buyerName

string

可选

购买方名称，非必填信息，不为空可以在扫码的页面显示

buyerTaxNo

string

可选

购买方税号，非必填信息，不为空可以在扫码的页面显示

buyerTelephoneAddress

string

可选

购买方地址电话，非必填信息，不为空可以在扫码的页面显示

buyerAccount

string

可选

购买方银行账号，非必填信息，不为空可以在扫码的页面显示

buyerEmail

string

可选

购买方邮箱，非必填信息，不为空可以在扫码的页面显示

buyerMobilePhone

string

可选

购买方手机，非必填信息，不为空可以在扫码的页面显示

taxDiscNum

string

必需

分盘号，和发票云配置对应区分每个扫码用户

taxFlag

string

必需

含税标志1是含税，0是不含税

items

array [object {13}]

必需

ownNumber

string

商品自编码

可选

name

string

商品明细名称

可选

spec

string

规格型号

可选

num

number

数量，小数点后8位

可选

unitPrice

number

可选

单价，小数点后8位，检验：数量*单价=明细总金额。误差正负0.01。商品数量、商品单据两个字段需同时不为空或者为空

unit

string

单位

可选

taxRate

number

税率，小数点后两位

可选

taxNumber

string

税收分类编码

可选

zeroTaxFlag

number

可选

零税率标识，空（非零税率）,1（免税）,2（不征税）,3（普通零税率）

prePolicy

number

可选

优惠政策标识，0(不使用)，1（使用）

vatException

string

可选

增值税特殊管理，当prePolicy为1是必填

detailTotalAmount

number

可选

明细总金额，小数点后两位

detailTotalDiscount

number

可选

明细扣除金额，小数点后两位

示例

{
  "saleNo": "string",
  "saleDate": "string",
  "invoiceType": "string",
  "totalAmount": 0,
  "totalDiscount": 0,
  "invoiceAmount": 0,
  "discountedPortion": 0,
  "discountType": "string",
  "termValidity": 0,
  "remark": "string",
  "buyerName": "string",
  "buyerTaxNo": "string",
  "buyerTelephoneAddress": "string",
  "buyerAccount": "string",
  "buyerEmail": "string",
  "buyerMobilePhone": "string",
  "taxDiscNum": "string",
  "taxFlag": "string",
  "items": [
    {
      "ownNumber": "string",
      "name": "string",
      "spec": "string",
      "num": 0,
      "unitPrice": 0,
      "unit": "string",
      "taxRate": 0,
      "taxNumber": "string",
      "zeroTaxFlag": 0,
      "prePolicy": 0,
      "vatException": "string",
      "detailTotalAmount": 0,
      "detailTotalDiscount": 0
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/m5/bill/save/salesOrder?access_token=&reqid=' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
  "errcode": "0000",
  "description": "保存数据成功",
  "data": "http://scan.piaozone.com/demo/tyqr?k=000490,12345rwyt4y4jkhlhjk,200,1656382079428,432259adea170f7da2c6cf25432139c4,$"
}

🟢200失败

修改于 2024-02-27 01:36:51

1.token获取

3.回推接口地址