Hub per sviluppatoriStato dell'APISupporto

Crea e carica fatture

Scopri come creare e caricare fatture con e senza registrazione VCS.

Dopo esserti registrato a VCS, hai due opzioni per creare e caricare le fatture:

Se non desideri utilizzare VCS, puoi utilizzare i tuoi dati fiscali per creare fatture, quindi caricarle manualmente tramite SP-API o tramite Seller Central. Per istruzioni su come utilizzare questo metodo, consulta Carica manualmente le fatture.

Suggerimento

Non fornire informazioni sulle rimesse del venditore nelle fatture perché ciò può confondere i clienti. Amazon riscuote i pagamenti direttamente dai clienti ed eroga l'importo ai venditori.

Per informazioni sui requisiti di conformità delle fatture e sulle correzioni delle fatture, fare riferimento a Conformità e correzione delle fatture VCS.

Consenti ad Amazon di creare fatture per te

Questa opzione è disponibile per tutti i venditori che si iscrivono al Servizio di calcolo dell'IVA (VCS) e selezionano I want Amazon to generate invoices on my behalf opzione per accedere al rapporto di calcolo dell'IVA di Amazon. Questo rapporto contiene informazioni utili sugli ordini VCS, tra cui: il numero della fattura, il link alla fattura, l'IVA dell'acquirente e le informazioni sul mittente e sul destinatario della spedizione. Gli ordini sono disponibili in questo rapporto tre giorni dopo la spedizione. Utilizza le informazioni nella tabella seguente per richiedere il report VCS utilizzando l'API Selling Partner (SP-API).

APIAPI Report
OperationcreateReport
ReportTypeSC_VAT_TAX_REPORT

Il programma VCS influisce sul contenuto dei seguenti report:

Report sugli ordini

Includi l'importo dell'IVA

Rapporti sugli ordini richiesti dopo ti iscrivi a VCS appaiono come segue:

  • ItemTax (nei report XML) e item_tax (nei report in formato flat file). Contiene l'importo dell'IVA, calcolato da Amazon.
  • ItemPrice (nei report XML) e item_price (nei report in formato flat file). Contiene il prezzo IVA inclusa.

L'importo IVA esclusa è il prezzo dell'articolo meno l'imposta sull'articolo.

📘

Nota

Quando l'imposta sull'articolo è pari a zero, per la transazione è stata addebitata l'IVA allo 0%. Questo può accadere in diverse circostanze. Gli esempi includono le transazioni internazionali e le transazioni transfrontaliere B2B dell'UE. Per ulteriori informazioni, fare riferimento a Metodologia di calcolo VCS.

Includi dettagli IVA

Puoi scegliere di includere attributi relativi a VCS nei report sugli ordini.

Utilizza la procedura seguente per includere gli attributi relativi al VCS nei report sugli ordini:

  1. Vai su Aggiungere o rimuovere le colonne del report sugli ordini in Seller Central.

  2. Aggiungi il VAT details colonna.

Dopo aver completato questa procedura, le seguenti colonne vengono aggiunte ai report sugli ordini: Item price VAT exclusive, Shipping price VAT exclusive, e Gift wrap price VAT exclusive.

Report sugli ordini di Logistica di Amazon

Rapporti sugli ordini FBA richiesti dopo ti iscrivi a VCS appaiono come segue:

  • ItemTax (nei report XML) e item_tax (nei report in formato flat file). Contiene l'importo dell'IVA, calcolato da Amazon.
  • ItemPrice (nei report XML) e item_price (nei report in formato flat file). Contiene l'importo IVA esclusa (modificato rispetto all'importo IVA inclusa).

L'importo IVA inclusa è il prezzo dell'articolo più l'imposta sull'articolo.

Usa i dati di calcolo delle imposte di Amazon per creare fatture

Puoi usare solo questa opzione con l'API Selling Partner (SP-API) e devi utilizzare i dati fiscali forniti da Amazon per creare le tue fatture.

