• Trust
  • Envoyer une demande

    • Need assistance with your Emarsys product?
    We'll get you the help you need!

     

    Emarsys client

     

    Emarsys client
    SAP for Me Login

    You can contact our support team via the SAP for Me.

    The Emarsys component: CEC-EMA

    		Login to the Help Portal and Submit your request. 
    1. Emarsys
    2. Commencer
    3. Preparing for Integration

    Sales Data Batch Loads:: Exigences relatives au fichier CSV de données de vente standard
    Mise à jour

    Pour utiliser notre solution Chargements par lots de données de vente, vous devez formater votre fichier CSV de données de vente conformément aux spécifications et directives décrites sur cette page.

    Général

    • Votre fichier de données de vente doivent être un tableau .csv simple, chaque ligne décrivant les attributs d'un seul article.
    • Le nom du fichier doit correspondre au modèle fourni dans la configuration.
    • L'extension du fichier doit être .csv.
    • Vous ne pouvez pas charger des fichiers d'une taille supérieure à 100 Go.
    • Utilisez le codage UTF-8.
    • Votre fichier doit commencer par la ligne d'en-tête (par ex. les noms de fichier). Les colonnes de l'en-tête de votre fichier de données de vente doivent être dans l'ordre spécifié lors de la configuration.
    • Vous pouvez nommer les champs comme vous le souhaitez, mais ils doivent correspondre à votre configuration.
    • Les mises à jour de commandes ne sont pas autorisées. Veillez à ne charger qu'une seule fois chaque commande individuelle et à ne pas réutiliser la même combinaison d'identifiant de transaction et de type de transaction. En cas de doublons, les nouvelles transactions remplaceront les précédentes.
    • Vous devez charger l'image complète d'une commande (pas les deltas) et vous assurer que tous les articles inclus dans une transaction sont chargés dans le même fichier.
    • Utilisez n'importe quel séparateur CSV standard pour séparer les champs d'une ligne, comme une virgule ',', un point-virgule ';', une tabulation '\t', un espace ' ' et une barre verticale '|'.
    • Lorsque vous utilisez des caractères de retour à la ligne, assurez-vous qu'ils sont correctement mis entre guillemets.
    • Vous pouvez utiliser des guillemets simples ou doubles.
    • Les champs facultatifs doivent être inclus dans le fichier CSV, mais leurs valeurs peuvent rester vides.
    • Ne chargez pas plus de 20 champs personnalisés.

    Types de données pris en charge

    Les types de données suivants sont pris en charge :

    • string
    • date
    • float
    • integer

    Format d'horodatage pris en charge

    Chargements par lots de données de vente prend en charge un sous-ensemble de ISO 8601:

    • Vous devez fournir des données horaires à la seconde près.
    • Vous pouvez fournir des informations sur les secondes fractionnaires jusqu'à 6 chiffres.
    • Vous devez fournir des informations sur le fuseau horaire :
      • donnez explicitement des horodatages UTC, ou bien
      • utilisez l'heure avec des décalages.

    Chargements par lots de données de vente peut traiter les exemples suivants :

    • 2022-06-16T12:18:51Z
    • 2022-06-16T12:18:51.545Z
    • 2024-04-11T07:00:24-07:00
    • 2024-04-11T07:00:24.2-07:00
    • 2022-06-16T12:18:51.123456Z

    Exemples non valables :

    • Wed Apr 16 2022 21:44:48 GMT-0400 (Eastern Daylight Saving Time): cet exemple ne représente pas une norme ISO 8601.
    • 2023-07-15 12:00:00.000000 UTC: cet exemple ne représente pas une norme ISO 8601.
    • 2024-04-11: cet exemple ne contient pas de données horaires ni d'informations sur le fuseau horaire.
    • 2022-06-16T12:18:51.1234567Z: plus de 6 chiffres sont utilisés pour les fractions de secondes dans cet exemple (Chargements par lots de données de vente ne peut traiter que 6 chiffres).

    Champs personnalisés

    • Un maximum de 20 champs personnalisés peut être chargé.
    • Les champs personnalisés sont facultatifs.
    • La solution Chargements par lots de données de vente valide également les types de données des champs personnalisés.

    CSV exemple

    Voici à quoi ressemble un exemple de fichier CSV :

    Cliquez ici pour charger un fichier CSV exemple.

    transactionType,transactionId,referencedOrderId,externalContactIdType,externalContactId,accountCurrency,transactionCurrency,transactionCreatedDateTime,transactionLastChangedDateTime,storeId,salesChannel,productId,quantity,amountInAccountCurrency,amountInTransactionCurrency,custom_color order,123,123,email,3,EUR,EUR,2023-07-19T12:18:51.545Z,2023-07-20T12:18:51.545Z,12,online,111,1,120,120,black order,234,234,email,3,EUR,EUR,2023-07-21T12:18:51.545Z,2023-07-22T12:18:51.545Z,12,online,222,5,1200,1200,orange order,345,345,email,3,EUR,EUR,2023-07-23T12:18:51.545Z,2023-07-24T12:18:51.545Z,12,online,333,1.5,1200,1200,blue order,456,456,email,3,EUR,EUR,2023-07-25T12:18:51.545Z,2023-07-26T12:18:51.545Z,12,online,444,140,1200,1200,purple order,456,456,email,3,EUR,EUR,2023-07-25T12:18:51.545Z,2023-07-26T12:18:51.545Z,12,online,23,140,1200,1200,purple
    Cliquer pour copier

    Champs obligatoires

    Les champs suivants sont obligatoires pour Chargements par lots de données de vente :

    Champ Type Nécessité Description
    type de transaction string mandatory
    • Décrit une commande ou un remboursement.
    • Valeurs possibles : order ou refund
    • Il doit être identique pour chaque poste d'une transaction donnée.
    transactionId string mandatory
    • L'identifiant unique de la commande ou du remboursement.
    • Pour les commandes ou les remboursements comprenant plusieurs produits, utilisez le même transactionId pour chaque poste.
    referencedOrderId string obligatoire pour le type refund
    • Identifiant de la commande à laquelle le remboursement se réfère.
    • C'est obligatoire, mais le remboursement sera quand même traité et chargé si la commande référencée ne peut pas être trouvée dans Emarsys.
    • Il doit être identique pour chaque poste du remboursement.
    externalContactIdType string mandatory
    • Type d'identifiant du contact pour la transaction. Par exemple : email, numéro de téléphone.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    externalContactId string mandatory
    • Identifiant du contact pour la transaction.
    • Il peut s'agir d'une adresse électronique, d'un numéro de téléphone, etc.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    account_currency string mandatory
    • Devise au Format ISO.
    • Elle doit correspondre à la devise centrale de votre compte, configurée lors de la création du compte.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    transaction_currency string mandatory Devise au Format ISO.
    transactionCreatedDateTime timestamp mandatory
    • L'horodatage auquel la transaction (commande ou remboursement) a été créée dans le système externe (système de point de vente, Shopify, Adobe Commerce ou SAP Commerce Cloud).
    • transactionCreatedDateTime doit toujours précéder l'heure à laquelle l'achat a été chargé. Les dates ultérieures ne sont pas acceptées.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    transactionLastChangedDateTime timestamp mandatory
    • L'horodatage de la dernière modification de la transaction dans le système externe (système POS, Shopify, Adobe Commerce, SAP Commerce Cloud).
    • transactionLastChangedDateTime doit toujours précéder l'heure à laquelle l'achat a été chargé. Les dates ultérieures ne sont pas acceptées.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    productId string mandatory
    • L'identifiant unique utilisé pour identifier le produit.
    • L'identifiant indiqué ici doit se trouver dans votre base de données produits Emarsys.
    • Pour des commandes comprenant plusieurs produits, chaque produit (appelé rubrique) doit être soumis dans une ligne séparée avec le même identifiant de commande.
    quantity float mandatory
    • Quantité d'article(s) achetés.
    • Pour les commandes, il faut toujours indiquer une valeur positive ou zéro.
    • Pour les remboursements, soumettez toujours une valeur négative.
    amount_in_account_currency float mandatory
    • Le prix unitaire multiplié par la quantité dans la devise définie dans votre compte.
    • Pour les remboursements, soumettez toujours une valeur négative.
    amount_in_transaction_currency float mandatory
    • Le prix unitaire multiplié par la quantité dans la devise de transaction définie.
    • Pour les remboursements, soumettez toujours une valeur négative.
    • N'incluez pas la devise.

    Champs facultatifs

    Les champs suivants sont facultatifs pour Chargements par lots de données de vente :

    Champ Type Nécessité Description
    storeId string optional
    • L'identifiant du magasin provenant de votre système externe.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    salesChannel string optional
    • Le canal de vente de la transaction.
    • Il doit être identique pour chaque poste d'une transaction donnée.
    Cet article vous a-t-il été utile ?
    Utilisateurs qui ont trouvé cela utile : 0 sur 0
    Retour en haut