回写入账信息 - 发票云(标准版)API文档

提示

入账一般为报销的最后一步，在回写入账信息之后，单据的最新状态会变更为65已入账，单据下的发票报销状态，也是如此

请求参数

Query 参数

access_token

string

可选

访问授权，访问token，获取方式请查阅《对接约定》

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

accountInfo

object

可选

accountId

string

账套ID（唯一）

可选

accountInfo传入时必填

<= 20 字符

system

string

核算体系

可选

<= 100 字符

type

string

账套类型

可选

<= 100 字符

subject

string

科目表

可选

<= 100 字符

baseCurrency

string

本位币

可选

<= 100 字符

exchangeRate

string

汇率表

可选

<= 100 字符

voucherInfo

object

可选

vouchId

string

凭证ID

可选

voucherInfo传入时必填

<= 50 字符

vouchNo

string

凭证号

可选

<= 100 字符

businessDate

string

业务日期

可选

yyyy_MM_dd

<= 10 字符

accountDate

string

记账日期

可选

yyyy_MM_dd

<= 10 字符

period

string

所属账期

可选

yyyyMM

<= 6 字符

voucherAccountId

string

凭证所属账套ID（唯一）

可选

<= 256 字符

voucherCompanyId

string

凭证所属企业ID（唯一）

可选

voucherInfo传入时必填

<= 50 字符

type

string

凭证类型

可选

<= 20 字符

resource

string

凭证来源

可选

1发票云、2EAS、3Cloud、4苍穹、5星空、6k3w、7SAP、11泛微

supInformation

string

补充资料

可选

<= 255 字符

supInformationAmount

string

补充资料金额

可选

<= 19 字符

creator

string

制单人

可选

<= 255 字符

examiner

string

审核人

可选

<= 255 字符

reviewer

string

复核人

可选

<= 255 字符

attachmentsCount

string

附件数

可选

item

string

主表项目

可选

<= 255 字符

accountItem

string

主表核算项目

可选

<= 255 字符

accountItemAmount

string

主表项目金额

可选

<= 19 字符

entries

array [object {12}]

可选

companyInfo

object

可选

companyId

string

企业ID（唯一）

可选

<= 50 字符

number

string

企业编码

可选

<= 50 字符

name

string

企业名称

可选

<= 255 字符

expenseIdArray

array[string]

单据ID集合

可选

(与serialNoArray二选一)

serialNoArray

array[string]

发票流水号集合

可选

(与expenseIdArray二选一)

invoiceData

array [object {5}]

可选

serialNo

string

发票流水号

可选

<= 36 字符

deductionFlag

string

是否能抵扣

可选

0不可，1可以

<= 1 字符

deductionTaxAmount

string

入账税额

可选

<= 18 字符

remark

string

转出原因

可选

<= 128 字符

outputAmount

string

转出金额

可选

<= 18 字符

示例

{
  "accountInfo": {
    "accountId": "账套ID（唯一）",
    "system": "核算体系",
    "type": "账套类型",
    "subject": "科目表",
    "baseCurrency": "本位币",
    "exchangeRate": "汇率表"
  },
  "voucherInfo": {
    "vouchId": "凭证ID",
    "vouchNo": "凭证号",
    "businessDate": "业务日期yyyy_MM_dd",
    "accountDate": "记账日期yyyy_MM_dd",
    "period": "所属账期yyyyMM",
    "voucherAccountId": "凭证所属账套ID（唯一）",
    "voucherCompanyId": "凭证所属企业ID（唯一）",
    "type": "凭证类型",
    "resource": "凭证来源：1发票云、2EAS、3Cloud、4苍穹、5星空、6k3w、7SAP、11泛微",
    "supInformation": "补充资料",
    "supInformationAmount": "补充资料金额",
    "creator": "制单人",
    "examiner": "审核人",
    "reviewer": "复核人",
    "attachmentsCount": "附件数",
    "item": "主表项目",
    "accountItem": "主表核算项目",
    "accountItemAmount": "主表项目金额",
    "entries": [
      {
        "unit": "计量单位",
        "amount": "原币金额",
        "exchangeRate": "汇率",
        "subject": "科目",
        "price": "单价",
        "accountDimension": "核算维度",
        "dueDate": "到期日yyyy_MM_dd",
        "num": "数量",
        "currency": "币别",
        "abstract": "摘要",
        "creditAmount": "贷方合计",
        "debitsAmount": "借方合计"
      }
    ]
  },
  "companyInfo": {
    "companyId": "企业ID（唯一）",
    "number": "企业编码",
    "name": "企业名称"
  },
  "expenseIdArray": [
    "单据ID1",
    "单据ID2",
    "单据ID3"
  ],
  "serialNoArray": [
    "发票流水号1",
    "发票流水号2",
    "发票流水号3"
  ],
  "invoiceData": [
    {
      "serialNo": "发票流水号",
      "deductionFlag": "是否能抵扣，0不可，1可以",
      "deductionTaxAmount": "入账税额",
      "remark": "转出原因",
      "outputAmount": "转出金额"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/m4/bill/expense/additionalInformation/collect?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountInfo": {
            "accountId": "账套ID（唯一）",
            "system": "核算体系",
            "type": "账套类型",
            "subject": "科目表",
            "baseCurrency": "本位币",
            "exchangeRate": "汇率表"
    },
    "voucherInfo": {
            "vouchId": "凭证ID",
            "vouchNo": "凭证号",
            "businessDate": "业务日期yyyy_MM_dd",
            "accountDate": "记账日期yyyy_MM_dd",
            "period": "所属账期yyyyMM",
            "voucherAccountId": "凭证所属账套ID（唯一）",
            "voucherCompanyId": "凭证所属企业ID（唯一）",
            "type": "凭证类型",
            "resource": "凭证来源：1发票云、2EAS、3Cloud、4苍穹、5星空、6k3w、7SAP、11泛微",
            "supInformation": "补充资料",
            "supInformationAmount": "补充资料金额",
            "creator": "制单人",
            "examiner": "审核人",
            "reviewer": "复核人",
            "attachmentsCount": "附件数",
            "item": "主表项目",
            "accountItem": "主表核算项目",
            "accountItemAmount": "主表项目金额",
            "entries": [
            {
                "unit": "计量单位",
                "amount": "原币金额",
                "exchangeRate": "汇率",
                "subject": "科目",
                "price": "单价",
                "accountDimension": "核算维度",
                "dueDate": "到期日yyyy_MM_dd",
                "num": "数量",
                "currency": "币别",
                "abstract": "摘要",
                "creditAmount": "贷方合计",
                "debitsAmount": "借方合计"
            }
        ]
    },
    "companyInfo": {
            "companyId": "企业ID（唯一）",
            "number": "企业编码",
            "name": "企业名称"
    },
    "expenseIdArray": [
        "单据ID1",
        "单据ID2",
        "单据ID3"
    ],
        "serialNoArray": [
        "发票流水号1",
        "发票流水号2",
        "发票流水号3"
    ],
        "invoiceData": [
        {
            "serialNo": "发票流水号",
            "deductionFlag": "是否能抵扣，0不可，1可以",
            "deductionTaxAmount": "入账税额",
            "remark": "转出原因",
            "outputAmount": "转出金额"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

string

响应码

必需

0000成功，其他失败

description

string

描述

必需

traceId

string

追踪ID

必需

用于出现异常，发票云定位日志使用

data

array[string]

数据

必需

发票结构化数据集合

示例

成功示例异常示例

{
  "errcode": "0000",
  "description": "操作成功",
  "traceId": ""
}