Passaggio 1. Estrai i dati di calcolo delle imposte per tutti i tuoi ordini dal report sui dati delle fatture IVA (VIDR).

Il VIDR è un report che contiene i dettagli del calcolo delle imposte a livello di transazione ed è disponibile solo per i venditori che si sono iscritti a VCS. Questo report contiene tutte le informazioni necessarie per generare una fattura IVA accurata per ogni spedizione, sia essa gestita dal venditore o gestita da Amazon (FBA). Un ordine è disponibile in questo report subito dopo il completamento della spedizione.

Usa il createReport operazione con GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT o GET_XML_VAT_INVOICE_DATA_REPORT tipo di rapporto (reportType).

reportOptions + pendingInvoices - all.

  • pendingInvoices: Un valore booleano. Quando no ReportOption il parametro è specificato, il valore predefinito è ReportOption=PendingInvoices. Esempio: "reportOptions": {"ReportOption=pendingInvoices": "true"}

    • Quando true, il report contiene solo le spedizioni per le quali sono pendenti fatture e note di credito. Questo rapporto non contiene spedizioni per le quali le fatture sono già state caricate correttamente. Sono incluse le spedizioni per ordini effettuati nei 90 giorni precedenti.
    • Quando false (o se PendingInvoices non è incluso in ReportOptions), il contenuto del rapporto dipende dal valore di all.

    Questi report includono i dettagli della spedizione per gli ordini spediti con date degli ordini negli ultimi 90 giorni, per i quali le fatture sono dovute e devono essere caricate (tutte le spedizioni in cui lo stato della fattura è InvoicePending o CreditNotePending). I report con questa opzione non includono le spedizioni per le quali le fatture sono già state caricate correttamente. Lo scopo di questa opzione è consentire al venditore di scorrere tutte le voci e creare fatture, senza dover applicare la propria logica aziendale.

  • all: Un valore booleano. L'impostazione predefinita è. Esempio: "reportOptions": {"ReportOption=All": "true"}

    • Quando true, il report contiene le spedizioni per gli ordini effettuati entro l'intervallo di date specificato. Ciò include le spedizioni di tutti gli stati di fattura possibili. È necessario specificare il startDate e endDate parametri per createReport operazione. Le dataStartTime e dataEndTime i valori devono corrispondere al primo e all'ultimo giorno validi nel periodo specificato reportPeriod. Ad esempio, quando reportPeriod=WEEK, dataStartTime deve essere una domenica e dataEndTime deve essere un sabato. L'intervallo di date massimo consentito è di 30 giorni.
    • Quando false, o se all non è incluso in reportOptions, il contenuto del rapporto dipende dal valore di pendingInvoices. Il valore predefinito è "pendingInvoices" : "true".

    Questi report includono le spedizioni per tutte le possibili InvoiceStatus valori. Ciò include:

    • Spedizioni con InvoiceStatus=InvoiceCreatedByAmazon. Amazon emette una fattura per questa transazione, quindi il venditore non è tenuto a caricare una fattura.
    • Transazioni con InvoiceStatus=NoTaxCalculated. Amazon non ha eseguito il calcolo delle imposte per questa transazione. Ciò accade, ad esempio, quando l'articolo viene spedito da un paese per il quale il venditore non ha fornito un numero di partita IVA valido su Seller Central.

Puoi determinare quando pianifica questi report. Per rispettare lo SLA di 24 ore, puoi creare una pianificazione ogni 12 ore. Ciò garantisce un ritardo massimo di 12 ore dopo la spedizione di una spedizione.

Una fattura è dovuta per ogni spedizione (non per ogni ordine) dopo la spedizione della spedizione. Una spedizione può avere uno dei seguenti stati:

