限制:此API仅对已被SAP Concur授予访问权限的合作伙伴可用。对该文档的访问不能提供对API的访问。此API在实现环境中不可用。

产品和版本

  • 同意发票专业版

使用范围

的名字 描述 端点
INVTV 发票-税务确认 GET、PUT

依赖关系

一个也没有。

获取计算税金的发票

提取计算税金的发票。

作用域

INVTV——是指使用范围全部细节。

请求

URI

模板
https://｛datacenterURI｝/ api / v3.0 /发票/ salestaxvalidationrequest

参数

的名字 类型 格式 描述
抵消 字符串 查询 在达到极限字段中指定的极限之后，下一组结果的起始点。
限制 Int32 查询 要检索的发票数量。最大值:1000年
modifiedafter 字符串 查询 可用于将结果限制为在指定日期之后修改的发票的参数。

有效载荷

  • 一个也没有。

响应

有效载荷

例子

请求

https://us.api.concursolutions.com/api/v3.0/invoice/salestaxvalidationrequest

响应

｛“TotalCount”：1，“项目”：［｛“RequestID”：“3 e6969dd15d64a349188”，“TaxReferenceID”：“9 b8888fa54ca47e598081f4527a2bc50”，“CountryCode”：“我们”，“标题”：“测试请求- 2月15日”，“PurchaseOrderNumber”：零，“InvoiceDate”：“2019-03-01 00:00:00.0”，“StatusCode”：零，“状态”：零，“InvoiceAmount”：“480.00000000”，“总”：“500.00000000”，“ShippingAmount”：“0.00000000”，“税”：“20.00000000”，“CalculatedTaxAmount”：零，“CalculatedTaxRate”：零，“CurrencyCode”：“美元”，“VendorInvoiceNumber”：“99999”，“OrgUnit1”：“1”，“OrgUnit1Value”：“百思买”，“OrgUnit2”：“100”，“OrgUnit2Value”：“极客团队”，“OrgUnit3”：零，“OrgUnit3Value”：零，“OrgUnit4”：零，“OrgUnit4Value”：零，“OrgUnit5”：零，“OrgUnit5Value”：零，“OrgUnit6”：零，“OrgUnit6Value”：零，“Custom1”：零，“Custom1Value”：零，“Custom2”：零，“Custom2Value”：零，“Custom3”：零，“Custom3Value”：零，“Custom4”：零，“Custom4Value”：零，“Custom5”：零，“Custom5Value”：零，“Custom6”：零，“Custom6Value”：零，“Custom7”：零，“Custom7Value”：零，“Custom8”：零，“Custom8Value”：零，“Custom9”：零，“Custom9Value”：零，“Custom10”：零，“Custom10Value”：零，“Custom11”：零，“Custom11Value”：零，“Custom12”：零，“Custom12Value”：零，“Custom13”：零，“Custom13Value”：零，“Custom14”：零，“Custom14Value”：零，“Custom15”：零，“Custom15Value”：零，“Custom16”：零，“Custom16Value”：零，“Custom17”：零，“Custom17Value”：零，“Custom18”：零，“Custom18Value”：零，“Custom19”：零，“Custom19Value”：零，“Custom20”：零，“Custom20Value”：零，“Custom21”：零，“Custom21Value”：零，“Custom22”：“默认”，“Custom22Value”：“Default-Change客户”，“Custom23”：零，“Custom23Value”：零，“Custom24”：零，“Custom24Value”：零，“BillToAddress”：｛“ExternalID”：零，“名称”：零，“Address1”：零，“Address2”：零，“Address3”：零，“城市”：零，“StateProvince”：零，“状态”：零，“邮政编码”：零，“CountryCode”：零}，“ShipToAddress”：｛“ExternalID”：零，“名称”：零，“Address1”：“BTP”，“Address2”：零，“Address3”：零，“城市”：“南部班加罗尔”，“StateProvince”：零，“状态”：零，“邮政编码”：“560093”，“CountryCode”：“在”}，“LineItem”：［｛“CommodityCode”：“95121513”，“数量”：“1.00000000”，“LineItemKey”：“gWo0fa6rk0zJkpaD3ZXHL8DbNaw”，“UnitPrice”：“200.00000000”，“总”：“200.00000000”，“CountryCode”：“我们”，“CalculatedTaxAmount”：零，“CalculatedTaxRate”：零，“CurrencyCode”：“美元”，“分配”：｛“分配”：［｛“Custom1”：“1”，“Custom1Value”：零，“Custom2”：“100”，“Custom2Value”：零，“Custom3”：零，“Custom3Value”：零，“Custom4”：零，“Custom4Value”：零，“Custom5”：零，“Custom5Value”：零，“Custom6”：零，“Custom6Value”：零，“Custom7”：零，“Custom7Value”：零，“Custom8”：零，“Custom8Value”：零，“Custom9”：零，“Custom9Value”：零，“Custom10”：零，“Custom10Value”：零，“Custom11”：零，“Custom11Value”：零，“Custom12”：零，“Custom12Value”：零，“Custom13”：零，“Custom13Value”：零，“Custom14”：零，“Custom14Value”：零，“Custom15”：零，“Custom15Value”：零，“Custom16”：零，“Custom16Value”：零，“Custom17”：零，“Custom17Value”：零，“Custom18”：零，“Custom18Value”：零，“Custom19”：零，“Custom19Value”：零，“Custom20”：零，“Custom20Value”：零，“AllocationAmount”：“200.00000000”｝］}，“供应商”：｛“VendorCode”：零，“VendorName”：“假日酒店”，“VendorAddressName”：零，“AddressCode”：零，“Address1”：零，“Address2”：零，“Address3”：零，“城市”：零，“状态”：零，“邮政编码”：零，“CountryCode”：零｝}，｛“CommodityCode”：“90111501”，“数量”：“1.00000000”，“LineItemKey”：“gWo0c5 sMJswx4W0tK pw2bwBTFtQ美元”，“UnitPrice”：“280.00000000”，“总”：“280.00000000”，“CountryCode”：“我们”，“CalculatedTaxAmount”：零，“CalculatedTaxRate”：零，“CurrencyCode”：“美元”，“分配”：｛“分配”：［｛“Custom1”：“1”，“Custom1Value”：零，“Custom2”：“100”，“Custom2Value”：零，“Custom3”：零，“Custom3Value”：零，“Custom4”：零，“Custom4Value”：零，“Custom5”：零，“Custom5Value”：零，“Custom6”：零，“Custom6Value”：零，“Custom7”：零，“Custom7Value”：零，“Custom8”：零，“Custom8Value”：零，“Custom9”：零，“Custom9Value”：零，“Custom10”：零，“Custom10Value”：零，“Custom11”：零，“Custom11Value”：零，“Custom12”：零，“Custom12Value”：零，“Custom13”：零，“Custom13Value”：零，“Custom14”：零，“Custom14Value”：零，“Custom15”：零，“Custom15Value”：零，“Custom16”：零，“Custom16Value”：零，“Custom17”：零，“Custom17Value”：零，“Custom18”：零，“Custom18Value”：零，“Custom19”：零，“Custom19Value”：零，“Custom20”：零，“Custom20Value”：零，“AllocationAmount”：“280.00000000”｝］}，“供应商”：｛“VendorCode”：零，“VendorName”：“假日酒店”，“VendorAddressName”：零，“AddressCode”：零，“Address1”：零，“Address2”：零，“Address3”：零，“城市”：零，“状态”：零，“邮政编码”：零，“CountryCode”：零｝｝]，“ID”：零，“URI”：零｝]，“全心全意”：零｝

