异步开票-v4

注意

本接口只支持v4版本的调用，详情请参考：开发指南的版本说明一节

开发中请勿对接

环境地址要选择v4版本的：

加密说明

需要对请求body中的data对象进行加密，加密方法请参考：对接约定中的加密方式一节。底下是一个加密后报文的样例：

异步开票接口配合异步开票结果查询接口进行使用
异步开票返回serialNo，异步开票结果查询接口根据serialNo进行结果查询，需要定时获取结果，直到拿到结果

请求参数

Query 参数

access_token

string

授权token

必需

reqid

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

示例值:

1624601109096123

taxNo

string

授权对应的企业税号

必需

name

string

可选

长链接唯一id,同一组织下有多个设备必填，长链接唯一name由客户端自动生成，如果传可以指定客户端连接，主要用来调试，不传则动态由后台控制客户端路由

fpdk_type

string

星瀚传4，其它传3

必需

示例值:

callbackUrl

string

回调地址

可选

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

data

object

aes加密字符串

必需

account

string

必需

电子税局账号，选填，目前只支持一个电子税局账号，默认客户端电子税局配置的就行

fpdkType

number

必需

星瀚调用使用4，其他系统调用使用3

request_path

string

必需

/fpdk/etax/bill/invoice/create

serialNo

string

必需

税局开票需要关联的流水号,，长度不超过20位

invoiceAmount

number

金额合计(不含税)

必需

type

number

必需

开票类型 0蓝票，1红票

taxFlag

enum<number>

必需

含税标记【目前只支持不含税: 0】

枚举值:

drawer

string

开票人

必需

payee

string

可选

收款人有值时在备注中显示

reviewer

string

可选

复核人有值时在备注中显示

paperInvoiceType

number

可选

1是数电发票，2数电纸质发票，默认值为1，为1时，invoiceType只能为26，27，为2时，invoiceType只能为3和4

invoiceCopyType

string

可选

数电纸质发票类型，目前只有普票可以控制联次：2、2016版增值税普通发票（二联折叠票），5、2016版增值税普通发票（五联折叠票），普票如果不传默认开二联折叠票

invoiceType

string

必需

26数电普票，27数电专票，3数电纸质普通发票，4数电纸质专用发票

totalAmount

number

价税合计(小写)

必需

totalTaxAmount

number

总税额

必需

salerTaxNo

string

销方税号

必需

salerName

string

销方名称

必需

salerAddress

string

销方地址

必需

salerPhone

string

销方电话

必需

salerCardName

string

销方开户银行名称

必需

salerCardNumber

string

销方开户银行账号

必需

showSalerCard

enum<string>

可选

备注是否展示销售方银行名称账号

枚举值:

showSalerAddressTel

enum<string>

可选

是否展示销方地址电话到备注里面

枚举值:

buyerTaxNo

string

购方纳税人识别号

必需

buyerName

string

购方名称

必需

buyerAddress

string

购方地址

可选

buyerFixedTelephone

string

购方电话

可选

buyerCardName

string

购方开户银行名称

可选

buyerCardNumber

string

购方开户银行账号

可选

showBuyerCard

enum<string>

可选

备注是否展示购买方银行名称账号

枚举值:

showBuyerAddressTel

enum<string>

可选

是否展示购方地址电话到备注里面

枚举值:

buyerMobilePhone

string

购买方手机

可选

buyerEmail

string

购买方邮箱

可选

agentUser

string

经办人姓名

可选

agentCardType

string

经办人证件类型

可选

agentCardNo

string

经办人证件号码

可选

agentCountry

string

经办人国籍(地区)

可选

agentTaxNo

string

可选

经办人自然人纳税人识别号

originalInvoiceCode

string

可选

(原)蓝票发票代码(开红票时候需要)

originalInvoiceDate

string

可选

(原)蓝票发票开票日期(开红票时候需要)

originalEtaxInvoiceNo

string

可选

(原)蓝票数电号码(开红票时候需要)

originalInvoiceNo

string

可选

(原)蓝票发票号码(开红票时候需要)

govRedConfirmBillUuid

string

可选

红字确认单税局uuid

redReason

string

可选

红冲原因, 申请时已经确定，红冲原因 01，开票有误，03,服务终止，04 销售折让

redConfirmBillNo

string

可选

红字发票信息确认单编号

redConfirmEnterDate

string

可选

红字确认单录入日期，精确到秒

inventoryProjectName

string

可选

清单发票项目名称，需要打印清单时对应发票票面项目名称，清单标志 inventoryFlag为1时必填，为0不必处理

remark

string

备注

可选

inventoryFlag

string

可选

清单标志， 0-普通电子发票1-普通电子发票(清单) 2-收购电子发票 3-收购电子发票(清单) 4-成品油电子发票(成品油无清单)