Stato della fatturaDescrizioneAction required
InvoicePendingLa spedizione è stata effettuata.Il venditore deve caricare una fattura per la spedizione.
InvoiceProcessingIl venditore ha caricato la fattura e Amazon la sta elaborando.In questo momento non è richiesta alcuna azione da parte del venditore. Amazon elaborerà la fattura.
InvoiceUploadedIl venditore ha caricato la fattura e Amazon ha terminato l'elaborazione. Non è stato rilevato alcun errore.Non è richiesta alcuna azione da parte del venditore. La fattura è stata caricata correttamente ed è disponibile per il cliente nella pagina I tuoi ordini. I clienti possono scaricare la fattura in qualsiasi momento.
InvoiceRejectedIl venditore ha caricato la fattura e Amazon ha terminato l'elaborazione. Sono stati rilevati errori nel caricamento.Il venditore deve caricare nuovamente la fattura per questa spedizione.
CreditNotePendingIn caso di rimborso, il denaro è stato restituito all'acquirente. In caso di reso, l'articolo è stato ricevuto nel Centro logistico di Amazon per gli ordini Logistica di Amazon o è stato autorizzato dal venditore per gli ordini gestiti dal venditore.La nota di credito è ora necessaria per questa transazione.
CreditNoteProcessingIl venditore ha caricato la fattura e Amazon la sta elaborando.In questo momento non è richiesta alcuna azione da parte del venditore. Amazon elaborerà la nota di credito.
CreditNoteUploadedIl venditore ha caricato la nota di credito e Amazon ha terminato l'elaborazione. Non è stato rilevato alcun errore.Non è richiesta alcuna azione da parte del venditore. Nota di credito caricata con successo e messa a disposizione del cliente sulla pagina I tuoi ordini.
CreditNoteRejectedIl venditore ha caricato la nota di credito e Amazon ha terminato l'elaborazione. Sono stati rilevati errori nel caricamento.Il venditore deve caricare nuovamente la nota di credito per questa transazione.
CreditNoteCreatedByAmazonAmazon ha creato una nota di credito per questa transazione.Non è richiesta alcuna azione da parte del venditore.
NoTaxCalculatedAmazon non è riuscito a calcolare alcuna imposta per questa transazione. Questo di solito accade quando il venditore non ha caricato un numero di partita IVA per il paese da cui è stata spedita la spedizione.Amazon non calcolerà l'IVA e il venditore deve caricare la fattura per questa transazione. Il venditore può caricare la fattura in Seller Central o con SP-API.
InvoiceCreatedByAmazonAmazon ha creato una fattura per questa transazione.Non è richiesta alcuna azione da parte del venditore.

Colonne VIDR

Rapporto di esempio VIDRReport link
XMLCSV

La tabella seguente spiega ogni colonna VIDR:

