submitInvoices - Amazon Selling Partner API (SP-API)-中文

向亚马逊提交新发票。

使用计划：

速率（每秒请求数）	峰值
10	10

当可用时，x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制。上述表格指示此操作的默认速率和峰值值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比这里列出的更高的速率和峰值值。有关更多信息，请参见销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Body 参数application/json

`submitInvoices`操作的请求架构。

invoices

array[object (Invoice) {10}]

可选

表示要提交的发票或信用凭证的发票对象数组。

date

string <date-time>

可选

发票发出的日期和时间。值采用ISO 8601 日期时间格式。

errorCode

string

可选

如果发票处于错误状态，则此属性显示错误代码。

externalInvoiceId

string

可选

外部机构使用的发票标识符。通常是授权该发票的政府机构。

govResponse

string

可选

政府部门在发票开具过程中出现错误时的响应消息。

string

可选

与本文件中定义的费用相关的唯一编号。如果文件类型为发票，则此编号将是发票号码；如果文件类型为贷项通知书，则此编号将是贷项通知书编号。未提供此参考将导致拒绝。

invoiceType

string

识别发票的类型。

可选

series

string

可选

使用此标识符与 externalInvoiceId 结合，以识别来自同一卖家的发票。

status

string

可选

发票状态分类。使用 getInvoicesAttributes 操作检查发票状态选项。

transactionIds

array[object (TransactionIdentifier) {2}]

可选

与发票相关的交易标识符列表。

transactionType

string

可选

发起此发票的交易分类。使用getInvoicesAttributes操作检查transactionType选项。

示例

{
  "invoices": [
    {
      "date": "2019-08-24T14:15:22Z",
      "errorCode": "string",
      "externalInvoiceId": "string",
      "govResponse": "string",
      "id": "string",
      "invoiceType": "string",
      "series": "string",
      "status": "string",
      "transactionIds": [
        {
          "name": "string",
          "id": "string"
        }
      ],
      "transactionType": "string"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢202成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`submitInvoices` 操作的响应模式。

payload

object (TransactionId)

可选

包含交易ID的响应。

transactionId

string

可选

用于识别此事务的GUID。此值可以与事务状态API一起使用，以返回此事务的状态。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
  "payload": {
    "transactionId": "20190904171225-e1275c33-d75b-4bfe-b95c-15a9abfc09cc"
  }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障