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:
- Consenti ad Amazon di crea e carica automaticamente le tue fatture.
- Usa Dati di calcolo delle tasse di Amazon per creare le tue fatture, quindi caricali manualmente utilizzando SP-API.
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).
API | API Report |
---|---|
Operation | createReport |
ReportType | SC_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) eitem_tax
(nei report in formato flat file). Contiene l'importo dell'IVA, calcolato da Amazon.ItemPrice
(nei report XML) eitem_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:
-
Vai su Aggiungere o rimuovere le colonne del report sugli ordini in Seller Central.
-
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) eitem_tax
(nei report in formato flat file). Contiene l'importo dell'IVA, calcolato da Amazon.ItemPrice
(nei report XML) eitem_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 noReportOption
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 diall
.
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
oCreditNotePending
). 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. - Quando
-
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 ilstartDate
eendDate
parametri percreateReport
operazione. LedataStartTime
edataEndTime
i valori devono corrispondere al primo e all'ultimo giorno validi nel periodo specificatoreportPeriod
. Ad esempio, quandoreportPeriod=WEEK
,dataStartTime
deve essere una domenica edataEndTime
deve essere un sabato. L'intervallo di date massimo consentito è di 30 giorni. - Quando
false
, o seall
non è incluso inreportOptions
, il contenuto del rapporto dipende dal valore dipendingInvoices
. 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.
- Quando
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 fattura | Descrizione | Action required |
---|---|---|
InvoicePending | La spedizione è stata effettuata. | Il venditore deve caricare una fattura per la spedizione. |
InvoiceProcessing | Il 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. |
InvoiceUploaded | Il 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. |
InvoiceRejected | Il 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. |
CreditNotePending | In 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. |
CreditNoteProcessing | Il 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. |
CreditNoteUploaded | Il 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. |
CreditNoteRejected | Il 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. |
CreditNoteCreatedByAmazon | Amazon ha creato una nota di credito per questa transazione. | Non è richiesta alcuna azione da parte del venditore. |
NoTaxCalculated | Amazon 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. |
InvoiceCreatedByAmazon | Amazon ha creato una fattura per questa transazione. | Non è richiesta alcuna azione da parte del venditore. |
Colonne VIDR
La tabella seguente spiega ogni colonna VIDR:
Nome del campo | Definizione | Esempio |
---|---|---|
order-id | L'identificativo unico dell'ordine di Amazon. Utilizzato per la conferma della spedizione e l'elaborazione post-ordine. | 736-3563777-5518068 |
order-item-id | L'identificativo unico dell'articolo dell'ordine di Amazon. Utilizzato per la conferma della spedizione e l'elaborazione post-ordine. | 583563777345 |
shipping-id | ID di spedizione per questa spedizione. | 409302382 |
fulfilled-by | Il canale di gestione per questo ordine. | MFN or FBA |
order-date | Data in cui è stato effettuato l'ordine. | 17/05/2018 |
marketplace-id | Il marketplace in cui è stato effettuato l'ordine. | DE, FR, IT, ES |
recipient-name | Nome del destinatario. | Mary Major |
buyer-name | Nome dell'acquirente. | Diego Ramirez |
ship-service-level | Livello di servizio di gestione pagato dall'acquirente al momento dell'ordine dell'articolo. Ad esempio, standard o accelerato. | Standard |
ship-address-1 | La prima riga dell'indirizzo di destinazione della spedizione. | 123 Any Street |
ship-address-2 | Seconda riga dell'indirizzo di destinazione della spedizione. | Apt. 12 |
ship-address-3 | Terza riga dell'indirizzo di destinazione della spedizione. | c/o Example Corp. |
ship-city | Città dell'indirizzo di destinazione della spedizione. | Any City |
ship-state | Stato dell'indirizzo di destinazione della spedizione. | Any State |
ship-postal-code | Codice postale dell'indirizzo di destinazione della spedizione. | SL1 1QP |
ship-country | Il codice internazionale del Paese a due lettere (conforme alla norma ISO 3166). | DE |
ship-phone-number | Numero di telefono dell'indirizzo di spedizione. | 999999999 |
shipment-date | Data di completamento di questa spedizione. | 20/05/2018 |
billing-name | Nome di fatturazione. | Márcia Oliveira |
bill-address-1 | La prima riga dell'indirizzo di fatturazione. | 100 Main Street |
bill-address-2 | La seconda riga dell'indirizzo di fatturazione. | Apt. 12 |
bill-address-3 | La terza riga dell'indirizzo di fatturazione. | c/o AnyCompany |
bill-city | Città dell'indirizzo di fatturazione. | Any City |
bill-state | Stato dell'indirizzo di fatturazione. | Any State |
bill-postal-code | Codice postale dell'indirizzo di fatturazione. | U7D 294 |
bill-country | Il codice internazionale del Paese a due lettere (conforme alla norma ISO 3166). | DE |
bill-phone-number | Numero di telefono dell'indirizzo di fatturazione. | 44234343 |
ship-from-city | Città dell'indirizzo del mittente della spedizione. | Any City |
ship-from-state | Stato dell'indirizzo del mittente della spedizione. | Any State |
ship-from-country | Paese dell'indirizzo del mittente della spedizione. | DE |
ship-from-postal-code | Codice postale dell'indirizzo del mittente della spedizione. | 10178 |
sku | Unità di stoccaggio. Identificatore univoco definito dal venditore per un prodotto. | sku123 |
product-name | Nome del prodotto. | DJI CP.PT.03342 Spark - Battery Charging Hub |
quantity-purchased | Quantità acquistata | 1 |
currency | La valuta utilizzata per la transazione. | EUR |
asin | ASIN del prodotto. | AY39345YE8K |
item-vat-incl-amount | Prezzo dell'articolo IVA inclusa. | 120.00 |
item-vat-amount | Importo IVA del prezzo dell'articolo. | 20.00 |
item-vat-excl-amount | Prezzo dell'articolo IVA esclusa. | 100.00 |
item-vat-rate | Aliquota IVA del prezzo dell'articolo. | 0.20 |
gift-wrap-vat-incl-amount | Confezione regalo con IVA totale inclusa. | 12.00 |
gift-wrap-vat-amount | Importo IVA totale della confezione regalo. | 2.00 |
gift-wrap-vat-excl-amount | Confezione regalo con IVA totale esclusa. | 10.00 |
gift-wrap-vat-rate | Aliquota IVA totale del prezzo del regalo. | 0.20 |
shipping-vat-incl-amount | Prezzo di spedizione IVA inclusa. | 6.00 |
shipping-vat-amount | Importo IVA del prezzo di spedizione. | 1.00 |
shipping-vat-excl-amount | Prezzo di spedizione IVA esclusa. | 5.00 |
shipping-vat-rate | Aliquota IVA del prezzo di spedizione. | 0.20 |
item-promo-vat-incl-amount | Promozione dell'articolo con IVA totale inclusa. | -0.12 |
item-promo-vat-amount | Promozione dell'articolo con importo IVA totale. | -0.02 |
item-promo-vat-excl-amount | Promozione dell'articolo con IVA totale esclusa. | -0.10 |
item-promo-vat-rate | Promozione dell'articolo con aliquota IVA totale. | 0.20 |
item-promotion-id | ID promozione per la promozione dell'articolo. Un valore alfanumerico generato da Amazon. | 136643052:AKY54VWVKS3JCY6T |
shipping-promo-vat-incl-amount | Promozione della spedizione con IVA totale inclusa. | -0.12 |
shipping-promo-vat-amount | Promozione della spedizione con importo totale dell'IVA. | -0.02 |
shipping-promo-vat-excl-amount | Promozione della spedizione con IVA totale esclusa. | -0.10 |
shipping-promo-vat-rate | Promozione della spedizione con aliquota IVA totale. | 0.20 |
shipping-promotion-id | ID promozione della promozione di spedizione. Un valore alfanumerico generato da Amazon. | 3943834723:BWJRJERIUDKERU |
gift-promo-vat-incl-amount | Promozione della confezione regalo con IVA totale inclusa. | -0.20 |
gift-promo-vat-amount | Promozione della confezione regalo con importo dell'IVA totale. | -0.12 |
gift-promo-vat-excl-amount | Promozione della confezione regalo con IVA totale esclusa. | -0.02 |
gift-promo-vat-rate | Promozione della confezione regalo con aliquota IVA totale. | 0.10 |
gift-promotion-id | ID di promozione della promozione della confezione regalo. | 385934052:BWJRJDJSDS3JCY6T |
transaction-id | Per 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-type | Il tipo di transazione. | SPEDIZIONE, RESO o RIMBORSO |
is-amazon-invoiced | Indica 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-status | Stato della fattura. | Fare riferimento a Fase 1 per informazioni sullo stato della fattura. |
invoice-status-description | Descrizione dello stato della fattura. | Fare riferimento a Fase 1 per informazioni sullo stato della fattura. |
is-business-order | L'ordine proveniva dal sito Web Amazon Business o dal sito Web B2C? | TRUE o FALSE |
purchase-order-number | Numero di ordine d'acquisto (se fornito dal cliente). | AB45-234934 (can be any string) |
seller-vat-number | Numero di partita IVA del venditore utilizzato nel calcolo dell'IVA. | DE111111111 |
buyer-vat-number | Numero 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-name | Nome dell'azienda dell'acquirente. | Azienda Casuale |
price-designation | Indica se si tratta del prezzo aziendale o del prezzo standard. | Business Price or Standard Price |
invoice-number | Il 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-id | Questo 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-type | Il 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-present | Vero 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-present | Vero 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-id | L'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-format | Formato 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-en | Questa 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-de | Questa 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-es | Questa 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-fr | Questa 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-it | Questa 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-corrected | Indica 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-number | Il numero di fattura della spedizione originale che richiede una correzione della fattura. | Il numero della fattura originale. |
invoice-correction-details | Dettagli 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 perDocumentType=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 perDocumentType=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);
}
Updated 28 days ago