Nome del campoDefinizioneEsempio
order-idL'identificativo unico dell'ordine di Amazon. Utilizzato per la conferma della spedizione e l'elaborazione post-ordine.736-3563777-5518068
order-item-idL'identificativo unico dell'articolo dell'ordine di Amazon. Utilizzato per la conferma della spedizione e l'elaborazione post-ordine.583563777345
shipping-idID di spedizione per questa spedizione.409302382
fulfilled-byIl canale di gestione per questo ordine.MFN or FBA
order-dateData in cui è stato effettuato l'ordine.17/05/2018
marketplace-idIl marketplace in cui è stato effettuato l'ordine.DE, FR, IT, ES
recipient-nameNome del destinatario.Mary Major
buyer-nameNome dell'acquirente.Diego Ramirez
ship-service-levelLivello di servizio di gestione pagato dall'acquirente al momento dell'ordine dell'articolo. Ad esempio, standard o accelerato.Standard
ship-address-1La prima riga dell'indirizzo di destinazione della spedizione.123 Any Street
ship-address-2Seconda riga dell'indirizzo di destinazione della spedizione.Apt. 12
ship-address-3Terza riga dell'indirizzo di destinazione della spedizione.c/o Example Corp.
ship-cityCittà dell'indirizzo di destinazione della spedizione.Any City
ship-stateStato dell'indirizzo di destinazione della spedizione.Any State
ship-postal-codeCodice postale dell'indirizzo di destinazione della spedizione.SL1 1QP
ship-countryIl codice internazionale del Paese a due lettere (conforme alla norma ISO 3166).DE
ship-phone-numberNumero di telefono dell'indirizzo di spedizione.999999999
shipment-dateData di completamento di questa spedizione.20/05/2018
billing-nameNome di fatturazione.Márcia Oliveira
bill-address-1La prima riga dell'indirizzo di fatturazione.100 Main Street
bill-address-2La seconda riga dell'indirizzo di fatturazione.Apt. 12
bill-address-3La terza riga dell'indirizzo di fatturazione.c/o AnyCompany
bill-cityCittà dell'indirizzo di fatturazione.Any City
bill-stateStato dell'indirizzo di fatturazione.Any State
bill-postal-codeCodice postale dell'indirizzo di fatturazione.U7D 294
bill-countryIl codice internazionale del Paese a due lettere (conforme alla norma ISO 3166).DE
bill-phone-numberNumero di telefono dell'indirizzo di fatturazione.44234343
ship-from-cityCittà dell'indirizzo del mittente della spedizione.Any City
ship-from-stateStato dell'indirizzo del mittente della spedizione.Any State
ship-from-countryPaese dell'indirizzo del mittente della spedizione.DE
ship-from-postal-codeCodice postale dell'indirizzo del mittente della spedizione.10178
skuUnità di stoccaggio. Identificatore univoco definito dal venditore per un prodotto.sku123
product-nameNome del prodotto.DJI CP.PT.03342 Spark - Battery Charging Hub
quantity-purchasedQuantità acquistata1
currencyLa valuta utilizzata per la transazione.EUR
asinASIN del prodotto.AY39345YE8K
item-vat-incl-amountPrezzo dell'articolo IVA inclusa.120.00
item-vat-amountImporto IVA del prezzo dell'articolo.20.00
item-vat-excl-amountPrezzo dell'articolo IVA esclusa.100.00
item-vat-rateAliquota IVA del prezzo dell'articolo.0.20
gift-wrap-vat-incl-amountConfezione regalo con IVA totale inclusa.12.00
gift-wrap-vat-amountImporto IVA totale della confezione regalo.2.00
gift-wrap-vat-excl-amountConfezione regalo con IVA totale esclusa.10.00
gift-wrap-vat-rateAliquota IVA totale del prezzo del regalo.0.20
shipping-vat-incl-amountPrezzo di spedizione IVA inclusa.6.00
shipping-vat-amountImporto IVA del prezzo di spedizione.1.00
shipping-vat-excl-amountPrezzo di spedizione IVA esclusa.5.00
shipping-vat-rateAliquota IVA del prezzo di spedizione.0.20
item-promo-vat-incl-amountPromozione dell'articolo con IVA totale inclusa.-0.12
item-promo-vat-amountPromozione dell'articolo con importo IVA totale.-0.02
item-promo-vat-excl-amountPromozione dell'articolo con IVA totale esclusa.-0.10
item-promo-vat-ratePromozione dell'articolo con aliquota IVA totale.0.20
item-promotion-idID promozione per la promozione dell'articolo. Un valore alfanumerico generato da Amazon.136643052:AKY54VWVKS3JCY6T
shipping-promo-vat-incl-amountPromozione della spedizione con IVA totale inclusa.-0.12
shipping-promo-vat-amountPromozione della spedizione con importo totale dell'IVA.-0.02
shipping-promo-vat-excl-amountPromozione della spedizione con IVA totale esclusa.-0.10
shipping-promo-vat-ratePromozione della spedizione con aliquota IVA totale.0.20
shipping-promotion-idID promozione della promozione di spedizione. Un valore alfanumerico generato da Amazon.3943834723:BWJRJERIUDKERU
gift-promo-vat-incl-amountPromozione della confezione regalo con IVA totale inclusa.-0.20
gift-promo-vat-amountPromozione della confezione regalo con importo dell'IVA totale.-0.12
gift-promo-vat-excl-amountPromozione della confezione regalo con IVA totale esclusa.-0.02
gift-promo-vat-ratePromozione della confezione regalo con aliquota IVA totale.0.10
gift-promotion-idID di promozione della promozione della confezione regalo.385934052:BWJRJDJSDS3JCY6T
transaction-idPer le spedizioni, questo è l'ID di spedizione. Per i resi, si tratta di un ID di transazione univoco diverso dall'ID di spedizione.409302382 (per una spedizione); AMZN1:crow:A0F6KWAFSV6YMALMHE4VJW (per un reso o un rimborso)
transaction-typeIl tipo di transazione.SPEDIZIONE, RESO o RIMBORSO
is-amazon-invoicedIndica se Amazon crea una fattura per questa transazione. Ha valore True se il venditore utilizza VCS e sceglie l'opzione per consentire ad Amazon di creare le fatture o se Amazon World Imports acquista dal venditore. Il venditore non deve creare fatture per queste transazioni. Amazon genererà una fattura e la metterà a disposizione del venditore.TRUE o FALSE
invoice-statusStato della fattura.Fare riferimento a Fase 1 per informazioni sullo stato della fattura.
invoice-status-descriptionDescrizione dello stato della fattura.Fare riferimento a Fase 1 per informazioni sullo stato della fattura.
is-business-orderL'ordine proveniva dal sito Web Amazon Business o dal sito Web B2C?TRUE o FALSE
purchase-order-numberNumero di ordine d'acquisto (se fornito dal cliente).AB45-234934 (can be any string)
seller-vat-numberNumero di partita IVA del venditore utilizzato nel calcolo dell'IVA.DE111111111
buyer-vat-numberNumero di partita IVA dell'acquirente utilizzato nel calcolo dell'IVA.DE22222222 o vuoto se il cliente non ha un numero di partita IVA su Amazon.
buyer-company-nameNome dell'azienda dell'acquirente.Azienda Casuale
price-designationIndica se si tratta del prezzo aziendale o del prezzo standard.Business Price or Standard Price
invoice-numberIl numero della fattura fornito dal venditore. Nel caso di una vista PendingInvoices, la colonna è vuota perché la fattura non è stata caricata. Nel caso di una vista All, la colonna conterrà il numero della fattura caricata dal venditore.XXXX
legacy-customer-order-item-idQuesto ID di articolo dell'ordine è lo stesso che si trova nei report di Rete logistica del venditore (MFN) e di Logistica di Amazon (FBA). Se desideri abbinare le singole voci di un VIDR ai report Logistica di Amazon o MFN, puoi utilizzare questa colonna.82840304120340
buyer-tax-registration-typeIl tipo di imposta del cliente (se il cliente ha un codice fiscale).P.IVA, Registro delle imprese, ID di cittadinanza. Nei marketplace di Spagna e Italia, le aziende possono avere un numero di registrazione delle imprese (BusinessReg) e le persone fisiche possono avere un codice fiscale (CitizenID).
is-buyer-physically-presentVero se il cliente è fisicamente stabilito nel paese per il quale è stato fornito il codice fiscale nel buyer-vat-number colonna.TRUE o FALSE
is-seller-physically-presentVero se il venditore è fisicamente stabilito nel paese per il quale è stato fornito il numero di partita IVA nel seller-vat-number colonna.TRUE o FALSE
buyer-e-invoice-account-idL'ID di account della fattura elettronica del cliente. Viene compilato se il cliente ha fornito un ID di account della fattura elettronica (che può essere utilizzato per inviare la fattura al Sistema di Interscambio (SdI), se necessario). Questa colonna è stata aggiunta specificamente per la legge italiana sulla fatturazione elettronica entrata in vigore nel 2019, in modo che i venditori possano caricare le fatture su SdI.XXXXXXXX
recommended-invoice-formatFormato di fattura consigliato da inviare alle autorità fiscali. Se il valore è PDF, devi caricare il formato PDF della fattura su Amazon e utilizzare lo stesso PDF della vera copia della fattura. Se il formato consigliato è XML, Amazon ha stabilito che il cliente è un cliente B2B nel settore IT e il venditore è fisicamente stabilito nel settore IT, pertanto il venditore deve caricare una fattura XML nel Sistema di Interscambio (SdI) in base alla legge italiana sulla fattura elettronica. La fattura XML disponibile su SdI è considerata la copia autentica della fattura. Tuttavia, devi anche caricare una fattura PDF su Amazon. Il PDF deve contenere testo aggiuntivo o una filigrana per indicare che si tratta di una fattura duplicata. Il cliente può recuperare la fattura originale da SdI. Tieni presente che, indipendentemente dal valore in questa colonna, il venditore deve sempre caricare una fattura PDF su Amazon utilizzando il tipo di feed Invoice Upload.PDF o XML.
Citation-enQuesta colonna fornisce il testo della dicitura in inglese.Consigliamo al venditore di utilizzare il testo della dicitura fornito sulla fattura. Il venditore è libero di scegliere la lingua che desidera utilizzare per la dicitura, a seconda della lingua sulla fattura.
Citation-deQuesta colonna fornisce il testo della dicitura in tedesco.Consigliamo al venditore di utilizzare il testo della dicitura fornito sulla fattura. Il venditore è libero di scegliere la lingua che desidera utilizzare per la dicitura, a seconda della lingua sulla fattura.
Citation-esQuesta colonna fornisce il testo della dicitura in spagnolo.Consigliamo al venditore di utilizzare il testo della dicitura fornito sulla fattura. Il venditore è libero di scegliere la lingua che desidera utilizzare per la dicitura, a seconda della lingua sulla fattura.
Citation-frQuesta colonna fornisce il testo della dicitura in francese.Consigliamo al venditore di utilizzare il testo della dicitura fornito sulla fattura. Il venditore è libero di scegliere la lingua che desidera utilizzare per la dicitura, a seconda della lingua sulla fattura.
Citation-itQuesta colonna fornisce il testo della dicitura in italiano.Consigliamo al venditore di utilizzare il testo della dicitura fornito sulla fattura. Il venditore è libero di scegliere la lingua che desidera utilizzare per la dicitura, a seconda della lingua sulla fattura.
Is-invoice-correctedIndica se questa transazione si riferisce a una precedente fattura corretta. Ha valore True se questa transazione è una correzione di una transazione precedente.TRUE o FALSE
original-vat-invoice-numberIl numero di fattura della spedizione originale che richiede una correzione della fattura.Il numero della fattura originale.
invoice-correction-detailsDettagli di modifica della fattura che descrivono le modifiche sulla fattura. Ciò è applicabile solo per le transazioni di modifica della fattura.Una nuova fattura viene emessa dopo aver modificato l'indirizzo di fatturazione sulla fattura IVA originale; oppure viene emessa una nota di credito per modificare l'indirizzo di fatturazione sulla fattura IVA originale.