naturalPersonFlag

string

可选

自然人标识，Y-是，N-否；默认N

businessType

string

可选

特定业务类型01：成品油发票02：稀土发票03：建筑发票04：货物运输服务发票05：不服务动产销售服务发票06：不动产租赁服务发票07：代收车船税08：通行费09：旅客运输服务发票10：医疗服务（住院）发票11：医疗服务（门诊）发票12：自产农产品销售发票13 拖拉机和联合收割机发票14：机动车15：二手车16：农产品收购发票17：光伏收购发票18：卷烟发票

buildInfo

object

可选

建筑服务信息，特定业务类型为03时必填

freightList

array [object {5}]

可选

货物运输服务，特定业务类型为04时必填

estateSaleInfo

object

可选

不动产销售服务信息，特定业务类型为05时必填

estateLeaseInfo

object

可选

不动产经营租赁服务信息，特定业务类型为06时必填

cardType

string

可选

证件类型，特定业务类型为16时必填

differenceTaxType

string

差额征税类型

可选

totalDeduction

number

可选

合计扣除额差额征税时必填在差额征税类型‘differenceTaxType’为01时应为0

deductionList

array [object {9}]

可选

差额扣除额清单在差额征税类型‘differenceTaxType’为02差额开票时必填在差额征税类型‘differenceTaxType’为01全额开票时非必填

items

array [object {16}]

必需

差额征税与特定业务类型为03建筑服务、05不动产销售服务、06不动产经营租赁、09旅客运输服务时明细行数量限制为1

extraList

array [object {3}]

附加要素

可选

示例

