Création et téléchargement de factures
Découvrez comment créer et télécharger des factures avec et sans inscription au VCS.
Après votre inscription à VCS, deux options s'offrent à vous pour créer et télécharger des factures :
- Autoriser Amazon à créez et téléchargez automatiquement vos factures.
- Utiliser Données de calcul des taxes Amazon pour créer vos propres factures, puis téléchargez-les manuellement à l'aide de SP-API.
Si vous ne souhaitez pas utiliser VCS, vous pouvez utiliser vos propres données fiscales pour créer des factures, puis les charger manuellement via SP-API ou via Seller Central. Pour obtenir des instructions sur l'utilisation de cette méthode, reportez-vous à Charger manuellement les factures.
Astuce
Ne fournissez pas d'informations sur les versements du vendeur sur les factures, car cela pourrait semer la confusion chez les clients. Amazon collecte les paiements directement auprès des clients et reverse le montant aux vendeurs.
Pour plus d'informations sur les exigences de conformité et les corrections des factures, reportez-vous à Conformité et correction des factures VCS.
Autorisez Amazon à créer des factures pour vous
Cette option est disponible pour tous les vendeurs qui s'inscrivent au service de calcul de la TVA (VCS) et qui sélectionnent le I want Amazon to generate invoices on my behalf option pour accéder au rapport de calcul de la TVA d'Amazon. Ce rapport contient des informations utiles sur les commandes VCS, notamment : le numéro de facture, le lien vers la facture, la TVA de l'acheteur et les informations d'expédition et de destination. Les commandes sont disponibles dans ce rapport trois jours après leur expédition. Utilisez les informations du tableau suivant pour demander le rapport VCS à l'aide de l'API Selling Partner (SP-API).
API | API Rapports |
---|---|
Operation | createReport |
ReportType | SC_VAT_TAX_REPORT |
Le programme du service de calcul de la TVA affecte le contenu des rapports suivants :
les rapports sur les commandes ;
Inclure le montant de la TVA
Rapports de commande que vous demandez après vous vous inscrivez à VCS et apparaissent comme suit :
ItemTax
(dans les rapports XML) etitem_tax
(dans des rapports à dossier plat). Contient le montant de la TVA, calculé par Amazon.ItemPrice
(dans les rapports XML) etitem_price
(dans des rapports à dossier plat). Contient le prix avec TVA incluse.
Le montant hors TVA correspond au prix de l'article moins la taxe sur l'article.
Remarque
Lorsque la taxe sur les articles est nulle, une TVA de 0 % a été facturée pour la transaction. Cela peut se produire dans plusieurs circonstances. Les exemples incluent les transactions internationales et les transactions transfrontalières B2B dans l'UE. Pour plus d'informations, reportez-vous à Méthodologie de calcul VCS.
Inclure les détails de la TVA
Vous pouvez choisir d'inclure des attributs liés au service de calcul de la TVA dans vos rapports de commande.
Utilisez la procédure suivante pour inclure des attributs liés au service de calcul de la TVA dans les rapports de commande :
-
Accédez à la section Ajouter ou supprimer des colonnes du rapport de commande dans Seller Central.
-
Ajoutez le VAT details colonne.
Une fois cette procédure terminée, les colonnes suivantes sont ajoutées à vos rapports de commande : Item price VAT exclusive, Shipping price VAT exclusive, et Gift wrap price VAT exclusive.
Rapports de commande Expédié par Amazon
Rapports de commande FBA que vous demandez après vous vous inscrivez à VCS et apparaissent comme suit :
ItemTax
(dans les rapports XML) etitem_tax
(dans des rapports à dossier plat). Contient le montant de la TVA, calculé par Amazon.ItemPrice
(dans les rapports XML) etitem_price
(dans des rapports à dossier plat). Contient le montant hors TVA (modifié par rapport au montant TVA incluse).
Le montant incluant la TVA correspond au prix de l'article plus la taxe sur l'article.
Utiliser les données de calcul des taxes d'Amazon pour créer des factures
Vous ne pouvez utiliser que cette option avec l'API Selling Partner (SP-API) et vous devez utiliser les données fiscales fournies par Amazon pour créer vos factures.
Étape 1 : Extraire les données de calcul des taxes de toutes vos commandes à partir du rapport de données de facturation de la TVA.
Le rapport de données de facturation de la TVA contient les détails du calcul des taxes au niveau de la transaction et est uniquement disponible pour les vendeurs qui se sont inscrits au service de calcul de la TVA. Il contient toutes les informations nécessaires pour générer une facture de TVA précise pour chaque expédition, qu'elle soit expédiée par le Vendeur ou Expédié par Amazon. Une commande est ajoutée à ce rapport directement après son expédition.
Utilisez le createReport
opération avec le GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT
ou GET_XML_VAT_INVOICE_DATA_REPORT
type de rapport (reportType
).
reportOptions
+ pendingInvoices
- all
.
-
pendingInvoices
: valeur booléenne. Quand nonReportOption
le paramètre est spécifié, la valeur par défaut estReportOption=PendingInvoices
. Exemple :"reportOptions": {"ReportOption=pendingInvoices": "true"}
- Quand
true
, le rapport contient uniquement les envois pour lesquels des factures et des notes de crédit sont en attente. Ce rapport ne contient pas les envois pour lesquels les factures ont déjà été chargées avec succès. Cela inclut les expéditions pour les commandes passées au cours des 90 jours précédents. - Quand
false
(ou si PendingInvoices n'est pas inclus dans ReportOptions), le contenu du rapport dépend de la valeur deall
.
Ces rapports incluent les détails d'expédition des commandes expédiées dont la date de commande remonte aux 90 derniers jours, pour lesquelles les factures sont dues et doivent être téléchargées (toutes les expéditions dont le statut de la facture est
InvoicePending
ouCreditNotePending
). Les rapports dotés de cette option n'incluent pas les envois pour lesquels les factures ont déjà été chargées avec succès. Le but de cette option est de permettre au vendeur de parcourir tous les articles et de créer des factures, sans avoir à appliquer sa propre logique commerciale. - Quand
-
all
: valeur booléenne. La valeur par défaut est. Exemple :"reportOptions": {"ReportOption=All": "true"}
- Quand
true
, le rapport contient les expéditions pour les commandes passées dans la plage de dates que vous avez spécifiée. Cela inclut les expéditions avec tous les statuts de facturation possibles. Vous devez spécifierstartDate
etendDate
paramètres pourcreateReport
opération. LedataStartTime
etdataEndTime
les valeurs doivent correspondre aux premier et dernier jours valides de la période spécifiéereportPeriod
. Par exemple, lorsquereportPeriod=WEEK
,dataStartTime
doit être un dimanche etdataEndTime
ça doit être un samedi. La plage de dates maximale autorisée est de 30 jours. - Quand
false
, ou siall
n'est pas inclus dansreportOptions
, le contenu du rapport dépend de la valeur dependingInvoices
. La valeur par défaut est"pendingInvoices" : "true"
.
Ces rapports incluent les expéditions dans la mesure du possible
InvoiceStatus
valeurs. Cela inclut :- Envois avec
InvoiceStatus=InvoiceCreatedByAmazon
. Amazon émet une facture pour cette transaction. Le vendeur n'est donc pas obligé de télécharger une facture. - Transactions avec
InvoiceStatus=NoTaxCalculated
. Amazon n'a pas calculé les taxes pour cette transaction. Cela se produit, par exemple, lorsque l'article est expédié depuis un pays pour lequel le vendeur n'a pas fourni de numéro de TVA valide sur Seller Central.
- Quand
Vous pouvez déterminer quand programmez ces rapports. Pour respecter le SLA de 24 heures, vous pouvez créer un planning toutes les 12 heures. Cela garantit un délai maximum de 12 heures après l'expédition d'un envoi.
Une facture est due pour chaque envoi (et non pour chaque commande) après l'expédition de l'envoi. Un envoi peut avoir l'un des statuts suivants :
Statut de la facture | Description | Action required |
---|---|---|
InvoicePending | L'expédition a été effectuée. | Le vendeur doit charger une facture pour l'expédition. |
InvoiceProcessing | Le vendeur a chargé la facture et Amazon est en train de la traiter. | Aucune action n'est requise de la part du vendeur à ce stade. Amazon doit traiter la facture. |
InvoiceUploaded | Le vendeur a chargé la facture et Amazon a terminé de la traiter. Aucune erreur n'a été détectée. | Aucune action n'est requise de la part du vendeur. La facture a été chargée avec succès et est disponible pour le client sur la page Vos commandes. Les clients peuvent télécharger la facture à tout moment. |
InvoiceRejected | Le vendeur a chargé la facture et Amazon a terminé de la traiter. Des erreurs ont été détectées lors du chargement. | Le vendeur doit charger à nouveau la facture pour cette expédition. |
CreditNotePending | En cas de remboursement, l'argent est remboursé à l'acheteur. Dans le cas d'un retour, l'article est reçu par le centre de distribution d'Amazon pour les commandes Expédié par Amazon ou est validé par le vendeur pour les commandes Expédié par le Vendeur. | La note de crédit est maintenant due pour cette transaction. |
CreditNoteProcessing | Le vendeur a chargé la facture et Amazon est en train de la traiter. | Aucune action n'est requise de la part du vendeur à ce stade. Amazon doit traiter la note de crédit. |
CreditNoteUploaded | Le vendeur a chargé la note de crédit et Amazon a terminé de la traiter. Aucune erreur n'a été détectée. | Aucune action n'est requise de la part du vendeur. La note de crédit a été chargée avec succès et est disponible pour le client sur la page Vos commandes. |
CreditNoteRejected | Le vendeur a chargé la note de crédit et Amazon a terminé de la traiter. Des erreurs ont été détectées lors du chargement. | Le vendeur doit à nouveau charger la note de crédit pour cette transaction. |
CreditNoteCreatedByAmazon | Amazon a créé une note de crédit pour cette transaction. | Aucune action n'est requise de la part du vendeur. |
NoTaxCalculated | Amazon n'a pu calculer aucune taxe pour cette transaction. Cela se produit généralement lorsque le vendeur n'a pas téléchargé de numéro de TVA pour le pays à partir duquel l'envoi a été expédié. | Amazon ne calculera pas la TVA et le vendeur doit télécharger la facture pour cette transaction. Le vendeur peut télécharger la facture dans Seller Central ou via SP-API. |
InvoiceCreatedByAmazon | Amazon a créé une facture pour cette transaction. | Aucune action n'est requise de la part du vendeur. |
Colonnes du rapport de données de facturation de la TVA
Le tableau suivant explique chaque colonne du rapport de données de facturation de la TVA :
Nom du champ | Définition | Exemple |
---|---|---|
order-id | Ce champ correspond au numéro de commande unique d'Amazon. Il est utilisé pour confirmer l'expédition et le traitement après la commande. | 736-3563777-5518068 |
order-item-id | Ce champ correspond à l'identifiant unique de l'article Amazon commandé. Il est utilisé pour confirmer l'expédition et le traitement après la commande. | 583563777345 |
shipping-id | Ce champ correspond au numéro d'expédition de cette expédition. | 409302382 |
fulfilled-by | Ce champ correspond au canal de traitement de cette commande. | MFN or FBA |
order-date | Ce champ correspond à la date à laquelle la commande a été passée. | 17/05/2018 |
marketplace-id | Ce champ correspond au site de vente sur lequel la commande a été passée. | DE, FR, IT, ES |
recipient-name | Ce champ correspond au nom du destinataire. | Mary Major |
buyer-name | Ce champ correspond au nom de l'acheteur | Diego Ramirez |
ship-service-level | Ce champ correspond au niveau de service d'expédition payé par l'acheteur lors de la commande de l'article. Par exemple, standard ou accéléré. | Standard |
ship-address-1 | Ce champ correspond à la première ligne de l'adresse de destination. | 123 Any Street |
ship-address-2 | Ce champ correspond à la deuxième ligne de l'adresse de destination. | Apt. 12 |
ship-address-3 | Ce champ correspond à la troisième ligne de l'adresse de destination. | c/o Example Corp. |
ship-city | Ce champ correspond à la ville de l'adresse de destination. | Any City |
ship-state | Ce champ correspond à l'État de l'adresse de destination. | Any State |
ship-postal-code | Ce champ correspond au code postal de l'adresse de destination. | SL1 1QP |
ship-country | Ce champ correspond au code de pays international standard à deux lettres (conforme à la norme ISO 3166). | DE |
ship-phone-number | Ce champ correspond au numéro de téléphone de l'adresse de livraison. | 999999999 |
shipment-date | Ce champ correspond à la date d'expédition de cet envoi. | 20/05/2018 |
billing-name | Ce champ correspond au nom de facturation. | Márcia Oliveira |
bill-address-1 | Ce champ correspond à la première ligne de l'adresse de facturation. | 100 Main Street |
bill-address-2 | Ce champ correspond à la deuxième ligne de l'adresse de facturation. | Apt. 12 |
bill-address-3 | Ce champ correspond à la troisième ligne de l'adresse de facturation. | c/o AnyCompany |
bill-city | Ce champ correspond à la ville de l'adresse de facturation. | Any City |
bill-state | Ce champ correspond à l'État de l'adresse de facturation. | Any State |
bill-postal-code | Ce champ correspond au code postal de l'adresse de facturation. | U7D 294 |
bill-country | Ce champ correspond au code de pays international standard à deux lettres (conforme à la norme ISO 3166). | DE |
bill-phone-number | Ce champ correspond au numéro de téléphone de l'adresse de facturation. | 44234343 |
ship-from-city | Ce champ correspond à la ville de l'adresse d'origine. | Any City |
ship-from-state | Ce champ correspond à l'État de l'adresse d'origine. | Any State |
ship-from-country | Ce champ correspond au pays de l'adresse d'origine. | DE |
ship-from-postal-code | Ce champ correspond au code postal de l'adresse d'origine. | 10178 |
sku | Ce champ correspond à l'unité de gestion des stocks : l'dentifiant unique défini par le vendeur pour un produit. | sku123 |
product-name | Ce champ correspond au nom du produit | DJI CP.PT.03342 Spark - Battery Charging Hub |
quantity-purchased | Ce champ correspond à la quantité achetée. | 1 |
currency | Ce champ correspond à la devise utilisée pour la transaction. | EUR |
asin | Ce champ correspond à l'ASIN du produit. | AY39345YE8K |
item-vat-incl-amount | Ce champ correspond au prix de l'article, TVA incluse. | 120.00 |
item-vat-amount | Ce champ correspond au montant de la TVA sur le prix de l'article. | 20.00 |
item-vat-excl-amount | Ce champ correspond au prix de l'article hors TVA. | 100.00 |
item-vat-rate | Ce champ correspond au taux de TVA sur le prix de l'article. | 0.20 |
gift-wrap-vat-incl-amount | Ce champ correspond au montant total de l'emballage cadeau, TVA incluse. | 12.00 |
gift-wrap-vat-amount | Ce champ correspond au montant total de la TVA sur l'emballage cadeau. | 2.00 |
gift-wrap-vat-excl-amount | Ce champ correspond au montant total de l'emballage cadeau, hors TVA. | 10.00 |
gift-wrap-vat-rate | Ce champ correspond au taux de TVA total sur le prix du cadeau. | 0.20 |
shipping-vat-incl-amount | Ce champ correspond au prix d'expédition, TVA incluse. | 6.00 |
shipping-vat-amount | Ce champ correspond au montant de la TVA sur le prix d'expédition. | 1.00 |
shipping-vat-excl-amount | Ce champ correspond au prix d'expédition hors TVA. | 5.00 |
shipping-vat-rate | Ce champ correspond au taux de TVA sur le prix d'expédition. | 0.20 |
item-promo-vat-incl-amount | Ce champ correspond au montant total de la promotion de l'article, TVA incluse. | -0.12 |
item-promo-vat-amount | Ce champ correspond au montant total de la TVA de la promotion de l'article. | -0.02 |
item-promo-vat-excl-amount | Ce champ correspond au montant total de la promotion de l'article, hors TVA. | -0.10 |
item-promo-vat-rate | Ce champ correspond au taux total de la TVA sur de la promotion de l'article. | 0.20 |
item-promotion-id | Numéro de promotion pour la promotion de l'article. Valeur alphanumérique générée par Amazon. | 136643052:AKY54VWVKS3JCY6T |
shipping-promo-vat-incl-amount | Ce champ correspond au montant total de la promotion des frais d'expédition, TVA incluse. | -0.12 |
shipping-promo-vat-amount | Ce champ correspond au montant total de la TVA de la promotion des frais d'expédition. | -0.02 |
shipping-promo-vat-excl-amount | Ce champ correspond au montant total de la promotion des frais d'expédition, hors TVA. | -0.10 |
shipping-promo-vat-rate | Ce champ correspond au taux total de la TVA de la promotion des frais d'expédition. | 0.20 |
shipping-promotion-id | Numéro de promotion de la promotion d'expédition. Valeur alphanumérique générée par Amazon. | 3943834723:BWJRJERIUDKERU |
gift-promo-vat-incl-amount | Ce champ correspond au montant total de la promotion de l'emballage cadeau, TVA incluse. | -0.20 |
gift-promo-vat-amount | Ce champ correspond au montant total de la TVA de la promotion de l'emballage cadeau. | -0.12 |
gift-promo-vat-excl-amount | Ce champ correspond au montant total de la promotion de l'emballage cadeau, hors TVA. | -0.02 |
gift-promo-vat-rate | Ce champ correspond au taux total de la TVA de la promotion de l'emballage cadeau. | 0.10 |
gift-promotion-id | Ce champ correspond à l'identifiant de la promotion de l'emballage cadeau. | 385934052:BWJRJDJSDS3JCY6T |
transaction-id | Pour les envois, il s'agit du numéro d'expédition. Pour les retours, il s'agit d'un numéro de transaction unique qui diffère du numéro d'expédition. | 409302382 (pour un envoi) ; AMZN1:Crow:A0F6KWAFSv6YMalmHe4VJW (pour un retour ou un remboursement) |
transaction-type | Type de transaction. | EXPÉDITION, RETOUR OU REMBOURSEMENT |
is-amazon-invoiced | Indique si Amazon crée une facture pour cette transaction. La valeur est True si le vendeur utilise le service de calcul de la TVA et choisit l'option permettant à Amazon de créer les factures, ou si Amazon World Imports effectue des achats auprès du vendeur. Le vendeur n'a pas besoin de créer de factures pour ces transactions, Amazon s'en charge pour lui et la met à la disposition du vendeur. | TRUE ou FALSE |
invoice-status | État de la facture. | Reportez-vous à Étape 1 pour plus de détails sur le statut de la facture. |
invoice-status-description | Description du statut de la facture. | Reportez-vous à Étape 1 pour plus de détails sur le statut de la facture. |
is-business-order | Ce champ indique si cette commande provient du site Web d'Amazon Business ou du site Web B2C. | TRUE ou FALSE |
purchase-order-number | Ce champ correspond au numéro de bon de commande (s'il a été fourni par le client). | AB45-234934 (can be any string) |
seller-vat-number | Ce champ correspond au numéro d'immatriculation à la TVA du vendeur utilisé pour le calcul de la TVA. | DE111111111 |
buyer-vat-number | Ce champ correspond au numéro d'immatriculation à la TVA de l'acheteur utilisé pour le calcul de la TVA. | DE22222222 ou vide si le client ne dispose pas de numéro d'immatriculation à la TVA sur Amazon. |
buyer-company-name | Ce champ correspond au nom de l'entreprise de l'acheteur. | ExempleEntreprise |
price-designation | Ce champ indique s'il s'agit d'un prix professionnel ou d'un prix standard. | Business Price or Standard Price |
invoice-number | Ce champ correspond au numéro de facture fourni par le vendeur. Dans le cas d'un affichage PendingInvoices , la colonne est vide, car la facture n'a pas été chargée. Dans le cas d'un affichage All , la colonne contiendra le numéro de facture chargé par le vendeur. | XXXX |
legacy-customer-order-item-id | Cet identifiant d'article de commande est le même que celui qui figure dans les rapports Expédié par Amazon et Expédié par le Vendeur. Si vous souhaitez faire correspondre les différents articles d'un rapport de données de facturation de la TVA avec ceux des rapports Expédié par Amazon ou Expédié par le Vendeur, vous pouvez utiliser cette colonne. | 82840304120340 |
buyer-tax-registration-type | Ce champ correspond au type de taxe du client (si le client possède un numéro d'immatriculation fiscale). | TVA, BusinessReg, CitizenID. Sur les places de marché espagnoles et italiennes, les entreprises peuvent avoir un numéro d'enregistrement commercial (BusinessReg) et les particuliers peuvent avoir un numéro d'identification fiscale (CitizenID). |
is-buyer-physically-present | Vrai si le client est physiquement établi dans le pays pour lequel le numéro fiscal a été fourni dans le buyer-vat-number colonne. | TRUE ou FALSE |
is-seller-physically-present | Vrai si le vendeur est physiquement établi dans le pays pour lequel le numéro de TVA a été fourni dans le seller-vat-number colonne. | TRUE ou FALSE |
buyer-e-invoice-account-id | Ce champ correspond à l'identifiant du compte de facturation électronique du client. Il est complété si le client a fourni un numéro de compte de facturation électronique (qui peut être utilisé pour envoyer la facture au Sistema di Interscambio (SDI), si nécessaire). Cette colonne est spécifiquement ajoutée conformément à la loi italienne sur la facturation électronique entrée en vigueur en 2019, afin que les vendeurs puissent télécharger des factures sur le SDI. | XXXXXXXX |
recommended-invoice-format | Format de facture recommandé à soumettre aux autorités fiscales. Si la valeur est PDF, vous devez télécharger le format de facture PDF sur Amazon et utiliser le même PDF comme copie authentique de la facture. Si le format recommandé est XML, Amazon a déterminé que le client est un client B2B dans le secteur informatique et que le vendeur est physiquement établi dans le secteur informatique. Le vendeur doit donc télécharger une facture XML dans Sistema di Interscambio (SDi) conformément à la loi italienne sur la facture électronique. La facture XML disponible sur SDi est considérée comme la copie conforme de la facture. Cependant, vous devez également télécharger une facture au format PDF sur Amazon. Le PDF doit contenir du texte supplémentaire ou un filigrane pour indiquer qu'il s'agit d'une facture dupliquée. Le client peut récupérer la facture originale auprès de SDi. Notez que, quelle que soit la valeur de cette colonne, le vendeur doit toujours télécharger une facture PDF sur Amazon en utilisant le type de flux Invoice Upload. | PDF ou XML. |
Citation-en | Cette colonne fournit le texte de la citation en anglais. | Nous recommandons aux vendeurs d'utiliser le texte de citation figurant sur la facture. Toutefois, ce dernier est libre de choisir la langue qu'il souhaite utiliser pour celle-ci, en fonction de la langue de la facture. |
Citation-de | Cette colonne fournit le texte de la citation en allemand. | Nous recommandons aux vendeurs d'utiliser le texte de citation figurant sur la facture. Toutefois, ce dernier est libre de choisir la langue qu'il souhaite utiliser pour celle-ci, en fonction de la langue de la facture. |
Citation-es | Cette colonne fournit le texte de la citation en espagnol. | Nous recommandons aux vendeurs d'utiliser le texte de citation figurant sur la facture. Toutefois, ce dernier est libre de choisir la langue qu'il souhaite utiliser pour celle-ci, en fonction de la langue de la facture. |
Citation-fr | Cette colonne fournit le texte de la citation en français. | Nous recommandons aux vendeurs d'utiliser le texte de citation figurant sur la facture. Toutefois, ce dernier est libre de choisir la langue qu'il souhaite utiliser pour celle-ci, en fonction de la langue de la facture. |
Citation-it | Cette colonne fournit le texte de la citation en italien. | Nous recommandons aux vendeurs d'utiliser le texte de citation figurant sur la facture. Toutefois, ce dernier est libre de choisir la langue qu'il souhaite utiliser pour celle-ci, en fonction de la langue de la facture. |
Is-invoice-corrected | Ce champ indique si cette transaction fait référence à une facture précédente corrigée. La valeur est True si cette transaction correspond à une version corrigée d'une transaction précédente. | TRUE ou FALSE |
original-vat-invoice-number | Le numéro de facture de l'expédition d'origine qui nécessite une correction de facture. | Le numéro de facture d'origine. |
invoice-correction-details | Ce champ décrit en détail les modifications apportées à la facture. Il s'applique uniquement à la transaction de modification de facture. | Une nouvelle facture est émise après modification de l'adresse de facturation figurant sur la facture TVA d'origine ; ou une note de crédit est émise pour modifier l'adresse de facturation sur la facture TVA d'origine. |
Étape 2 Créez vos propres factures à partir des données du rapport VIDR
Téléchargez le rapport de données de facturation de la TVA et utilisez les informations pour constituer votre facture de TVA.
Étape 3 Téléchargez des factures sur Amazon à l'aide de l'API Feeds
Appelez l'opération createFeed
pour valider UPLOAD_VAT_INVOICE
et feedType
.
Astuce
Pour obtenir les identifiants de la place de marché de votre pays, consultez Identifiants Marketplace.
Pour feedOptions
, vous devez spécifier les métadonnées sous forme de paires clé:valeur avec la facture PDF. Soit OrderId
ou ShippingId
est obligatoire lorsque vous chargez une facture (ShippingId
est préférable).
OrderId
: identifiant de la commande pour laquelle la facture est envoyée.ShippingId
: identifiant de l'expédition pour laquelle la facture est soumise.
Si vous incluez OrderId
et ShippingId
, Amazon ignore le numéro de commande et télécharge la facture avec le numéro d'expédition. Si aucun des deux n'est fourni, il se peut que vous obteniez un message d'erreur. Pour obtenir de l'aide concernant les erreurs, reportez-vous à Gestion des erreurs.
Les suivants feedOptions
sont requis:
TotalAmount
. Le montant total figurant sur la facture. Il s'agit du prix incluant la TVA pour les articles, les emballages cadeaux et les frais d'expédition, moins la TVA pour toutes les promotions. Si le montant total spécifié ne correspond pas au montant total d'Amazon pour cette expédition (à la deuxième décimale près), le chargement de la facture est rejeté. Nous vous recommandons de suivre strictement les calculs fiscaux fournis dans le VIDR.TotalVATAmount
. Le montant total de la TVA figurant sur la facture. Il s'agit de la TVA pour les articles, les emballages cadeaux et les frais d'expédition, moins la TVA pour toutes les promotions. Si le montant de la TVA ne correspond pas au montant de TVA calculé par Amazon pour cette expédition (à la deuxième décimale près), le téléchargement de la facture est rejeté. Nous vous recommandons de suivre strictement les calculs fiscaux fournis dans le VIDR.InvoiceNumber
. Numéro de facture utilisé sur la facture. Ce numéro de facture est communiqué aux clients. Les vendeurs doivent s'assurer que le même numéro de facture apparaît sur la facture.
Les suivants feedOptions
sont optionnel:
-
DocumentType
. Valeurs possibles :Invoice
. Utilisez-le si vous chargez une facture.CreditNote
. Utilisez-le si vous chargez une note de crédit pour un remboursement ou un retour.
La valeur par défaut estInvoice
.
-
TransactionId
, réglé surDocumentType=CreditNote
.
Attention
N'ajoutez pas de guillemets autour des clés ou des valeurs. Amazon accepte uniquement les caractères suivants : virgules (
,
), barres obliques vers l'avant (/
), barres obliques inverses (\
), espaces (), tirets (-
), souligne (_
), des points-virgules (;
), deux-points (:
), hachages (#
), 0-9, A-Z, a-z. Amazon réduit l'espace supplémentaire.
La limite de limitation du flux de facturation (UPLOAD_VAT_INVOICE
) correspond au téléchargement d'une facture toutes les trois secondes.
Exemples
Chargements de factures :
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
Notes de crédit (CN-123-ABC
est le numéro de la note de crédit) :
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
Code Java pour créer les options de flux :
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);
}
Charger manuellement les factures
Tous les vendeurs qui choisissent pas pour s'inscrire à VCS ont l'option par défaut de télécharger leurs propres factures sur Amazon à l'aide de l'API ou de Seller Central. Cette section décrit l'utilisation de l'API.
Pour télécharger manuellement des factures, vous devez utiliser vos propres données fiscales pour créer vos factures. Tu vas pas avoir accès à un rapport VIDR.
Appelez l'opération createFeed
pour valider UPLOAD_VAT_INVOICE
et feedType
.
Astuce
Pour obtenir les identifiants de la place de marché de votre pays, consultez Identifiants Marketplace.
Pour feedOptions
, vous devez spécifier les métadonnées sous forme de paires clé:valeur avec la facture PDF. Soit OrderId
ou ShippingId
est obligatoire lorsque vous chargez une facture (ShippingId
est préférable).
OrderId
: identifiant de la commande pour laquelle la facture est envoyée.ShippingId
: identifiant de l'expédition pour laquelle la facture est soumise.
Si vous incluez OrderId
et ShippingId
, Amazon ignore le numéro de commande et télécharge la facture avec le numéro d'expédition. Si aucun des deux n'est fourni, il se peut que vous obteniez un message d'erreur. Pour obtenir de l'aide concernant les erreurs, reportez-vous à Gestion des erreurs.
Les suivants feedOptions
sont requis:
InvoiceNumber
. Numéro de facture utilisé sur la facture. Ce numéro de facture est communiqué aux clients. Les vendeurs doivent s'assurer que le même numéro de facture apparaît sur la facture.DocumentType
. Valeurs possibles :Invoice
. Utilisez-le si vous chargez une facture.CreditNote
. Utilisez-le si vous chargez une note de crédit pour un remboursement ou un retour.
La valeur par défaut estInvoice
.
Astuce
Avec les téléchargements manuels, vous pouvez télécharger plusieurs factures pour le même numéro de commande. Toutefois, le numéro de facture doit être unique. Seule la dernière facture est considérée comme valide.
Les suivants feedOptions
sont optionnel:
TotalAmount
. Le montant total figurant sur la facture. Il s'agit du prix incluant la TVA pour les articles, les emballages cadeaux et les frais d'expédition, moins la TVA pour toutes les promotions. Si le montant total spécifié ne correspond pas au montant total d'Amazon pour cette expédition (à la deuxième décimale près), le chargement de la facture est rejeté. Nous vous recommandons de suivre strictement les calculs fiscaux fournis dans le VIDR.TotalVATAmount
. Le montant total de la TVA figurant sur la facture. Il s'agit de la TVA pour les articles, les emballages cadeaux et les frais d'expédition, moins la TVA pour toutes les promotions. Si le montant de la TVA ne correspond pas au montant de TVA calculé par Amazon pour cette expédition (à la deuxième décimale près), le téléchargement de la facture est rejeté. Nous vous recommandons de suivre strictement les calculs fiscaux fournis dans le VIDR.TransactionId
, réglé surDocumentType=CreditNote
.
Attention
N'ajoutez pas de guillemets autour des clés ou des valeurs. Amazon accepte uniquement les caractères suivants : virgules (
,
), barres obliques vers l'avant (/
), barres obliques inverses (\
), espaces (), tirets (-
), souligne (_
), des points-virgules (;
), deux-points (:
), hachages (#
), 0-9, A-Z, a-z. Amazon réduit l'espace supplémentaire.
La limite de limitation du flux de facturation (UPLOAD_VAT_INVOICE
) correspond au téléchargement d'une facture toutes les trois secondes.
Exemples
Chargements de factures :
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}
Notes de crédit (CN-123-ABC
est le numéro de la note de crédit) :
{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}
Vous pouvez utiliser l'exemple de code suivant pour joindre le fichier PDF. Bien que cet exemple soit en Java, vous pouvez l'utiliser comme modèle pour d'autres langages de programmation.
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