Fase 2 Crea le tue fatture dai dati del rapporto VIDR

Scarica il report VIDR e utilizza le informazioni per compilare la tua fattura IVA.

Fase 3 Carica le fatture su Amazon utilizzando l'API Feeds

Chiama l'operazione createFeed per convalidare UPLOAD_VAT_INVOICE e feedType.

Suggerimento

Per ottenere gli ID del marketplace per il tuo Paese, consulta ID del marketplace.

Per feedOptions, è necessario specificare i metadati nelle coppie chiave:valore con la fattura PDF. O OrderId o ShippingId è obbligatorio quando carichi una fattura (ShippingId è preferito).

  • OrderId: L'identificativo dell'ordine per il quale viene inviata la fattura.
  • ShippingId: L'identificativo della spedizione per la quale viene inviata la fattura.

Se includi OrderId e ShippingId, Amazon ignora l'ID dell'ordine e carica la fattura con il numero di spedizione. Se non viene fornito nessuno dei due, potresti ricevere un errore. Per assistenza in caso di errori, consulta Gestione degli errori.

Quanto segue feedOptions siamo necessario:

  • TotalAmount. L'importo totale in fattura. Questo è il prezzo comprensivo di IVA per gli articoli, la confezione regalo e la spedizione, meno l'IVA per tutte le promozioni. Se l'importo totale specificato non corrisponde all'importo totale di Amazon per questa spedizione (con due cifre decimali), il caricamento della fattura viene rifiutato. Ti consigliamo di seguire rigorosamente i calcoli fiscali forniti nel VIDR.
  • TotalVATAmount. L'importo totale dell'IVA sulla fattura. Questa è l'IVA per gli articoli, la confezione regalo e la spedizione, meno l'IVA per tutte le promozioni. Se l'importo dell'IVA non corrisponde all'importo dell'IVA calcolato da Amazon per questa spedizione (con due cifre decimali), il caricamento della fattura viene rifiutato. Ti consigliamo di seguire rigorosamente i calcoli fiscali forniti nel VIDR.
  • InvoiceNumber. Il numero della fattura utilizzato nella fattura. Questo numero di fattura è condiviso con i clienti. I venditori devono assicurarsi che sulla fattura compaia lo stesso numero di fattura.