JSON响应失败的示例

｛“错误”：｛“消息”：“禁止请求”，“服务器时间”：“2019 - 03 - 12 - t07:56:32”，“Id”：“65 f68719 - 3 - ff5 - 459 e - 8 b94 - 5 - fc93a5cd045”｝｝

用计算的税额和税率更新发票

根据计算的税额和税率更新发票。

作用域

INVTV——是指使用范围全部细节。

请求

URI

模板
https://｛datacenterURI｝/ / api / v3.0 /发票/ salestaxvalidationrequest

参数

的名字 类型 格式 描述
发票 - 身体 需要更新的发票的税务信息

有效载荷

发票

响应

有效载荷

状态模式

例子

请求

｛“CalculatedTaxAmount”：“150.00”，“CalculatedTaxRate”：“0.40”，“评论”：“更新计算税”，“LineItem”：［｛“CalculatedTaxAmount”：“50.00”，“CalculatedTaxRate”：“0.05”，“LineItemKey”：“gWo0b sLeIU2W18zqlQiELsE7TvQ美元”｝]，“StatusCode”：“CMPLT”，“TaxReferenceID”：“9 a0f8c3edf4040bba94394a1a0ca6dcb”｝

响应

｛“TaxReferenceID”：“9 a0f8c3edf4040bba94394a1a0ca6dcb”，“评论”：零，“状态”：“成功”，“类型”：零，“代码”：0，“消息”：零，“参数”：零，“记数字”：0｝

JSON响应失败的示例

｛“消息”：状态代码是必需的字段。错误，CMPLT是有效值。｝

发票模式

发票

的名字 类型 格式 描述
项目 数组 发票 结果集合。
全心全意地 字符串 - 结果下一页的URI(如果有的话)。
TotalCount Int32 - 退货的数量。

发票

