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

向亚马逊提交新发票。

使用计划：

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

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

请求参数

Body 参数application/json

`submitInvoices`操作的请求架构。

invoices

array[object (Invoice) {15}]

可选

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

invoiceType

enum<string>

识别发票的类型。

必需

枚举值:

InvoiceCreditNote

string

必需

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

referenceNumber

string

可选

用于监管或其他目的的额外唯一参考号码。

date

string <date-time>

必需

根据ISO 8601定义日期和时间。

remitToParty

object (PartyIdentification)

必需

一方的姓名、地址和税务信息。

shipToParty

object (PartyIdentification)

可选

一方的姓名、地址和税务信息。

shipFromParty

object (PartyIdentification)

可选

一方的姓名、地址和税务信息。

billToParty

object (PartyIdentification)

可选

一方的姓名、地址和税务信息。

paymentTerms

object (PaymentTerms)

可选

发票的付款条款。付款条款的基础是发票日期。

invoiceTotal

object (Money)

必需

一笔钱，包括以货币形式存在的单位。

taxDetails

array[object (TaxDetails) {4}]

可选

所有项目的总税额详情。

additionalDetails

array[object (AdditionalDetails) {3}]

可选

卖方提供的额外细节，用于税务或其他目的。

chargeDetails

array[object (ChargeDetails) {4}]

可选

所有项目的总收费金额详情。

allowanceDetails

array[object (AllowanceDetails) {4}]

可选

所有项目的总津贴金额详情。

items

array[object (InvoiceItem) {11}]

发票项目清单。

可选

示例

{
  "invoices": [
    {
      "invoiceType": "Invoice",
      "id": "string",
      "referenceNumber": "string",
      "date": "2019-08-24T14:15:22Z",
      "remitToParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalOrZipCode": "string",
          "countryCode": "st",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string"
          }
        ]
      },
      "shipToParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalOrZipCode": "string",
          "countryCode": "st",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string"
          }
        ]
      },
      "shipFromParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalOrZipCode": "string",
          "countryCode": "st",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string"
          }
        ]
      },
      "billToParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalOrZipCode": "string",
          "countryCode": "st",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string"
          }
        ]
      },
      "paymentTerms": {
        "type": "Basic",
        "discountPercent": "string",
        "discountDueDays": 0,
        "netDueDays": 0
      },
      "invoiceTotal": {
        "currencyCode": "string",
        "amount": "string"
      },
      "taxDetails": [
        {
          "taxType": "CGST",
          "taxRate": "string",
          "taxAmount": {
            "currencyCode": "string",
            "amount": "string"
          },
          "taxableAmount": {
            "currencyCode": "string",
            "amount": "string"
          }
        }
      ],
      "additionalDetails": [
        {
          "type": "SUR",
          "detail": "string",
          "languageCode": "string"
        }
      ],
      "chargeDetails": [
        {
          "type": "Freight",
          "description": "string",
          "chargeAmount": {
            "currencyCode": "string",
            "amount": "string"
          },
          "taxDetails": [
            {
              "taxType": "CGST",
              "taxRate": "string",
              "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
              }
            }
          ]
        }
      ],
      "allowanceDetails": [
        {
          "type": "Discount",
          "description": "string",
          "allowanceAmount": {
            "currencyCode": "string",
            "amount": "string"
          },
          "taxDetails": [
            {
              "taxType": "CGST",
              "taxRate": "string",
              "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
              }
            }
          ]
        }
      ],
      "items": [
        {
          "itemSequenceNumber": 0,
          "amazonProductIdentifier": "string",
          "vendorProductIdentifier": "string",
          "invoicedQuantity": {
            "amount": 0,
            "unitOfMeasure": "Cases",
            "unitSize": 0
          },
          "netCost": {
            "currencyCode": "string",
            "amount": "string"
          },
          "purchaseOrderNumber": "string",
          "hsnCode": "string",
          "creditNoteDetails": {
            "referenceInvoiceNumber": "string",
            "debitNoteNumber": "string",
            "returnsReferenceNumber": "string",
            "goodsReturnDate": "2019-08-24T14:15:22Z",
            "rmaId": "string",
            "coopReferenceNumber": "string",
            "consignorsReferenceNumber": "string"
          },
          "taxDetails": [
            {
              "taxType": "CGST",
              "taxRate": "string",
              "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
              }
            }
          ],
          "chargeDetails": [
            {
              "type": "Freight",
              "description": "string",
              "chargeAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxDetails": [
                {
                  "taxType": "CGST",
                  "taxRate": "string",
                  "taxAmount": {
                    "currencyCode": "string",
                    "amount": "string"
                  },
                  "taxableAmount": {
                    "currencyCode": "string",
                    "amount": "string"
                  }
                }
              ]
            }
          ],
          "allowanceDetails": [
            {
              "type": "Discount",
              "description": "string",
              "allowanceAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxDetails": [
                {
                  "taxType": "CGST",
                  "taxRate": "string",
                  "taxAmount": {
                    "currencyCode": "string",
                    "amount": "string"
                  },
                  "taxableAmount": {
                    "currencyCode": "string",
                    "amount": "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服务器故障