Gérer vos rapports
Notre solution Direct fournit des rapports couvrant l’ensemble des transactions de paiement de votre boutique en ligne ainsi que les opérations de caisse associées.
Selon vos moyens de paiement et votre banque acquéreuse, vous pouvez également accéder à des rapports de rapprochement bancaire et à des rapports d’impayés.
Ce guide vous aide à migrer vos rapports actuels vers votre portail et comprend des tableaux de correspondance entre les champs Sips et les champs du portail.
Types et formats de rapports Sips
Sips fournit des rapports uniquement sous forme de fichiers CSV, avec deux formats possibles :
- Le format historique, également appelé format "TABLE_VX".
- Le nouveau format, également appelé format "TAB20_VX".
Vous pouvez vérifier le format de votre rapport dans l’en-tête du fichier. Dans Sips, vous pouvez choisir le séparateur de champs (délimiteur). Nous fournissons des listes de champs fixes pour chaque format afin d’assurer la cohérence et un traitement fiable.
Sips propose 4 types de rapports décrits dans les chapitres suivants :
- Rapports de transactions (JT)
- Rapports d’opérations (JO)
- Rapports de rapprochement financier (JRB)
- Rapports de rapprochement des impayés (JRI)
Rapports de transactions et d’opérations
- Rapports de transactions : énumèrent l’ensemble des transactions de votre boutique en ligne depuis le précédent rapport, y compris les paiements acceptés et refusés.
- Rapports d’opérations : recensent les changements d’état dans le cycle de vie des transactions, tels que l’annulation, la validation, le remboursement et la remise.
Rapports de rapprochement
Une transaction rapprochée est une transaction pour laquelle :
- l’acquéreur (banque acquéreuse) ou un établissement financier (processeur de paiements par carte) envoie un retour à la plateforme de paiement Sips via un flux dédié, avec des données supplémentaires.
- la plateforme de paiement vérifie la transaction et intègre ces données.
À partir des transactions rapprochées, nous produisons pour vous des rapports de rapprochement qui combinent les données de la plateforme de paiement et celles de l’acquéreur.
Il existe deux types de rapports de rapprochement répondant à deux objectifs distincts :
- Rapports de rapprochement financier : L’acquéreur envoie un retour confirmant que les transactions ont bien été envoyées au clearing (traitement de remise en paiement). Ce retour ajoute des données financières telles que les montants crédités sur votre compte bancaire et les frais. En général, ce retour et le rapprochement associé interviennent peu de temps après l’envoi des transactions à l’acquéreur.
- Rapports de rapprochement des impayés : Le retour de l’acquéreur vers la plateforme de paiement peut signaler des transactions en impayé (contestations du porteur de carte) et fournir des données telles que la date, le code motif et une référence d’impayé pour le traitement du litige. Un impayé peut intervenir après un délai, le processus de contestation prenant du temps.
Créer des rapports dans Direct avec le e-Portal
Le e-Portal est notre interface web composée de plusieurs modules. Le module "Reporting omnicanal" vous permet de visualiser et de gérer vos transactions. Vous pouvez configurer, suivre et analyser vos paiements et vos données transactionnelles. Vous pouvez accéder au Guide utilisateur complet de e-Portal directement sur e-Portal. Cliquez sur le point d’interrogation à côté de votre nom d’utilisateur.
Choisissez "Rapports immédiats", puis Journal pour ouvrir une vue interactive des transactions. Les lignes dépendent de la plage de temps et des filtres que vous avez sélectionnés. Les colonnes dépendent de vos paramètres sous "Personnaliser l’affichage". Vous pouvez ajouter, supprimer et réorganiser des colonnes.
Le Dictionnaire de données est la liste complète des colonnes disponibles. Vous pouvez consulter et télécharger ce document depuis e-Portal.
Les Rapports immédiats génèrent des rapports directement dans l’interface utilisateur de e-Portal. Vous pouvez les télécharger avec le bouton "Exporter". Si vous souhaitez automatiser la génération et la livraison des rapports :
- Utilisez "Créer un abonnement" pour configurer des exports automatisés.
- Utilisez "Rapports planifiés" pour mettre en place un envoi régulier.
Reportez-vous au Guide utilisateur de e-Portal pour des procédures pas à pas. Nous sommes à votre disposition.
Rapports de rapprochement financier
Vous pouvez générer un rapport de rapprochement financier (l’équivalent d’un JRB Sips) en :
- appliquant un filtre pour inclure uniquement les transactions dont le "Statut de rapprochement" est "Rapprochée". Ce champ se trouve dans la catégorie "Informations de rapprochement".
- utilisant "Personnaliser l’affichage" pour ajouter les colonnes dont vous avez besoin depuis la catégorie "Informations de rapprochement".
Équivalences des champs pour le format TABLE_VX
Voici le tableau HTML avec le contenu inchangé par rapport au document :
| # | JRB field name | e-Portal equivalent field(s) | Comments |
|---|---|---|---|
| 1 | ENTETE | - | Identifiant du type d'enregistrement au sein du JRB, aucun équivalent nécessaire. |
| 2 | MERCHANT_COUNTRY | ||
| 3 | MERCHANT_ID | PSPID | |
| 4 | CONTRACT | Contrat commerçant | |
| 5 | PAYMENT_DATE | ID transaction (Worldline) | Voir (1) |
| 6 | TRANSACTION_ID | ID transaction (Worldline) | Voir (1) |
| 7 | ORIGIN_AMOUNT | - | |
| 8 | CURRENCY_CODE | Devise | Devise dans laquelle BRUT_AMOUNT est exprimé ; voir (2) |
| 9 | CARD_TYPE | Réseau | |
| 10 | ORDER_ID | Référence commande | |
| 11 | RETURN_CONTEXT | - | |
| 12 | CUSTOMER_ID | - | |
| 13 | OPERATION_TYPE | Type transaction | Également, d'une certaine manière "Amount"; voir (2) |
| 14 | OPERATION_NUMBER | ID transaction (Worldline) | Voir (1) |
| 15 | REMITTANCE_DATE | Date remise | Voir (3) |
| 16 | REMITTANCE_TIME | Date remise | Voir (3) |
| 17 | BRUT_AMOUNT | Montant | Voir (2) |
| 18 | MATCH_STATUS | Statut réconciliation | À utiliser avec le filtre "Statut de rapprochement = Rapprochée" |
| 19 | REMITTANCE_NB | Numéro remise (acquéreur) | |
| 20 | NET_AMOUNT | Montant net (acquéreur) | |
| 21 | COMMISSION_AMOUNT | Commission | Voir (4) |
| 22 | COMMISSION_CURRENCY | Commission | Voir (4) |
| 23 | COMMISSION_OPER_CODE | Commission | Voir (4) |
| 24 | AUTHOR_ID | Numéro autorisation | |
| 25 | SPECIFIC_DATA | - | |
| 26 | REJECT_AMOUNT | - | |
| 27 | REJECT_REASON | - | |
| 28 | ORDER_CHANNEL | Canal transaction; ECI | Équivalence imparfaite ; deux champs couvrent globalement le besoin. |
| 29 | BRUT_AMOUNT_ACQ | - | Voir (5) |
| 30 | REMITTANCE_TYPE | - | Voir (5) |
| 31 | TOTAL_BRUT_REM_ACQ | - | Voir (5) |
| 32 | TOTAL_COM_REM_ACQ | - | Voir (5) |
| 33 | TOTAL_NET_REM_ACQ | - | Voir (5) |
| 34 | BANK_TRANSFER_ID | - | |
| 35 | BANK_TRANSFER_DATETIME | - | |
| 36 | COMMISSION_TVA | - | |
| 37 | VALUE_DATE | - | |
| 38 | INTERCHANGE_FEE | Frais interchange | |
| 39 | CARD_INTERCHANGE_CATEGORY_CODE | Type carte | Équivalence imparfaite |
| 40 | SETTLEMENT_MODE | - | |
| 41 | ACQUISITION_TYPE | - | |
| 42 | FEES_DEBIT_NUMBER | - | |
| 43 | ACQUIRER_RESPONSE_MESSAGE | - | |
| 44 | ACQUIRER_RECONCILIATION_DETAIL | - |
(1) Sips et e-Portal utilisent des modèles de données et des dénominations différents. Un JRB Sips (rapport de rapprochement financier) liste les opérations Sips rapprochées. Dans Sips, vous identifiez une opération par le triplet (PAYMENT_DATE, TRANSACTION_ID, OPERATION_NUMBER). Dans e-Portal, l’entité équivalente est une Transaction. Vous l’identifiez avec le champ "ID transaction (Worldline)". Par conséquent, la correspondance correcte des champs est :
Sips (PAYMENT_DATE, TRANSACTION_ID, OPERATION_NUMBER)
Vs
e-Portal "ID transaction (Worldline)".
(2) Les montants dans e-Portal sont gérés différemment de Sips. Sips utilise trois champs. e-Portal en utilise un seul.
Dans e-Portal, vous saisissez les montants dans un champ unique Amount qui contient :
- Un caractère de signe (blanc pour positif, "-" pour négatif) indiquant le sens DÉBIT/CRÉDIT.
- Une valeur numérique au format décimal en unités monétaires (par exemple, 12.34).
- Un code devise au format ISO à trois lettres (par exemple, EUR).
Dans Sips, les montants sont répartis sur trois champs :
- Une valeur numérique absolue dans un champ suffixé par "amount", exprimée en entier dans une unité fractionnaire de la devise. Par défaut, il s’agit de la plus petite sous-unité (par exemple, le centime pour l’euro). Dans certains cas, l’unité est plus petite (par exemple, un centième de centime).
- Un champ séparé pour le sens DÉBIT/CRÉDIT.
- Un champ séparé pour la devise.
Exemple : l’équivalence des champs est
Sips (OPERATION_TYPE, BRUT_AMOUNT, CURRENCY_CODE)
VS
e-Portal Amount.
(3) Le champ e-Portal "Capture date" est une date-heure et est équivalent au couple Sips "REMITTANCE_DATE" et "REMITTANCE_TIME".
(4) Comme en (2), l’équivalence des champs est :
Sips (COMMISSION_OPER_CODE, COMMISSION_AMOUNT, COMMISSION_CURRENCY)
Vs
e-Portal "Commission".
(5) Ces champs ne s’appliquaient qu’à Sips lorsque LCL était l’acquéreur. Vous pouvez les ignorer dans e-Portal.
Équivalences des champs pour le format TAB20_VX
| # | JRB field name | e-Portal equivalent field(s) | Comments |
|---|---|---|---|
| 1 | recordCode | - | Identifiant du type d’enregistrement au sein du JRB, aucun équivalent nécessaire. |
| 2 | merchantId | PSPID | |
| 3 | transactionReference | ID transaction (Worldline) | Voir (6) |
| 4 | operationSequence | ID transaction (Worldline) | Voir (6) |
| 5 | transactionDateTime | Date serveur | |
| 6 | orderId | Référence commande | |
| 7 | orderChannel | Canal transaction; ECI | Équivalence imparfaite ; deux champs couvrent globalement le besoin. |
| 8 | paymentMeanBrand | Réseau | |
| 9 | paymentMeanType | - | |
| 10 | operationType | Type transaction | Également, d’une certaine manière "Montant" ; voir (7) |
| 11 | remittanceDateTime | Date remise | |
| 12 | remittanceNumber | Numéro remise (acquéreur) | |
| 13 | paymentStatus | Statut réconciliation | À utiliser avec le filtre "Statut réconciliation = Rapprochée" |
| 14 | currencyCode | Devise | Devise dans laquelle grossAmount est exprimé ; voir (7) |
| 15 | originAmount | - | |
| 16 | grossAmount | Montant | |
| 17 | netAmount | Montant net (acquéreur) | |
| 18 | feeCurrency | Commission | Voir (8) |
| 19 | feeAmount | Commission | Voir (8) |
| 20 | s10TransactionIdDate | - | Voir (9) |
| 21 | s10TransactionId | ID transaction (Worldline) | Voir (9) |
| 22 | acquirerContractNumber | Contrat commerçant | |
| 23 | authorisationId | Numéro autorisation | |
| 24 | feeType | Commission | Voir (8) |
| 25 | fundTransferNumber | - | |
| 26 | settlementMode | - | |
| 27 | returnContext | - | |
| 28 | customerId | - | |
| 29 | interchangeFee | Frais interchange | |
| 30 | cardInterchangeCategoryCode | Type carte | Équivalence imparfaite |
| 31 | lastMerchantOperationDateTime | - | |
| 32 | lastMerchantOperationName | - | |
| 33 | mandateId | - | |
| 34 | acquisitionType | - | |
| 35 | feesDebitNumber | - | |
| 36 | settlementArchivingReference | Référence acquéreur | |
| 37 | acquirerResponseMessage | - | |
| 38 | acquirerReconciliationDetail | - | |
| 39 | paymentMeanDataProvider | - | |
| 40 | initialHolderAuthentProgram | - | |
| 41 | initialAuthentDateTime | - | |
| 42 | initialHolderAuthentType | Flux 3DS | L'équivalence s'applique si la transaction est une CIT. |
| 43 | initialChallengeMode3DS | Indicateur défi 3DS | L'équivalence s'applique si la transaction est une CIT. |
| 44 | merchantToken | - |
(6) Sips et e-Portal utilisent des modèles et des dénominations différents. Un JRB Sips liste les opérations Sips rapprochées. Vous identifiez une opération Sips avec le couple (transactionReference, operationSequence). Dans e-Portal, l’entité équivalente est une Transaction, identifiée par le champ "ID transaction (Worldline)". Par conséquent, la correspondance des champs est :
Sips (transactionReference, operationSequence)
VS
e-Portal "ID transaction (Worldline)".
(7) Les montants dans e-Portal diffèrent de Sips. Sips utilise trois champs. e-Portal en utilise un seul.
Dans e-Portal, le champ Amount inclut :
* Un caractère de signe (blanc pour positif, "-" pour négatif) indiquant le sens DÉBIT/CRÉDIT.
* Une valeur numérique au format décimal en unités monétaires.
* Une devise sous forme de code ISO à trois lettres.
Dans Sips, les montants sont répartis entre :
* Une valeur entière dans un champ "…amount", exprimée dans une unité fractionnaire de la devise. Par défaut, il s’agit de la plus petite sous-unité (par exemple, centimes pour l’euro). Dans certains cas, l’unité est plus petite (par exemple, un centième de centime).
* Un champ séparé pour le sens DÉBIT/CRÉDIT.
* Un champ séparé pour la devise.
Exemple :
Sips (operationType, grossAmount, currencyCode)
Vs
e-Portal Amount
(8) Comme en (7), l’équivalence des champs est :
Sips (feeType, feeAmount, feeCurrency)
Vs
e-Portal "Commission"
(9) Les champs s10TransactionIdDate et s10TransactionId sont des identifiants hérités Sips 1.0 pour une transaction. Sips 2.0 les remplace par transactionReference. Vous devez les faire correspondre dans e-Portal au même champ : "ID transaction (Worldline)".
Rapports de rapprochement des impayés
Vous pouvez générer un rapport de rapprochement des impayés (équivalent d’un JRI Sips, rapprochement des impayés) en procédant comme suit :
- Ouvrez "Rapports immédiats" et sélectionnez "Impayés".
- Appliquez la plage de temps et les filtres souhaités.
- Utilisez "Personnaliser l’affichage" pour ajouter des colonnes, en particulier celles de la catégorie "Informations d’impayé".
Équivalences des champs pour le format TABLE_VX
| # | JRI field name | e-Portal equivalent field(s) | Comments |
|---|---|---|---|
| 1 | ENTETE | - | Identifiant du type d'enregistrement au sein du JRI, aucun équivalent nécessaire. |
| 2 | MERCHANT_COUNTRY | - | |
| 3 | MERCHANT_ID | PSPID | |
| 4 | CONTRACT | Contrat commerçant | |
| 5 | DATE_NUM | ID transaction (Worldline) | Voir (10) |
| 6 | TRANSACTION_ID | ID transaction (Worldline) | Voir (10) |
| 7 | OPERATION_TYPE | Type transaction | |
| 8 | SOURCE_AMOUNT | Montant transaction initiale | |
| 9 | SIRET | ID juridique marchand | |
| 10 | UNPAID_NB | Référence impayé | |
| 11 | UNPAID_CODE | Code motif impayé | |
| 12 | CURRENCY_CODE | Devise | |
| 13 | CONTRACT_TYPE | - | |
| 14 | POS_NB | TPV | |
| 15 | REMITTANCE_DATE | Date remise | |
| 16 | EXCHANGE_AMOUNT | - | |
| 17 | VALUE_DATE | - | |
| 18 | UNPAID_AMOUNT | Montant impayé | |
| 19 | EXCHANGE_UNPAID_AMOUNT | - | |
| 20 | EXCHANGE_CURRENCY_CODE | - | |
| 21 | CHARGED_BANK_CODE | - | |
| 22 | CHARGED_COUNTER | - | |
| 23 | CHARGED_ACCOUNT | - | |
| 24 | CHARGED_ADMIN_COUNTER | - | |
| 25 | REMITTANCE_ID | Numéro remise (acquéreur) | |
| 26 | MATCH_STATUS | - | |
| 27 | CUSTOMER_ID | - | |
| 28 | ORDER_ID | Référence commande | |
| 29 | RETURN_CONTEXT | - | |
| 30 | TRANSACTION_STATUS | - | |
| 31 | CURRENT_AMOUNT | - | |
| 32 | ORIGIN_AMOUNT | - | |
| 33 | CARD_TYPE | Réseau | |
| 34 | CHARGED_CARD_TYPE | - | |
| 35 | UNPAID_SETTLE_DATE | Date règlement impayé | |
| 36 | UNPAID_DOC_REASON | Code motif demande document | |
| 37 | UNPAID_DOC_DATE | Date demande document | |
| 38 | ORDER_CHANNEL | Canal transaction; ECI | Équivalence imparfaite ; deux champs couvrent globalement le besoin. |
| 39 | BANK_TRANSFER_ID | - | |
| 40 | BANK_TRANSFER_DATETIME | - | |
| 41 | COMMISSION_TVA | - | |
| 42 | COMMISSION_AMOUNT | - | |
| 43 | UNPAID_NATIVE_CODE | - | |
| 44 | SDD_MANDATE_ID | - |
(10) Sips et e-Portal utilisent des modèles et des dénominations différents. Un JRI Sips liste les opérations rapprochées avec un impayé.
Vous identifiez une opération Sips par le triplet (DATE_NUM, TRANSACTION_ID, OPERATION_NUMBER). Dans e-Portal, l’entité équivalente est une Transaction identifiée par "ID transaction (Worldline)".
Correspondance des champs :
Sips (DATE_NUM, TRANSACTION_ID, OPERATION_NUMBER)
Vs
e-Portal "ID transaction (Worldline)". OPERATION_NUMBER n’est pas fourni dans JRI.
Équivalences des champs pour le format TAB20_VX
| No. | JRB field name | e-Portal equivalent field(s) |
Comments |
|---|---|---|---|
| 1 | recordCode | - | Identifiant du type d'enregistrement au sein du JRI, aucun équivalent nécessaire. |
| 2 | merchantId | PSPID | |
| 3 | acquirerContractNumber | Contrat commerçant | |
| 4 | transactionDateTime | Date serveur | |
| 5 | transactionReference | ID transaction (Worldline) | |
| 6 | operationType | Type transaction | |
| 7 | sourceAmount | Montant transaction initiale | |
| 8 | merchantLegalId | ID juridique marchand | |
| 9 | chargebackAcquirerReference | Référence impayé | |
| 10 | chargebackReasonCode | Code motif impayé | |
| 11 | currencyCode | Devise | |
| 12 | contractType | - | |
| 13 | posNb | TPV | |
| 14 | remittanceDatetime | Date remise | |
| 15 | exchangeAmount | - | |
| 16 | valueDate | - | |
| 17 | chargebackAmount | Montant impayé + Devise | |
| 18 | exchangeUnpaidAmount | - | |
| 19 | exchangeCurrencyCode | - | |
| 20 | chargedBankCode | - | |
| 21 | chargedBankCounter | - | |
| 22 | chargedBankAccount | - | |
| 23 | chargedBankAdminCounter | - | |
| 24 | pbaRemittanceNumber | Numéro remise (acquéreur) | |
| 25 | customerId | - | |
| 26 | orderId | Référence commande | |
| 26bis | transactionStatus | - | |
| 27 | currentAmount | - | |
| 28 | originAmount | - | |
| 29 | paymentMeanBrand | Réseau | |
| 30 | paymentMeanType | - | |
| 31 | chargebackSettlementDate | Date règlement impayé | |
| 32 | chargebackDocumentRequestReason | Code motif impayé | |
| 33 | chargebackDocumentRequestDate | Date demande document | |
| 34 | orderChannel | Canal transaction; ECI | Équivalence imparfaite ; deux champs couvrent globalement le besoin. |
| 35 | s10TransactionId | ID transaction (Worldline) | |
| 36 | s10TransactionIdDate | ID transaction (Worldline) | |
| 37 | maskedPan | Numéro carte | |
| 38 | settlementArchivingReference | Référence acquéreur | |
| 39 | mandateId | - | |
| 40 | returnContext | - | |
| 41 | networkCode | - | |
| 42 | acquirerResponseMessage | - | |
| 43 | acquirerReconciliationDetail | - | |
| 44 | paymentMeanDataProvider | - | |
| 45 | initialHolderAuthentProgram | - | |
| 46 | initialAuthentDateTime | - | |
| 47 | initialHolderAuthentType | Flux 3DS | S’applique si cette transaction est une CIT initiale. Voir (11) |
| 48 | initialChallengeMode3DS | Indicateur défi 3DS | S’applique si cette transaction est une CIT initiale. Voir (11) |
| 49 | authentDateTime | - | |
| 50 | authentAmount | - | |
| 51 | paymentPattern | - | |
| 52 | holderAuthentStatus | - | |
| 53 | holderAuthentProgram | - | |
| 54 | holderAuthentRelegationCode | Responsabilité 3DS | |
| 55 | holderAuthentType | Flux 3DS | S'applique si cette transaction a été (ré)authentifiée. Voir (11) |
| 56 | challengeMode3DS | Indicateur défi 3DS | S'applique si cette transaction a été (ré)authentifiée. Voir (11) |
| 57 | transactionInitiator | - | |
| 58 | merchantToken | - |
(11) Dans Sips, vous utilisez deux ensembles de champs d’authentification. CIT signifie "Transaction initiée par le porteur de carte". Les champs portant le préfixe "initial" conservent l’authentification de la CIT initiale. Les champs sans ce préfixe contiennent l’authentification ou la réauthentification de la transaction en cours. Dans e-Portal, les champs équivalents concernent uniquement la transaction en cours. L’alimentation des champs varie selon que la transaction en cours est la CIT initiale et selon qu’elle a été authentifiée ou réauthentifiée.