JDBC Driver for Amazon Marketplace

Build 22.0.8538

SubmitVendorPayments

Submit new invoices to Amazon Marketplace.

Execute

This stored procedure has a few Aggregate inputs which can be specified as either JSON, XML or #temp tables. In the following example we are going to use temp tables as demonstration.

First, we are going to create temp tables shipAddr, tax and invoiceItems according to Address, TaxDetails and InvoiceItem table schemas respectively. 

INSERT INTO shipAddr#temp(  Name,     AddressLine1,          City,           County, CountryCode)
                  VALUES ('Name', 'Fayettville NC', 'Fayettville', 'North Carolina',        'NC');

INSERT INTO tax#temp(TaxRate,   Type, TaxAmount, TaxCurrencyCode)
             VALUES ( '1.51', 'CGST',    '1.51',           'EUR');

INSERT INTO invoiceItems#temp(ItemSequenceNumber, ItemSequenceNumber, AmazonProductIdentifier, PurchaseOrderNumber, InvoicedQuantityAmount, InvoicedQuantityUnit, NetCostAmount, NetCostCurrencyCode)
                      VALUES (             '111',              '222',                   '333',               '444',                     10,              'Cases',          '97',               'EUR');

After the necessary temporary table have been created, execute the stored procedure by providing the temp table name for aggregate inputs, as shown in the example below: 

EXECUTE SubmitVendorPayments
        Id                 = '123',
        InvoiceType        = 'Invoice',
        Date               = '2022',
        TotalAmount        = '100',
        TotalCurrencyCode  = 'EUR',
        RemitToPartyId     = '456',
        ShipToPartyId      = '789',
        ShipToPartyAddress = 'shipAddr#temp',
        TaxDetails         = 'tax#temp',
        Items              = 'invoiceItems#temp';

InvoiceItem temporary table schema info:

Column Name Type Required Description
ItemSequenceNumber Integer True Unique number related to this line item.
AmazonProductIdentifier String False Amazon Standard Identification Number (ASIN) of an item.
VendorProductIdentifier String False The vendor selected product identifier of the item. Should be the same as was provided in the purchase order.
PurchaseOrderNumber String False The Amazon purchase order number for this invoiced line item. Formatting Notes: 8-character alpha-numeric code. This value is mandatory only when invoiceType is Invoice.
HsnCode String False HSN Tax code. The HSN number cannot contain alphabets.
InvoicedQuantityAmount Integer True Quantity of an item. This value should not be zero.
InvoicedQuantityUnit String True Unit of measure for the quantity. Allowed values are:
  • Cases: Packing of individual items into a case.
  • Eaches: Individual items.
InvoicedQuantityUnitSize Integer False The case size, if the unit of measure value is Cases.
NetCostAmount String True A decimal number with no loss of precision.
NetCostCurrencyCode String True Three-digit currency code in ISO 4217 format.
CreditNoteReferenceInvoiceNumber String False Original Invoice Number when sending a credit note relating to an existing invoice. One Invoice only to be processed per Credit Note. This is mandatory for AP Credit Notes.
CreditNoteDebitNoteNumber String False Debit Note Number as generated by Amazon. Recommended for Returns and COOP Credit Notes.
CreditNoteReturnsReferenceNumber String False Identifies the Returns Notice Number. Mandatory for all Returns Credit Notes.
CreditNoteGoodsReturnDate Datetime False Defines a date and time according to ISO8601.
CreditNoteRmaId String False Identifies the Returned Merchandise Authorization ID, if generated.
CreditNoteCoopReferenceNumber String False Identifies the COOP reference used for COOP agreement. Failure to provide the COOP reference number or the Debit Note number may lead to a rejection of the Credit Note.
CreditNoteConsignorsReferenceNumber String False Identifies the consignor reference number (VRET number), if generated by Amazon.
TaxDetails Aggregate False Individual tax details per line item.
ChargeDetails Aggregate False Individual charge details per line item.
AllowanceDetails Aggregate False Individual allowance details per line item.

TaxDetails temporary table schema info:

Column Name Type RequiredDescription
Type String True Type of the tax applied. Allowed values are:
  • CGST: Central Goods and Services Tax (CGST) is levied by the Indian government for intrastate movement of goods and services.
  • SGST: State Goods and Services Tax (SGST) is an indirect tax levied and collected by a State Government in India on the intra-state supplies.
  • CESS: A CESS is a form of tax levied by the government on tax with specific purposes till the time the government gets enough money for that purpose.
  • UTGST: Union Territory Goods and Services Tax in India.
  • IGST: Integrated Goods and Services Tax (IGST) is a tax levied on all Inter-State supplies of goods and/or services in India.
  • MwSt.: Mehrwertsteuer, MwSt, is German for value-added tax.
  • PST: A provincial sales tax (PST) is imposed on consumers of goods and particular services in many Canadian provinces.
  • TVA: Taxe sur la Valeur Ajoutee (TVA) is French for value-added tax.
  • VAT: Value-added tax.
  • GST: Tax levied on most goods and services sold for domestic consumption.
  • ST: Sales tax.
  • Consumption: Tax levied on consumption spending on goods and services.
  • MutuallyDefined: Tax component that was mutually agreed upon between Amazon and vendor.
  • DomesticVAT: Domestic value-added tax.
TaxRate String False A decimal number with no loss of precision.
TaxAmount String True A decimal number with no loss of precision.
TaxCurrencyCode String True Three-digit currency code in ISO 4217 format.
TaxableAmount String False A decimal number with no loss of precision.
TaxableCurrencyCode String False Three-digit currency code in ISO 4217 format.

TaxRegistration temporary table schema info:

Column Name Type RequiredDescription
RegistrationType String True The tax registration type for the entity. Allowed values are:
  • VAT: Value-added tax.
  • GST: Goods and services tax.
RegistrationNumber String True The tax registration number for the entity. For example, VAT ID.

ChargeDetails temporary table schema info:

Column Name Type RequiredDescription
Type String True Type of the charge applied. Allowed values are:
  • Freight: Freight charges.
  • Packing: Packing fee.
  • Duty: Duty charges.
  • Service: Service fee.
  • SmallOrder: Small order fee.
  • InsurancePlacementCost: Insurance placement cost.
  • InsuranceFee: Insurance fee.
  • SpecialHandlingService: Special handling service fee.
  • CollectionAndRecyclingService: Collection and recycling service fee.
  • EnvironmentalProtectionService: Environmental protection service fee.
  • TaxCollectedAtSource: Tax collected at source.
Description String FalseDescription of the charge.
ChargeAmount String True A decimal number with no loss of precision.
ChargeCurrencyCode String True Three-digit currency code in ISO 4217 format.
TaxDetails Aggregate FalseTax amount details applied on this charge. See: TaxDetails table schema.

AllowanceDetails temporary table schema info:

Column Name Type RequiredDescription
Type String True Type of the allowance applied. Allowed values are:
  • Discount: Discount allowance.
  • DiscountIncentive: Discount incentive allowance.
  • Defective: Allowance applied for defective item.
  • Promotional: Promotional allowance.
  • UnsaleableMerchandise: Allowance applied due to unsaleable merchandise.
  • Special: Special allowances.
Description String False Description of the allowance.
AllowanceAmount String True A decimal number with no loss of precision.
AllowanceCurrencyCode String True Three-digit currency code in ISO 4217 format.
TaxDetails Aggregate False Tax amount details applied on this allowance. See: TaxDetails table schema.

AdditionalDetails temporary table schema info:

Column NameType RequiredDescription
Type String True The type of the additional information provided by the selling party. Allowed values are:
  • SUR: An additional tax on something already taxed, such as a higher rate of tax on incomes above a certain level.
  • OCR: OCR.
  • CartonCount: The total number of cartons invoiced.
Detail String True The detail of the additional information provided by the selling party.
LanguageCode String False The language code of the additional information detail.

Address temporary table schema info:

Column NameType RequiredDescription
Name String True The name of the person, business or institution at that address.
AddressLine1 String True First line of street address.
AddressLine2 String False Additional address information, if required.
AddressLine3 String False Additional address information, if required.
City String False The city where the person, business or institution is located.
County String False The county where person, business or institution is located.
District String False The district where person, business or institution is located.
StateOrRegion String False The state or region where person, business or institution is located.
PostalOrZipCode String False The postal or zip code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
CountryCode String True The two digit country code. In ISO 3166-1 alpha-2 format.
Phone String False The phone number of the person, business or institution located at that address.

Input

Name Type Required Description
InvoiceType String True Identifies the type of invoice.

The allowed values are Invoice, CreditNote.

Id String True Unique number relating to the charges defined in this document. This will be invoice number if the document type is Invoice or CreditNote number if the document type is Credit Note.
ReferenceNumber String False An additional unique reference number used for regulatory or other purposes.
Date Datetime True Defines a date and time according to ISO8601.
TotalAmount String True A decimal number with no loss of precision.
TotalCurrencyCode String True Three-digit currency code in ISO 4217 format.
PaymentType String False The payment term type for the invoice.

The allowed values are Basic, EndOfMonth, FixedDate, Proximo, PaymentDueUponReceiptOfInvoice, LetterofCredit.

PaymentDueDays Integer False The number of calendar days from the base date (invoice date) until the total amount on the invoice is due.
DiscountPercent String False A decimal number with no loss of precision.
DiscountDueDays Integer False The number of calendar days from the Base date (Invoice date) until the discount is no longer valid.
RemitToPartyId String True Assigned identification for the party.
RemitToPartyAddress Aggregate False A physical address. See: Address table schema.
RemitToPartyTaxDetails Aggregate False Tax registration details of the party. See: TaxRegistration table schema.
ShipToPartyId String False Assigned identification for the party.
ShipToPartyAddress Aggregate False A physical address. See: Address table schema.
ShipToPartyTaxDetails Aggregate False Tax registration details of the party. See: TaxRegistration table schema.
ShipFromPartyId String False Assigned identification for the party.
ShipFromPartyAddress Aggregate False A physical address. See: Address table schema.
ShipFromPartyTaxDetails Aggregate False Tax registration details of the party. See: TaxRegistration table schema.
BillToPartyId String False Assigned identification for the party.
BillToPartyAddress Aggregate False A physical address. See: Address table schema.
BillToPartyTaxDetails Aggregate False Tax registration details of the party. See: TaxRegistration table schema.
TaxDetails Aggregate False Total tax amount details for all line items. See: TaxDetails table schema.
AdditionalDetails Aggregate False Additional details provided by the selling party, for tax related or other purposes. See: AdditionalDetails table schema.
ChargeDetails Aggregate False Total charge amount details for all line items. See: ChargeDetails table schema.
AllowanceDetails Aggregate False Total allowance amount details for all line items. See: AllowanceDetails table schema.
Items Aggregate False The list of invoice items. See: InvoiceItem table schema.

Result Set Columns

Name Type Description
Success String Boolean indicating whether the stored procedure was successfully executed.
TransactionId String GUID to identify this transaction. This value can be used with the CheckVendorTransactionStatus stored procedure to return the status of this transaction.

Copyright (c) 2023 CData Software, Inc. - All rights reserved.
Build 22.0.8538