Push reports
Push reports
Inhoudsopgave 1. Inleiding 2. Configuratie 3. Een nieuw rapport maken 3.1 Een rapport aanmaken via Dagtotalen/Financiële historiek of Beheer transacties 3.1.1 Hoe? 3.1.2 Rapportinstellingen 3.1.3 Bestandsstructuur
3.2 Een rapport voor Reconciliatie aanmaken 3.2.1 Hoe? 3.2.2 Rapportinstellingen 3.2.3 Bestandsstructuur
4. Rapporten beheren 4.1 Toegang tot gemaakte rapporten 4.2 Een rapport bewerken 4.2.1 Elektronische rapporten 4.2.2 Financiële historiek/Dagtotalen en Beheer transacties 4.2.3 Rapportinstellingen
4.3 Een rapport verwijderen 4.4 Een rapport opnieuw verzenden
Page 1 of 11 - 26/08/2015
Push reports
1. Inleiding De optie Push Reports heeft betrekking op de geautomatiseerde verzending van automatische transactierapporten naar de merchant. Met de optie Push Reports kunt u: de reconciliatie vereenvoudigen periodiek uitgebreide rapporten ontvangen uw betalingen gemakkelijk beheren en controleren de administratieve workload terugdringen via geautomatiseerde rapportage verschillende rapporten definiëren op basis van verschillende gebruikersbehoeften (opmaak/ontvangers) rapporten ontvangen zonder software te moeten installeren Het aantal beschikbare dagelijkse rapporten is afhankelijk van de in uw account geselecteerde optie. De optie Push Reports bevat maximaal 3, 5 of 10 rapporten. Als u meer dan 10 rapporten wenst, kunt u contact opnemen met ons ons Sales team voor meer informatie. U kunt push reports ontvangen voor “Beheer transacties”, “Financiiële historiek/Dagtotalen” en “Reconciliatie”. Voor Reconciliation zijn standaard 3 push reports beschikbaar als u Collect gebruikt.
Page 2 of 11 - 26/08/2015
Push reports
2. Configuratie Ga naar "Elektronische rapporten" in uw Ogone-account, via het hoofdmenu van uw account, als volgt: Met uw PSPID (hoofdgebruiker): - Selecteer "Transacties" en kies "Elektronische rapporten" in het sub-menu. - Selecteer "Transacties" en kies "Beheer transacties" of "Financiële historiek/Dagtotalen" (of "Beheer bestanden") in het sub-menu. Selecteer vervolgens "File format". Met een andere gebruiker dan uw PSPID-gebruiker (USERID login): - Selecteer "Configuratie" en kies "Gebruikers" in het sub-menu. Klik vervolgens "Wijzig" voor de specifieke gebruiker. In het overzicht "Gegevens van de gebruiker", selecteer "Elektronische rapportering voor deze gebruiker" onderaan de pagina. In de "Elektronische rapporten" kunt u de bestandsstructuur en het bestandsformaat van uw keuze selecteren. De bestandsstructuur en het bestandsformaat kunnen voor elke gebruiker apart ingesteld worden. Alle rapporten die door deze gebruiker worden aangemaakt zullen bijgevolg op basis van die configuratie opgesteld worden. In uw rapporten worden specifieke velden teruggestuurd, afhankelijk van de bestandsstructuur. U heeft keuze tussen vier structuren: Standard, Extended, File Management en Dynamic. U kunt ook kiezen uit drie bestandsformaten: XML, Fixed-length en Delimited. Opmerking: indien u al een of meerdere rapporten heeft aangemaakt in uw account, zal via de knop "Elektronische rapporten" een lijst van uw ingestelde rapporten worden getoond. Om vanaf deze pagina de configuratie van de "Elektronische rapporten" te bereiken, dient u de link '"File format" bovenaan de pagina te selecteren. Voor een volledige beschrijving van de verschillende structuren, ga naar Rapportering.
Page 3 of 11 - 26/08/2015
Push reports
3. Een nieuw rapport maken 3.1 Een rapport aanmaken via Dagtotalen/Financiële historiek of Beheer transacties 3.1.1 Hoe? Klik op “Dagtotalen/Financiële historiek” of “Beheer transacties” in het menu van uw Ogone account en voer de zoekcriteria en/of statussen in voor de transactieresultaten die u wilt ontvangen. Alle criteria/gegevens die u selecteert/invoert worden in aanmerking genomen (behalve de datums, aangezien een dagelijks rapport altijd de transactieresultaten van de vorige dag bevat). Klik op de knop “Dagelijks verzenden”. Meer informatie over de verschillen tussen “Dagtotalen/Financiële historiek” en “Beheer transacties” .
3.1.2 Rapportinstellingen
Voer in het veld "Naam" een bestandsnaam in, selecteer in de keuzelijst "Media" een mediatype, voer een bestemming in en klik vervolgens op de knop "Toevoegen". U kunt kiezen uit drie mediatypes: e-mail met bijlage, e-mail en HTTP Request: Selecteert u e-mail met bijlage, dan ontvangt u het dagelijkse rapport als bijlage bij een e-mailbericht Selecteert u e-mail, dan wordt de inhoud van het dagelijkse rapport weergegeven in de hoofdtekst van het e-mailbericht. > Voor deze twee mediatypen moet u in het veld “Bestemming” een of meer geldige e-mailadressen invoeren waarnaar de e-mails moeten worden verzonden. Selecteert u HTTP Request, dan ontvangt u de inhoud van het dagelijkse rapport in een request op de URL die u in het veld “Bestemming” hebt ingevoerd
3.1.3 Bestandsstructuur De bestandsstructuur van het rapport hangt af van de bestandsstructuur (en eventuele bijkomende velden) die u heeft geselecteerd op de pagina Elektronische rapporten/File format (zie Rapportering).
3.2 Een rapport voor Reconciliatie aanmaken Ga naar Reconciliation voor meer informatie.
3.2.1 Hoe? Klik op “Financiële historiek/Dagtotalen” of “Beheer transacties” in het hoofdmenu van uw account en vul de zoekcriteria en/of statussen in voor de zoekresulaten die u wil verkrijgen. Alle criteria/data die u selecteert/invult zullen worden gebruikt (behalve de datums, gezien een dagelijks rapport altijd de resultaten van de vorige dag zal verzenden). Klik op de knop "Dagelijks verzenden". Meer informatie over de verschillen tussen “Dagtotalen/Financiële historiek” en “Beheer transacties” .
3.2.2 Rapportinstellingen Vul een bestandsnaam, mediatype en een bestemming in in de desbetreffende velden en klik op de knop “Toevoegen”.
Page 4 of 11 - 26/08/2015
Push reports
Gezien voor Reconciliatie enkel het type “e-mail met bijlage” mogelijk is, is dit voorgeselecteerd. In geval van Ingenico Collect, the payout frequency depends on your payout frequency. To configure the filename and format, go to Configuration of file name and format.
3.2.3 Bestandsstructuur De volgende velden vindt u terug in elk Push report. Afhankelijk van of het een Reconcilitatie of Uitbetalings (Payout)-rapport (in geval van Ingenico Collect) betreft zullen sommige velden geen of verschillende waarden bevatten.
Voor geen enkel veld is er een minimum of maximum aantal tekens.
Dit is de bestandsstructuur voor het "Payout report" (uitbetalingsrapport) en het "payout reference report" (uitbetalingsreferentierapport) (geactiveerd voor oktober 2014), alsook het "Payout" rapport (beschikbaar sinds oktober 2014):
Naam kolom
Beschrijving
Voorbeeld
Payout report (uitbetalingsrapport) Ogone brengt enkel transacties in rekening waarvoor het een status-match met de acquirer heeft. Daarom is de waarde van de
MATCHING (enige
kolom steeds "MATCHING".
mogelijke waarde)
MERCHANT_ID
Uw PSPID
account01
PAYMENT_DATE
Transactiedatum (jjjjMMdd)
20140807
TRANSACTION_ID
Unieke betalingsidentificator
100633195
Bedragswaarde van de transactie (numeriek), uitgedrukt in de
1352 (hier, lees 13,52
kleinste eenheid van de gebruikte munteenheid.
EUR)
CURRENCY_CODE
ISO-code munteenheid (numeriek)
978
CARD_TYPE
Kaarttype
VISA
ORDER_ID
Handelaar/Merchant Order ID
TEST_1344326081114
HEADER
ORIGIN_AMOUNT
Type uitvoering/operatie OPERATION_TYPE
DT: Debet / CT: Credit (terugbetaling) / CB: Chargeback
DT
(terugvordering)
OPERATION_NUMBER
Uitvoerings/operatienummer)
0
PAYOUT_DATE
Datum van uitbetaling (jjjjMMdd)
20140808
Het total bedrag van de transactie of transactiegroep (inclusief BRUT_AMOUNT
Page 5 of 11 - 26/08/2015
kosten acquirer).
1352 (hier, lees 13,52 EUR)
Push reports
Naam kolom
Beschrijving
Voorbeeld
Dit is het bedrag dat u ziet in de Financiële historiek/Dagtotalen van uw Ogone-account.
Dit geeft weer of we transacties kunnen matchen in de payout (uitbetaling) ten opzichte van de Ogone-transacties.
MATCH_STATUS
Ogone brengt enkel transacties in rekening waarvoor het een
MATCH_OK (enige
status-match met de acquirer heeft. Daarom is de waarde van de
mogelijke waarde)
kolom steeds "MATCH_OK". Belangrijk: CT en CB worden ook beschouwd als "MATCH_OK" REMITTANCE_NB
Betalingsnummer
1234567
Het bedrag dat u ontvangt op uw bankrekening (=brutobedrag min NET_AMOUNT
COMMISSION_AMOUNT
de commissie van de acquirer, chargebacks (terugboeking) en
1325 (hier, lees 13,52
andere kosten)
EUR)
Acquirer/collector commissie (uitgedrukt in de kleinste eenheid van de gebruikt munt)
COMMISSION_CURRENCY
ISO-code munteenheid (numeriek)
RECON_REFERENCE
Werd de uitbetaling gerenconcilieerd?
RECON_DATE
Datum waarop de reconciliatie werd uitgevoeerd (jjjjMMdd)
STMT_DATE
STMT_NUMBER
Datum afschrift (indien ingevuld op het moment van de reconciliatie) (jjjjMMdd)
27 (hier, lees 0,27 EUR)
978
20140808
20140809
Nummer afschrift (indien ingevuld op het moment van de reconciliatie)
PAYOUT_ACCOUNT
Bankrekeningnummer waarop het bedrag betaald is
CHARGEBACK_REFERENCE
Chargeback nummer (Terugboeking)
Dit is de bestandsstructuur voor het "Payout report including non-transactional data" (Uitbetalingsrapport met niet-transactionele gegevens) (beschikbaar sinds oktober 2014):
Naam kolom
Beschrijving
Voorbeeld
Niet-transactionele gegevens Ogone brengt enkel transacties in rekening waarvoor het een HEADER
Page 6 of 11 - 26/08/2015
status-match met de acquirer heeft. Daarom is de waarde van de
MATCHING (enige
kolom steeds "MATCHING".
mogelijke waarde)
Push reports
Naam kolom
Beschrijving
Voorbeeld
MERCHANT_ID
Uw PSPID
account01
PAYMENT_DATE
Transactiedatum (jjjjMMdd)
20140807
TRANSACTION_ID
Unieke betalingsidentificator
100633195
Bedragswaarde van de transactie (numeriek), uitgedrukt in de
1352 (hier, lees 13,52
kleinste eenheid van de gebruikte munteenheid.
EUR)
TRANSACTION_CURRENCY
ISO 4217-code munteenheid (alfabetisch)
EUR
PAYMENT_METHOD
Gebruikte betaalmethode
VISA
ORDER_ID
Handelaar/Merchant Order ID
TEST_1344326081114
ORIGIN_AMOUNT
OPERATION_TYPE
Operation type (type uitvoering/operatie). Zie de tabel hieronder voor alle mogelijke waarden.
TDEB
OPERATION_NUMBER
Operation number (uitvoerings/operatienummer)
0
PAYOUT_DATE
Datum van uitbetaling (jjjjMMdd)
20140808
Het total bedrag van de transactie of transactiegroep (inclusief kosten acquirer). GROSS_AMOUNT
1352 (hier, lees 13,52 Dit is het bedrag dat u ziet in de Financiële historiek/Dagtotalen
EUR)
van uw Ogone-account.
Dit geeft weer of we transacties kunnen matchen in de payout (uitbetaling) ten opzichte van de Ogone-transacties. MATCH_STATUS
Ogone brengt enkel transacties in rekening waarvoor het een status-match met de acquirer heeft. Daarom is de waarde van de
MATCH_OK (enige mogelijke waarde)
kolom steeds "MATCH_OK".
PAYOUT_REFERENCE
Betalingsnummer
12345678
Het bedrag dat u ontvangt op uw bankrekening (=brutobedrag min NET_AMOUNT
COMMISSION_AMOUNT
de commissie van de acquirer, chargebacks (terugboeking) en
1325 (hier, lees 13,52
andere kosten)
EUR)
Acquirer/Collector commissie (uitgedrukt in de kleinste eenheid van de gebruikte munt)
27 (hier, lees 0,27 EUR)
COMMISSION_CURRENCY
ISO 4217-code munteenheid (alfabetisch)
EUR
PAYOUT_ACCOUNT
Bankrekeningnummer waarop het bedrag betaald is
BE123456789
CHARGEBACK_REFERENCE
Chargeback nummer (Terugboeking)
12345678
Page 7 of 11 - 26/08/2015
Push reports
Naam kolom
Beschrijving
Voorbeeld
DESCRIPTION
Omschrijving niet-transactionele vergoedingen van de collector
Account setup
Vergoedingen betaald tussen banken voor het aanvaarden van op INTERCHANGE_AMOUNT
kaart gebaseerde transacties (uitgedrukt in de kleinste eenheid
10 (hier, lees 0,10 EUR)
van de gebruikte munt). INTERCHANGE_CURRENCY
Munteenheid van het uitgewisselde bedrag
EUR
MERCHANT_DESCRIPTION
Omschrijving van de handelaar (zoals in het "COM"-veld gestuurd)
order_1
Dit is de lijst met "Operation Types" zoals opgenomen het uitbetalingsrapport met niet-transactionele gegevens: Eerste letter: T = Transactie, N = Niet-transactioneel
Transactionele vergoedingen
OPERATION_TYPE
Transactie (9) (debit)
TDEB
Terugbetalingen (85, 8, 7) (refund)
TREF
Betaling geweigerd door acquirer (84 = Chargeback)
TCBK
Terugbetaling geweigerd door acquirer (94 = Chargeback reversal)
TCBR
Niet-transactioneel: vergoedingen
OPERATION_TYPE
Account Setup
NAST
Uitbetaling (payout)
NPAY
Maandelijk (monthly)
NMON
Jaarlijks (yearly)
NYEA
Service Setup
NSST
Terugbetaling (refund)
NREF
Terugboeking (chargeback)
NCBK
Autorisatie (GMID)
NAUT
Niet-transactioneel: Direct Debit
OPERATION_TYPE
Positief
NDDP
Negatief
NDDN
Page 8 of 11 - 26/08/2015
Push reports
Niet-transactioneel: Aaanpassingen
OPERATION_TYPE
Positief
NADP
Negatief
NADN
Indien u push reports voor oktober 2014 hebt geconfigureerd worden uw rapporten nog met de oude structuur verzonden.
Niet verzenden indien leeg Gezien reconciliatie afhangt van feedback van acquirers en banken, zullen push reports met Ingenico Collect leeg zijn waneer ze worden gestuurd in het weekend en op Belgische feestdagen. Daarom raden we u aan de optie "Niet verzenden indien leeg" aan te duiden bij het aanmaken van een nieuw push report.
Page 9 of 11 - 26/08/2015
Push reports
4. Rapporten beheren 4.1 Toegang tot gemaakte rapporten Zodra u een of meer dagelijkse rapporten hebt gemaakt, zijn deze toegankelijk via de link “Elektronische rapporten” in het menu.
4.2 Een rapport bewerken 4.2.1 Elektronische rapporten Als u de bestandsindeling van uw rapporten (d.w.z. alle door uw gebruiker gemaakte rapporten) wilt wijzigen, klikt u op de link Bestandsformaat (File format) bovenaan op de pagina Dagelijks rapport (die u kunt openen met de link “Elektronische rapporten” in het menu van uw Ogone-account).
4.2.2 Financiële historiek/Dagtotalen en Beheer transacties U kunt de instellingen voor “Dagtotalen/Financiële historiek” of “Beheer transacties” niet wijzigen voor een bestaand rapport. Als u de zoekcriteria en/of statussen wilt wijzigen die u voor een rapport op de pagina “”Dagtotalen/Financiële historiek” of “Beheer transacties” hebt geselecteerd, moet u het rapport verwijderen en een nieuw rapport maken.
4.2.3 Rapportinstellingen Op de pagina Dagelijks rapport (Elektronische rapporten) kunt u de inhoud van de velden Naam, Media en Bestemming wijzigen en kunt u aangeven of er al dan niet een dagelijks rapport moet worden verzonden als er geen te rapporteren transacties zijn. De wijzigingen worden pas toegepast wanneer u in de kolom Transacties van het rapport op de knop Veranderen klikt
4.3 Een rapport verwijderen Als u een specifiek dagelijks rapport wilt verwijderen, klikt u in de kolom Transacties van dat rapport op de knop “Afschaffen”.
4.4 Een rapport opnieuw verzenden Als u een bepaald dagelijks rapport opnieuw wilt verzenden, klikt u in de kolom Transacties van dat rapport op de knop “Log”. Zoek het rapport dat u opnieuw wilt verzenden en klik in de kolom Transacties van dat rapport op de knop “Opnieuw verzenden”. Er verschijnt een nieuwe regel voor het rapport. De naam van het rapport zal dezelfde zijn als de naam van het oorspronkelijke rapport.
Page 10 of 11 - 26/08/2015
Push reports
De kolom Datum/Status zal rood gemarkeerd zijn tot het rapport is verzonden. Daarna wordt de kolom groen gemarkeerd en worden in de kolom de datum en het tijdstip weergegeven waarop het rapport werd verzonden. Op deze logboekpagina krijgt u een overzicht van alle verzonden rapporten.
Page 11 of 11 - 26/08/2015