Submit invoices
Learn how to programmatically submit invoices to Amazon for shipped items.
Learn how to programmatically submit invoices to Amazon for shipped items and accelerate payments.
Prerequisites
To complete this tutorial, you need:
- Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API Applications.
- The Vendor Retail Procurement Invoices role assigned to your developer profile.
Submit Invoices
You can use the submitInvoices
operation to request payment from Amazon for items shipped. You can use this operation to submit multiple invoices in a single API call.
Items must be invoiced only after they are confirmed and shipped to Amazon. Otherwise, the invoice is rejected.
An invoice with correct information is processed by Amazon without any human interaction, which means that you receive payment more quickly.
Invoices with incorrect information are rejected in Amazon's payee system, so sending correct information is important. Refer to the Business requirements to learn how to create invoices with correct information.
Business requirements
-
For items priced by weight, you must provide the
totalWeight
field. ThetotalWeight
field contains the aggregate weight of the item that is invoiced. Additionally, thenetCostUnitOfMeasure
field must reflect the unit of measure for the items that you price by weight. The unit of measure values includePOUNDS
,OUNCES
,GRAMS
, andKILOGRAMS
. -
Invoice numbers must be unique and must never be reused.
-
If an invoice sent by API fails due to incorrect data, but a Vendor Central invoice has the correct data, then you must update the invoice through the API with the correct data using the same Invoice ID.
-
When you submit incorrect invoice data through either Vendor Central or the API, Amazon cancels the invoice. Send a new invoice with a new Invoice ID.
-
Invoices with
total amount = 0
fails. -
Include complete address details in all address segments to comply with tax requirements. The bill-to party address must match exactly with the Amazon Payee system. To view all valid addresses, refer to SP-API Bill-to Party Addresses.
-
Payment terms sent in an invoice must match the payment terms agreed upon with the Amazon buyer.
-
Item product identifier must match the order item product identifier that was sent to the vendor in the matching purchase order.
-
The invoice total amount must be equal to the total sum of the items, charges, and allowances.
-
Total of tax amount for each line level must be equal to total of tax amount at the header level.
-
The invoice total quantity must match the sum of the quantity of all items.
-
Each different charges and allowance must itemize on the header level (for example freight charge, package charge, and small ordering charge).
Warning
The remit-to address must match the address that Amazon has on file. If the address doesn't match, the invoice fails.
Country-specific business requirements
Functionality | India | Europe | North America |
---|---|---|---|
Invoice type | Invoice type CreditNote is not supported. Invoice type must always be Invoice . | Invoice types Invoice and CreditNote are supported. Vendors need to send the invoice type accordingly. | Invoice type CreditNote is not supported. Invoice type must always be Invoice . |
Credit note references | Not used | Vendors are required to send these references at the item level if the invoice type is CreditNote . | Not used |
Date | Must be now or before. | Must be now or before. | Must be now or before. |
HSN number | The Harmonized System of Nomenclature (HSN) code is mandatory for tax-compliant invoices. Maximum length allowed is eight characters. | Not used | Not used |
Tax type at line and header level | The following are allowed for tax type: - SGST & CGST - >SGST & CGST & CESS - UTGST & CGST - UTGST & CGST & CESS - IGST - IGST & CESS If no tax information is provided, the invoice is rejected. | Tax type to be sent. | Not used |
Tax registration number | A 15-character GST ID must be provided. | VAT Number | VAT Number |
Tax details at line and header level | If multiple taxes are applicable for an item, the tax details section must be sent multiple times with the appropriate tax type for that item. The same applies to the total amount of the invoice. | If multiple taxes are applicable for an item, the tax details section must be sent multiple times with the appropriate tax type for that item. The same applies to the total amount of the invoice. There is also an additional tax type called DomesticVAT , which can be used to submit the tax amount in the local currency. In order to process the Domestic VAT you must use the same TaxRate used on tax Type VAT . | If multiple taxes are applicable for an item, the tax details section must be sent multiple times with the appropriate tax type for that item. The same applies to the total amount of the invoice. |
Remit-to party | The party who supplies goods to Amazon and gets the payment. Also referred to as 'supplier'. | Tax and address details of the party (vendor) who receive the payment for the shipped items (in the case of an invoice) or the returned items (in case of a credit note). This is required. | Tax and address details of the party (vendor) who receive the payment for the shipped items. This is required. |
Ship-from party | Ship-from address details, along with the State ISO Code. GST ID must be sent in the tax registration number. Ship-from party is required. Values must match the values in Amazon's systems. | Vendor code or warehouse code and address of the party from where items are shipped. | Vendor code or warehouse code and address of the party from where items are shipped. |
Ship-to party | Ship-to address details along with the State ISO Code. Ship-to party is required. Values must match the values in Amazon's systems. | Amazon ID or warehouse code and address of the party to which items are shipped. | Amazon ID or warehouse code and address of the party to which items are shipped. |
Bill-to party | Bill-to party is required. It might be the same as ship-to party. If so, the vendor is required to send the same information in both segments. | Tax and address details of the party (Amazon) who is billed for the shipped items (in case of an Invoice) or the returned items (in case of a credit note). For a complete list of Amazon bill-to party addresses and JSON code examples, refer to SP-API Bill-to Party Addresses. This field is required. | Tax and address details of the party (Amazon) who is billed for shipped items. This field is required. |
Amazon Product Identifier and External Product Identifier | At least one of these values is required. The identifier must be the same as what is received in order. | At least one of those values is required. The identifier must be the same as what is received in order. | At least one of those values is required. The identifier must be the same as what is received in order. |
Net cost | This field is required. | This field is required. | This field is required. |
Purchase order number | One invoice can contain information for only one order. Therefore the purchase order number must be the same for all line items in one invoice. Required. | One invoice can have information for multiple orders. The purchase order number must be sent accordingly for different line items. This field is required if the invoice type is Invoice and is not used when the invoice type is CreditNote . | One invoice can have information for multiple orders. The purchase order number must be sent accordingly for different line items. Required. |
Additional details | Not used. | This field is used when the selling party has to submit additional details for special purposes. For example, in the case of Polish split payment invoices, the selling party must send in the detail "mechanizm podzielonej płatności" of type SUR and languageCode "PL". | Not used. |
referenceNumber | A unique invoice reference number generated by Government of India for every invoice. This field is mandatory. | Not used. | Not used. |
Note
An invoice can be successfully submitted, then rejected. If your invoice is rejected after a successful submission, you will receive an email with details about why it was rejected.
Invoice with multiple items with no tax
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "I5599913",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "US"
}
},
"shipToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "US"
}
},
"billToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"addressLine3": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "US"
}
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "2.00",
"discountDueDays": 30,
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "USD",
"amount": "1295"
},
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "040YP0U",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "140"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "0264CBS",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "125"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "040YP0K",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "130"
},
"purchaseOrderNumber": "S8672793"
}
]
}
]
}
Invoice with single tax on an item
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "5002841638",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "CA"
}
},
"billToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"addressLine3": "123 ANY STREET",
"city": "ANYTWON",
"stateOrRegion": "XY",
"postalOrZipCode": "12345",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "CAD",
"amount": "1950"
},
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "97.5"
},
"taxableAmount": {
"currencyCode": "CAD",
"amount": "1950"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "1012380100000",
"invoicedQuantity": {
"amount": 4,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "1000570100000",
"invoicedQuantity": {
"amount": 30,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "50.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "2.50"
}
}
]
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "0543900100000",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "90"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "4.50"
}
}
]
},
{
"itemSequenceNumber": 4,
"amazonProductIdentifier": "ABC123437",
"vendorProductIdentifier": "1000570200000",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
}
]
}
]
}
Invoice with multiple taxes on an item
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "8900000001234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "258262.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809000-0000",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.90",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.91",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
]
}
]
}
]
}
Invoice with header-level and line-level allowance/charge details with tax
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "0136981234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORVATID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "123 ANY STREET",
"addressLine2": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONVATID"
}
]
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "5",
"discountDueDays": 15,
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "259678.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "1200.00"
},
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
},
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
}
]
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809281-5100",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.93",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
}
]
}
]
}
EU credit note with tax
{
"invoices": [
{
"invoiceType": "CreditNote",
"id": "BasicCredit",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON EU SARL, UK BRANCH",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"postalOrZipCode": "123456",
"countryCode": "GB"
}
},
"billToParty": {
"partyId": "VendorCode",
"address": {
"name": "Vendor Name",
"addressLine1": "123 ANY STREET",
"city": "ANYTOWN",
"stateOrRegion": "XY",
"postalOrZipCode": "123456",
"countryCode": "GB"
}
},
"invoiceTotal": {
"currencyCode": "GBP",
"amount": "100"
},
"taxDetails": [
{
"taxType": "VAT",
"taxRate": "10",
"taxAmount": {
"currencyCode": "GBP",
"amount": "10.00"
},
"taxableAmount": {
"currencyCode": "GBP",
"amount": "100.00"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "TESTSKU",
"invoicedQuantity": {
"amount": 1,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "GBP",
"amount": "100"
},
"creditNoteDetails": {
"referenceInvoiceNumber": "test-basic-ref",
"debitNoteNumber": "debit-ref",
"returnsReferenceNumber": "return-ref",
"goodsReturnDate": "2019-07-24T21:17:59.821Z",
"rmaId": "rma-ref",
"consignorsReferenceNumber": "VRET-ref"
}
}
]
}
]
}
Updated about 22 hours ago