{
  "data": {
    "account": "string",
    "fpdkType": 0,
    "request_path": "string",
    "serialNo": "string",
    "invoiceAmount": 0,
    "type": 0,
    "taxFlag": 0,
    "drawer": "string",
    "payee": "string",
    "reviewer": "string",
    "paperInvoiceType": 0,
    "invoiceCopyType": "string",
    "invoiceType": "string",
    "totalAmount": 0,
    "totalTaxAmount": 0,
    "salerTaxNo": "string",
    "salerName": "string",
    "salerAddress": "string",
    "salerPhone": "string",
    "salerCardName": "string",
    "salerCardNumber": "string",
    "showSalerCard": "Y",
    "showSalerAddressTel": "Y",
    "buyerTaxNo": "string",
    "buyerName": "string",
    "buyerAddress": "string",
    "buyerFixedTelephone": "string",
    "buyerCardName": "string",
    "buyerCardNumber": "string",
    "showBuyerCard": "Y",
    "showBuyerAddressTel": "Y",
    "buyerMobilePhone": "string",
    "buyerEmail": "string",
    "agentUser": "string",
    "agentCardType": "string",
    "agentCardNo": "string",
    "agentCountry": "string",
    "agentTaxNo": "string",
    "originalInvoiceCode": "string",
    "originalInvoiceDate": "string",
    "originalEtaxInvoiceNo": "string",
    "originalInvoiceNo": "string",
    "govRedConfirmBillUuid": "string",
    "redReason": "string",
    "redConfirmBillNo": "string",
    "redConfirmEnterDate": "string",
    "inventoryProjectName": "string",
    "remark": "string",
    "inventoryFlag": "string",
    "naturalPersonFlag": "string",
    "businessType": "string",
    "buildInfo": {
      "simpleAddress": "string",
      "detailAddress": "string",
      "buildingName": "string",
      "landTaxNo": "string",
      "crossCitySign": "string",
      "crossCityTaxVerifyNo": "string"
    },
    "freightList": [
      {
        "startPlace": "string",
        "endPlace": "string",
        "transportType": "string",
        "licensePlate": "string",
        "transportGoods": "string"
      }
    ],
    "estateSaleInfo": {
      "estateCode": "string",
      "simpleAddress": "string",
      "detailAddress": "string",
      "crossCitySign": "string",
      "landTaxNo": "string",
      "approvedPrice": "string",
      "actualTurnover": "string",
      "estateId": "string",
      "areaUnit": "string"
    },
    "estateLeaseInfo": {
      "estateId": "string",
      "simpleAddress": "string",
      "detailAddress": "string",
      "startLeaseDate": "string",
      "endLeaseDate": "string",
      "crossCitySign": "string",
      "areaUnit": "string"
    },
    "cardType": "string",
    "differenceTaxType": "string",
    "totalDeduction": 0,
    "deductionList": [
      {
        "evidenceType": "string",
        "etaxInvoiceNo": "string",
        "invoiceCode": "string",
        "invoiceNo": "string",
        "evidenceNo": "string",
        "invoiceDate": "string",
        "evidenceAmount": 0,
        "deduction": 0,
        "remark": "string"
      }
    ],
    "items": [
      {
        "discountType": "0",
        "goodsName": "string",
        "goodsCode": "string",
        "specModel": "string",
        "unit": "string",
        "num": "string",
        "unitPrice": "string",
        "detailAmount": 0,
        "taxRate": 0,
        "taxAmount": 0,
        "discountAmount": 0,
        "deduction": 0,
        "preferentialPolicy": "0",
        "vatException": "01",
        "taxFreeType": "01",
        "coalTypeCode": "0100"
      }
    ],
    "extraList": [
      {
        "extraName": "string",
        "extraType": "string",
        "extraValue": "string"
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/push?access_token=&reqid=1624601109096123&taxNo=&name=&fpdk_type=3&callbackUrl=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "account": "string",
        "fpdkType": 0,
        "request_path": "string",
        "serialNo": "string",
        "invoiceAmount": 0,
        "type": 0,
        "taxFlag": 0,
        "drawer": "string",
        "payee": "string",
        "reviewer": "string",
        "paperInvoiceType": 0,
        "invoiceCopyType": "string",
        "invoiceType": "string",
        "totalAmount": 0,
        "totalTaxAmount": 0,
        "salerTaxNo": "string",
        "salerName": "string",
        "salerAddress": "string",
        "salerPhone": "string",
        "salerCardName": "string",
        "salerCardNumber": "string",
        "showSalerCard": "Y",
        "showSalerAddressTel": "Y",
        "buyerTaxNo": "string",
        "buyerName": "string",
        "buyerAddress": "string",
        "buyerFixedTelephone": "string",
        "buyerCardName": "string",
        "buyerCardNumber": "string",
        "showBuyerCard": "Y",
        "showBuyerAddressTel": "Y",
        "buyerMobilePhone": "string",
        "buyerEmail": "string",
        "agentUser": "string",
        "agentCardType": "string",
        "agentCardNo": "string",
        "agentCountry": "string",
        "agentTaxNo": "string",
        "originalInvoiceCode": "string",
        "originalInvoiceDate": "string",
        "originalEtaxInvoiceNo": "string",
        "originalInvoiceNo": "string",
        "govRedConfirmBillUuid": "string",
        "redReason": "string",
        "redConfirmBillNo": "string",
        "redConfirmEnterDate": "string",
        "inventoryProjectName": "string",
        "remark": "string",
        "inventoryFlag": "string",
        "naturalPersonFlag": "string",
        "businessType": "string",
        "buildInfo": {
            "simpleAddress": "string",
            "detailAddress": "string",
            "buildingName": "string",
            "landTaxNo": "string",
            "crossCitySign": "string",
            "crossCityTaxVerifyNo": "string"
        },
        "freightList": [
            {
                "startPlace": "string",
                "endPlace": "string",
                "transportType": "string",
                "licensePlate": "string",
                "transportGoods": "string"
            }
        ],
        "estateSaleInfo": {
            "estateCode": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "crossCitySign": "string",
            "landTaxNo": "string",
            "approvedPrice": "string",
            "actualTurnover": "string",
            "estateId": "string",
            "areaUnit": "string"
        },
        "estateLeaseInfo": {
            "estateId": "string",
            "simpleAddress": "string",
            "detailAddress": "string",
            "startLeaseDate": "string",
            "endLeaseDate": "string",
            "crossCitySign": "string",
            "areaUnit": "string"
        },
        "cardType": "string",
        "differenceTaxType": "string",
        "totalDeduction": 0,
        "deductionList": [
            {
                "evidenceType": "string",
                "etaxInvoiceNo": "string",
                "invoiceCode": "string",
                "invoiceNo": "string",
                "evidenceNo": "string",
                "invoiceDate": "string",
                "evidenceAmount": 0,
                "deduction": 0,
                "remark": "string"
            }
        ],
        "items": [
            {
                "discountType": "0",
                "goodsName": "string",
                "goodsCode": "string",
                "specModel": "string",
                "unit": "string",
                "num": "string",
                "unitPrice": "string",
                "detailAmount": 0,
                "taxRate": 0,
                "taxAmount": 0,
                "discountAmount": 0,
                "deduction": 0,
                "preferentialPolicy": "0",
                "vatException": "01",
                "taxFreeType": "01",
                "coalTypeCode": "0100"
            }
        ],
        "extraList": [
            {
                "extraName": "string",
                "extraType": "string",
                "extraValue": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

serialNo

string

流水号

必需

errcode

string

操作结果码

必需

成功时为0000, 失败时为非0000

description

string

操作描述

必需

描述，失败时可以根据这个字段进行提示

示例

{
  "errcode": "0000",
  "description": "发票开具成功",
  "data": {
    "serialNo": "9ad5b20cdc4b4e413f"
  }
}

🟠401失败

加密说明#

请求参数

示例代码

返回响应

加密说明