Quanto segue feedOptions siamo opzionale:

  • DocumentType. Valori possibili:

    • Invoice. Usalo se stai caricando una fattura.
    • CreditNote. Usalo se stai caricando una nota di credito per un rimborso o un reso.
      Il valore predefinito è Invoice.
  • TransactionId è ora un valore per DocumentType=CreditNote.

🚧

Attenzione

Non aggiungere virgolette attorno a chiavi o valori. Amazon accetta solo i seguenti caratteri: virgole (,), barre in avanti (/), barre rovesciate (\), spazi (), trattini (-), trattini bassi (_), punto e virgola (;), due punti (:), hash (#), 0-9, A-Z, a-z. Amazon riduce lo spazio extra.

Il limite di limitazione per il feed di fatturazione (UPLOAD_VAT_INVOICE) è il caricamento di una fattura ogni tre secondi.

Esempi

Caricamento delle fatture:

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}

Note di credito (CN-123-ABC è il numero della nota di credito):

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}

Codice Java per creare le opzioni del feed:

Map<String, String> feedOptions = new HashMap<>(); // building parameter map feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX"); feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT)); feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT)); feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER); String options = feedOptions.entrySet().stream() .map(e -> String.format("%s=%s", e.getKey(), e.getValue())) .collect(Collectors.joining(";")); File pdfD = new File("<PATH TO PDF>"); byte[] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "_UPLOAD_VAT_INVOICE_", options, ContentType.OctetStream); public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType) { SubmitFeedRequest request = new SubmitFeedRequest(); request.setContentMD5(contentMD5); request.setFeedContent(inputStream); request.setFeedOptions(feedOptions); request.setFeedType(feedType); request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces()); request.setMerchant(configuration.getAmazon().getSellerId()); request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken()); request.setContentType(contentType); return getMarketplaceWebServiceClient().submitFeed(request); }

