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

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/payments/v1/invoices' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
                                    }
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢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服务器故障