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

提交一个或多个供应商直接配送订单的发票。

使用计划：

速率（每秒请求数）	突发
10	10

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

请求参数

Body 参数application/json

提交发票操作的请求模式。

invoices

array[object (InvoiceDetail) {13}]

可选

您想提交的发票详细信息数组。

invoiceNumber

string

唯一的发票号码。

必需

invoiceDate

string <date-time>

发票日期。

必需

referenceNumber

string

可选

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

remitToParty

object (PartyIdentification)

必需

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

shipFromParty

object (PartyIdentification)

必需

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

billToParty

object (PartyIdentification)

可选

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

shipToCountryCode

string

发货国家代码。

可选

paymentTermsCode

string

发票的付款条款。

可选

invoiceTotal

object (Money)

必需

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

taxTotals

array[object (TaxDetail) {4}]

可选

每个项目的个人税务详情。

additionalDetails

array[object (AdditionalDetails) {3}]

可选

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

chargeDetails

array[object (ChargeDetails) {3}]

可选

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

items

array[object (InvoiceItem) {10}]

必需

提供该发票中项目的详细信息。

示例

{
  "invoices": [
    {
      "invoiceNumber": "string",
      "invoiceDate": "2019-08-24T14:15:22Z",
      "referenceNumber": "string",
      "remitToParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalCode": "string",
          "countryCode": "string",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string",
            "taxRegistrationAddress": {
              "name": "string",
              "addressLine1": "string",
              "addressLine2": "string",
              "addressLine3": "string",
              "city": "string",
              "county": "string",
              "district": "string",
              "stateOrRegion": "string",
              "postalCode": "string",
              "countryCode": "string",
              "phone": "string"
            },
            "taxRegistrationMessage": "string"
          }
        ]
      },
      "shipFromParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalCode": "string",
          "countryCode": "string",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string",
            "taxRegistrationAddress": {
              "name": "string",
              "addressLine1": "string",
              "addressLine2": "string",
              "addressLine3": "string",
              "city": "string",
              "county": "string",
              "district": "string",
              "stateOrRegion": "string",
              "postalCode": "string",
              "countryCode": "string",
              "phone": "string"
            },
            "taxRegistrationMessage": "string"
          }
        ]
      },
      "billToParty": {
        "partyId": "string",
        "address": {
          "name": "string",
          "addressLine1": "string",
          "addressLine2": "string",
          "addressLine3": "string",
          "city": "string",
          "county": "string",
          "district": "string",
          "stateOrRegion": "string",
          "postalCode": "string",
          "countryCode": "string",
          "phone": "string"
        },
        "taxRegistrationDetails": [
          {
            "taxRegistrationType": "VAT",
            "taxRegistrationNumber": "string",
            "taxRegistrationAddress": {
              "name": "string",
              "addressLine1": "string",
              "addressLine2": "string",
              "addressLine3": "string",
              "city": "string",
              "county": "string",
              "district": "string",
              "stateOrRegion": "string",
              "postalCode": "string",
              "countryCode": "string",
              "phone": "string"
            },
            "taxRegistrationMessage": "string"
          }
        ]
      },
      "shipToCountryCode": "string",
      "paymentTermsCode": "string",
      "invoiceTotal": {
        "currencyCode": "string",
        "amount": "string"
      },
      "taxTotals": [
        {
          "taxType": "CGST",
          "taxRate": "string",
          "taxAmount": {
            "currencyCode": "string",
            "amount": "string"
          },
          "taxableAmount": {
            "currencyCode": "string",
            "amount": "string"
          }
        }
      ],
      "additionalDetails": [
        {
          "type": "SUR",
          "detail": "string",
          "languageCode": "string"
        }
      ],
      "chargeDetails": [
        {
          "type": "GIFTWRAP",
          "chargeAmount": {
            "currencyCode": "string",
            "amount": "string"
          },
          "taxDetails": [
            {
              "taxType": "CGST",
              "taxRate": "string",
              "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
              }
            }
          ]
        }
      ],
      "items": [
        {
          "itemSequenceNumber": "string",
          "buyerProductIdentifier": "string",
          "vendorProductIdentifier": "string",
          "invoicedQuantity": {
            "amount": 0,
            "unitOfMeasure": "string"
          },
          "netCost": {
            "currencyCode": "string",
            "amount": "string"
          },
          "purchaseOrderNumber": "string",
          "vendorOrderNumber": "string",
          "hsnCode": "string",
          "taxDetails": [
            {
              "taxType": "CGST",
              "taxRate": "string",
              "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
              },
              "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
              }
            }
          ],
          "chargeDetails": [
            {
              "type": "GIFTWRAP",
              "chargeAmount": {
                "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

提交发票操作的响应模式。

payload

object (TransactionReference)

可选

包含交易ID的响应。

transactionId

string

可选

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

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
  "payload": {
    "transactionId": "string"
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string"
    }
  ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障