Caricare manualmente le fatture

Tutti i venditori che scelgono non per iscriversi a VCS hanno l'opzione predefinita di caricare le proprie fatture su Amazon utilizzando l'API o Seller Central. Questa sezione descrive l'utilizzo dell'API.

Per caricare manualmente le fatture, è necessario utilizzare i propri dati fiscali per creare le fatture. Lo farai non avere accesso a un rapporto VIDR.

Chiama l'operazione createFeed per convalidare UPLOAD_VAT_INVOICE e feedType.

Suggerimento

Per ottenere gli ID del marketplace per il tuo Paese, consulta ID del marketplace.

Per feedOptions, è necessario specificare i metadati nelle coppie chiave:valore con la fattura PDF. O OrderId o ShippingId è obbligatorio quando carichi una fattura (ShippingId è preferito).

  • OrderId: L'identificativo dell'ordine per il quale viene inviata la fattura.
  • ShippingId: L'identificativo della spedizione per la quale viene inviata la fattura.

Se includi OrderId e ShippingId, Amazon ignora l'ID dell'ordine e carica la fattura con il numero di spedizione. Se non viene fornito nessuno dei due, potresti ricevere un errore. Per assistenza in caso di errori, consulta Gestione degli errori.

Quanto segue feedOptions siamo necessario:

  • InvoiceNumber. Il numero della fattura utilizzato nella fattura. Questo numero di fattura è condiviso con i clienti. I venditori devono assicurarsi che sulla fattura compaia lo stesso numero di fattura.
  • DocumentType. Valori possibili:
    • Invoice. Usalo se stai caricando una fattura.
    • CreditNote. Usalo se stai caricando una nota di credito per un rimborso o un reso.
      Il valore predefinito è Invoice.