的名字 类型 格式 描述
BillToAddress 对象 BillToAddress 与发票相关联的账单地址。
CalculatedTaxAmount 字符串 - 发票的计算税额。
CalculatedTaxRate 字符串 - 计算出的发票税率。
评论 字符串 - 发票的意见。
CountryCode 字符串 - 行项目的国家代码。
CurrencyCode 字符串 - 发票货币的3个字母ISO 4217货币代码。例子:美元，计算机辅助设计
ID 字符串 - 资源的唯一标识符。
InvoiceAmount 字符串 - 发票金额(购买物品的成本)。
InvoiceDate 字符串 - 发票的日期。
LineItem 数组 LineItem 与发票相关联的行项目。
通过OrgUnit6 OrgUnit1 字符串 - PUT不可用。OrgUnit字段中的代码。这些字段可能没有数据，这取决于配置。
OrgUnit1Value虽然OrgUnit6Value 字符串 - PUT不可用。OrgUnit字段中的值。这些字段可能没有数据，这取决于配置。
通过Custom24 Custom1 字符串 - PUT不可用。自定义字段中的代码。这些字段可能没有数据，这取决于配置。
通过Custom24Value Custom1Value 字符串 - PUT不可用。自定义字段中的值。这些字段可能没有数据，这取决于配置。
PurchaseOrderNumber 字符串 - 与发票相关联的采购订单号。
RequestID 字符串 - 发票的ID。
ShippingAmount 字符串 - 发票的装运金额。
ShipToAddress 对象 ShipToAddress 与发票相关联的装运地址。
状态 字符串 - 发票的状态。
StatusCode 字符串 - 要求发票的状态代码。支持的价值观:错误，CMPLT
税 字符串 - 税金，如发票上所示。这是供应商征收的税。
TaxReferenceID 字符串 - 要求发票的税务参考ID。
标题 字符串 - 发票的标题。
总计 字符串 - 发票的总金额。
URI 字符串 - 资源的URI。
VendorInvoiceNumber 字符串 - 与发票相关联的供应商发票号。

BillToAddress

的名字 类型 格式 描述
Address1 字符串 - 要求地址账单地址的第一行。
Address2 字符串 - 地址账单地址的第2行。
Address3 字符串 - 地址账单地址的第3行。
城市 字符串 - 要求账单地址所在的城市。
CountryCode 字符串 - 要求帐单地址的国家代码。
ExternalID 字符串 - 要求客户提供的唯一值，用于标识特定的账单地址。
的名字 字符串 - 一个可选的名称，可以给帐单地址。
PostalCode 字符串 - 要求账单地址的邮政编码。
状态 字符串 - 要求账单地址的状态。
StateProvince 字符串 - 要求计费地址所在的省份。

LineItem

的名字 类型 格式 描述
分配 对象 分配 与行项目相关联的拨款。
CalculatedTaxAmount 字符串 - 为个别行项目计算的税额。
CalculatedTaxRate 字符串 - 为个别项目计算的税率。
CommodityCode 字符串 - 绑定到与行项目相关联的费用类型的商品代码。
CountryCode 字符串 - 行项目的国家代码。
CurrencyCode 字符串 - 单个行项目的货币代码。
LineItemKey 字符串 - 要求唯一标识行项目的值。
数量 字符串 - 行项目的数量。
总计 字符串 - 行项目的总金额。
UnitPrice 字符串 - 行项目的单价。
供应商 对象 InvoiceVendor 关于每个行项目的供应商的详细信息。

分配

的名字 类型 格式 描述
AllocationAmount 字符串 - 与行项目相关联的分配量。
通过Custom20 Custom1 字符串 - PUT不可用。自定义字段中的代码。这些字段可能没有数据，这取决于配置。
通过Custom20Value Custom1Value 字符串 - PUT不可用。自定义字段中的值。这些字段可能没有数据，这取决于配置。

供应商

的名字 类型 格式 描述
Address1 字符串 - 要求地址供应商地址的第一行。
Address2 字符串 - 地址供应商地址的第2行。
Address3 字符串 - 地址供应商地址的第3行。
城市 字符串 - 要求卖主地址所在的城市。
CountryCode 字符串 - 要求供应商地址的国家代码。
PostalCode 字符串 - 要求供应商地址的邮政编码。
状态 字符串 - 要求供应商地址的状态。
VendorAddressName 字符串 - 要求供应商地址的名称。
VendorName 字符串 - 要求卖主的名字。
VendorCode 字符串 - 要求与供应商相关联的代码。

ShipToAddress

的名字 类型 格式 描述
Address1 字符串 - 要求地址第一行的发货地址。
Address2 字符串 - 地址第2行发货地址。
Address3 字符串 - 地址第3行发货地址。
城市 字符串 - 要求收货地址所在城市。
CountryCode 字符串 - 要求收货地址的国家代码。
ExternalID 字符串 - 要求客户提供的唯一值，用于标识特定的送货地址。
的名字 字符串 - 一个可选的名称，可以给送货地址。
PostalCode 字符串 - 要求收货地址的邮政编码。
状态 字符串 - 要求收货地址的状态。
StateProvince 字符串 - 要求收货地址所在省。

状态模式

的名字 类型 格式 描述
代码 int - 请求结果代码。
评论 字符串 - 为更新请求返回的注释。
消息 字符串 - 请求结果的消息。
记数字 int - 创建/更新请求的记录号。
状态 字符串 - 更新的状态。支持的价值观:成功，失败
TaxReferenceID 字符串 - 更新发票的税务参考ID。
类型 字符串 - 类型请求的结果。