Suggerimento

Con i caricamenti manuali, puoi caricare più di una fattura con lo stesso numero d'ordine. Tuttavia, il numero della fattura deve essere univoco. Solo l'ultima fattura è considerata valida.

Quanto segue feedOptions siamo opzionale:

  • TotalAmount. L'importo totale in fattura. Questo è il prezzo comprensivo di IVA per gli articoli, la confezione regalo e la spedizione, meno l'IVA per tutte le promozioni. Se l'importo totale specificato non corrisponde all'importo totale di Amazon per questa spedizione (con due cifre decimali), il caricamento della fattura viene rifiutato. Ti consigliamo di seguire rigorosamente i calcoli fiscali forniti nel VIDR.
  • TotalVATAmount. L'importo totale dell'IVA sulla fattura. Questa è l'IVA per gli articoli, la confezione regalo e la spedizione, meno l'IVA per tutte le promozioni. Se l'importo dell'IVA non corrisponde all'importo dell'IVA calcolato da Amazon per questa spedizione (con due cifre decimali), il caricamento della fattura viene rifiutato. Ti consigliamo di seguire rigorosamente i calcoli fiscali forniti nel VIDR.
  • TransactionId è ora un valore per DocumentType=CreditNote.

🚧

Attenzione

Non aggiungere virgolette attorno a chiavi o valori. Amazon accetta solo i seguenti caratteri: virgole (,), barre in avanti (/), barre rovesciate (\), spazi (), trattini (-), trattini bassi (_), punto e virgola (;), due punti (:), hash (#), 0-9, A-Z, a-z. Amazon riduce lo spazio extra.

Il limite di limitazione per il feed di fatturazione (UPLOAD_VAT_INVOICE) è il caricamento di una fattura ogni tre secondi.

Esempi

Caricamento delle fatture:

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}

Note di credito (CN-123-ABC è il numero della nota di credito):

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}

Puoi utilizzare il seguente codice di esempio per allegare il file PDF. Sebbene questo esempio sia in Java, puoi usarlo come modello per altri linguaggi di programmazione.

Map<String, String> feedOptions = new HashMap<>(); // building parameter map feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX"); feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT)); feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT)); feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER); String options = feedOptions.entrySet().stream() .map(e -\> String.format("%s=%s", e.getKey(), e.getValue())) .collect(Collectors.joining(";")); File pdfD = new File("\<PATH TO PDF\>"); byte\[\] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "\_UPLOAD_VAT_INVOICE\_", options, ContentType.OctetStream); public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType) { SubmitFeedRequest request = new SubmitFeedRequest(); request.setContentMD5(contentMD5); request.setFeedContent(inputStream); request.setFeedOptions(feedOptions); request.setFeedType(feedType); request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces()); request.setMerchant(configuration.getAmazon().getSellerId()); request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken()); request.setContentType(contentType); return getMarketplaceWebServiceClient().submitFeed(request); }

Questa pagina ti è stata utile?