1. Configurazione

Passare alla sezione "Electronic reporting" (Rendicontazione elettronica) nel proprio account Nexi Payengine:

  • A livello di account (PSPID):
    1. Selezionare "Operations" e scegliere "Electronic reporting" nel menu secondario.
    2. Selezionare "Operations" e scegliere "View transactions", "Financial history" (o "View files") nel menu secondario.
    3. Selezionare "File format".
  • A livello di utente (USERID):
    1. Selezionare "Advanced" e scegliere "User" nel menu secondario.
    2. Quindi fare clic su "Edit" (Modifica) per l'utente specifico.
    3. Selezionare "Electronic Reporting for this User" in fondo alla pagina nella panoramica dei dati utente.

È possibile selezionare la propria struttura di file preferita e il formato di file per i report.

È possibile definire la struttura del file e il formato per ciascun utente. Quando si configurano i parametri della rendicontazione elettronica per un utente, questa configurazione sarà applicata a tutti i report impostati dall'utente in oggetto.

A seconda della struttura del file, nel report saranno visualizzati campi specifici.

È possibile scegliere una delle seguenti strutture di file:

  • Standard
  • Estesa
  • Dinamica
  • Gestione file

È inoltre possibile scegliere tra vari formati di output:

  • XML
  • Lunghezza fissa
  • Delimitato

Nota: se sono già stati creati uno o più report giornalieri nel proprio account, “Electronic reporting” mostrerà un elenco dei report esistenti. Per accedere da questa posizione alla pagina per la configurazione di “Electronic reporting”, fare clic sul collegamento “File format” nell'area superiore della pagina.

2. Steps

Per scaricare i file formattati con le informazioni sulla transazione:

  1. Definire il formato e la struttura del file dalla pagina Rapporto elettronico.
  2. Usare le opzioni Storia Finanziaria, Visualizza le transazioni e Visualizza i file per selezionare le informazioni desiderate.
  3. Fare clic sul pulsante "Scarica".

Vari criteri permettono di personalizzare l'emissione dei file scaricati:

  • Struttura definisce i dati e la posizione dei pagamenti selezionati.
  • Formato definisce il formato in cui sono emessi i dati.
  • Le specifiche "Ordina per" permettono di raggruppare i dati in base a valori certi.
  • Opzioni aggiuntive consente di personalizzare la visualizzazione dei record di pagamenti.

3. Struttura

I dati possono essere emessi usando strutture diverse:

  • Standard
  • Estesa
  • Dinamico
  • Gestione dei file

Ognuna presenta un numero (e una posizione) di campi diversi nei pagamenti selezionati. Tali campi sono descritti in dizionario dati inclusi il nome di tag XML, la dimensione, il formato e la descrizione.

3.1 Campi comuni

XML Tags Descrizione
ID Riferimento Pagamento
REF Riferimento del rivenditore
ORDER Data dell'ordine
STATUS Stato
LIB Descrizione di stato
ACCEPT Codice di autorizzazione dall'acquirente

3.2 Standard

Storia Finanziaria, Visualizza le transazioni:

XML Tags Descrizione
Vedere campi comuni ...
PAYDATE Data di pagamento
CIE Società
NAME Nome di fatturazione
COUNTRY Paese di fatturazione dell'acquirente (opzionale)
TOTAL Importo
CUR Valuta
SHIP Costo di spedizione (opzionale)
TAX Tasse (opzionale)
METHOD Metodi di pagamento
BRAND Tipo di carta
CARD Numero della carta
STRUCT Comunicazione strutturata (per il prossimo pagamento Net banking )

Storia Finanziaria (Scarica riepilogo):

XML Tags Descrizione
CLIENTID ClientID
METHOD Metodi di pagamento
BRAND Tipo di carta
OWNER Titolare della carta
CARD Numero della carta
PAYDATE Data di pagamento
STATUS Stato
LIB Descrizione di stato
TOTAL Importo
CUR Valuta
NBPAY Numero di transazioni
BATCHREF Riferimento batch

Visualizza i file (pagina di selezione):

XML Tags Descrizione
MERCHREF Riferimento del rivenditore
DATE Data file
STATUS Stato
OPERATION Operazione file
NBPAY Numero di transazioni
TRANSACTION Transazione codice

3.3 Estesa

Per Visualizza i file (pagina di selezione) e Storia Finanziaria (riepilogo), vedere la struttura Standard.

Storia Finanziaria, Visualizza le transazioni:

XML Tags Descrizione
Vedere campi comuni ...
NCID Transazione codice (NCID)
NCSTER Stato della transazione
PAYDATE Data di pagamento
CIE Società
FACNAME1 Nome di fatturazione, riga 1
FACNAME2 Nome di fatturazione, riga 2 (opzionale)
FACSTREET1 Indirizzo di fatturazione, riga 1 (opzionale)
FACSTREET2 Indirizzo di fatturazione, riga 2 (opzionale)
FACZIP CAP di fatturazione (opzionale)
FACTOWN Città di fatturazione (opzionale)
COUNTRY Paese di fatturazione dell'acquirente (opzionale)
DELNAME1 Nome di spedizione, riga 1 (opzionale)
DELNAME2 Nome di spedizione, riga 2 (opzionale)
DELSTREET1 Indirizzo di spedizione, riga 1 (opzionale)
DELSTREET2 Indirizzo di spedizione, riga 2 (opzionale)
DELZIP CAP di spedizione (opzionale)
DELTOWN Città di spedizione (opzionale)
DELCOUNTRY Paese di spedizione (opzionale)
TOTAL Importo
CUR Valuta
SHIP Costo di spedizione (opzionale)
TAX Tasse (opzionale)
METHOD Metodi di pagamento
BRAND Tipo di carta
CARD Numero della carta
UID UID
STRUCT Comunicazione strutturata (per il prossimo pagamento Net banking)
FILEID Schedario di transazione caricato
ACTION Ultima azione (Storia Finanziaria)
TICKET Biglietto virtuale (Storia Finanziaria)
PSPID PSPID (per gli utenti del gruppo Merchant)
DESC Descrizione

3.4 Dinamico (nuovo formato esteso)

Tale struttura contiene campi facoltativi ed è disponibile per Acquisto, Merchant Assistant o Viaggio.

XML Tags Descrizione
Vedere campi comuni ...
NCID Transazione codice (NCID)
NCSTER Stato della transazione
PAYDATE Data di pagamento
CIE Società
FACNAME1 Nome di fatturazione, riga 1
COUNTRY Paese di fatturazione dell'acquirente (opzionale)
TOTAL Importo
CUR Valuta
METHOD Metodi di pagamento
BRAND Tipo di carta
CARD Numero della carta
EXPDATE Data di scadenza
UID UID
STRUCT Comunicazione strutturata (per il prossimo pagamento Net banking )
FILEID Schedario di transazione caricato
ACTION Ultima azione (Storia Finanziaria)
TICKET Biglietto virtuale (Storia Finanziaria)
DESC Descrizione
SHIP Costo di spedizione (opzionale)
TAX Tasse (opzionale)
USERID Utente
PSPID PSPID (solo quando collegato come utente del gruppo rivenditori)
REFID Entità
REFKIND Tipo di entità
ECI Indicatore di commercio elettronico (Origine della transazione (ECI)).
CCCTY Paese emittente della carta
IPCTY Paese indirizzo IP
CVCCHECK Controllo del codice validità carta
AAVCHECK Controllo di validità indirizzo automatico
VC Tipo di carta virtuale
BATCHREF Riferimento batch

Per la struttura "Dynamic" è possibile aggiungere questi campi alla fine della struttura.

I campi disponibili possono essere selezionati dall'opzione Rapporto elettronico:

XML Tags
FACNAME2 Nome di fatturazione, riga 2
FACSTREET1 Indirizzo di fatturazione, riga 1
FACSTREET2 Indirizzo di fatturazione, riga 2
FACZIP CAP di fatturazione
FACTOWN Città di fatturazione
DELNAME1 Nome di spedizione, riga 1
DELNAME2 Nome di spedizione, riga 2
DELSTREET1 Indirizzo di spedizione, riga 1
DELSTREET2 Indirizzo di spedizione, riga 2
DELZIP CAP di spedizione
DELTOWN Città di spedizione
DELCOUNTRY Paese di spedizione
REF1 Riferimento cliente (Ref.1)
REF2 Riferimento cliente (Ref.2)
REF3 Riferimento cliente (Ref.3)
REF4 Riferimento cliente (Ref.4)
OWNER Titolare della carta
EMAIL Indirizzo e-mail
ALIAS Alias
SCORING Punteggio
ORDERDATETIME Pagamento gg/mm/aaa hh:mm:ss
SCO_CATEGORY Categoria di punteggio
FDMA_SCORING_CATEGORY FDMA Scoring category
EXPERT_SCORING_CATEGORY Fraud Expert Scoring Category
IPADDR Request's IP address
REC_IPADDR Received IP address
OPEDESC Reason for the operation
BINCARD Card BIN number
CARDUNIQUEID Card unique identifier
ORDERDATETIME Payment dd/mm/yyy hh:mm:ss
PAYDATETIME Payment dd/mm/yyy hh:mm:ss
CREDITDEBIT Show credit/debit split information
DEVICE Device
TO_MOBILEMODE Mobile mode
XF_BIC BIC/Sort code
XF_MANDATEID Mandate ID
XF_SIGNDATE Sign date (yyyymmdd)
XF_SEQUENCETYPE Sequence type
EXPERT_DEVICEID Device ID
DFP_DEVICEID Mostra le impronte digitali del dispositivo (computer, cellulare, ecc.) usate nella transazione.
DFP_RISK_LEVEL_CATEGORY Il livello di rischio associato all'impronta digitale del dispositivo. Formato:
1=a basso rischio
2=a medio rischio, sospetto
3=ad alto rischio
AS_FRAUD_TYPE Transazioni classificate come "contestazione" da un commerciante o da un acquirente.

Il flag "Con dettagli" può essere impostato nell'opzione Rapporto elettronico.

3.4.1 Dettagli viaggio

XML Tags Descrizione
ID Riferimento Pagamento (Dettagli)
TINUM Numero di biglietto
TIDATE Data del biglietto
CONJTI Biglietto di congiunzione
PASNAME Nome passeggero
ORCITY Aeroporto di partenza (Cod.)
DESTCITY Aeroporto di arrivo (Cod.)
ORCITYL Aeroporto di partenza
DESTCITYL Aeroporto di arrivo
CARRIER Codice di vettore
BOOKIND Indicatore di prenotazione
FLNUM Numero di volo
FLDATE Data del volo
CLASS Classe della compagnia aerea
STOPOV Scalo
VATAPPL Applicabilità dell'IVA
TYPCH Tipo di tariffa
AIRTAX Tasse aeroportuali
EYCD Codice area di destinazione
IRST Codice area di destinazione (Typ.)
CHDETL Informazioni di addebito

3.5 Gestione dei file

Per Visualizza i file (pagina di selezione) e Storia Finanziaria (riepilogo), vedere la struttura Standard.

Storia Finanziaria, Visualizza le transazioni:

XML Tags Descrizione
TOTAL Importo
CUR Valuta
BRAND Tipo di carta
CARD Numero della carta
EXPDATE Data di scadenza
REF Il riferimento file personale
NCID Transazione codice (NCID)
ID Riferimento Pagamento
STATUS Stato del file
LIB Descrizione di stato
ACCEPT Codice di autorizzazione dall'acquirente
PAYDATE Data di pagamento
ACTION Ultima azione (Storia Finanziaria)
TICKET Biglietto virtuale (Storia Finanziaria)
PSPID PSPID (solo quando collegato come utente del gruppo rivenditori)
DESC Descrizione

3.6 Formato

Ogni record corrisponde a un pagamento. I formati di emissione sono:

  • XML: ogni campo che descrive il pagamento è emesso come proprietà del tag <PAYMENT>.
  • Lunghezza fissa: ogni campo ha una dimensione fissa, come descritto nelle diverse strutture precedenti.
  • Delimitato da separatore: ciascun campo di record di pagamento è separato da un separatore (T per le tabulazioni). Se un valore contiene il separatore, sarà sostituito con uno spazio nel campo di download per evitare errori di corrispondenza.

3.7 Ordina per

Dopo aver selezionato una struttura e un formato, è possibile raggruppare i pagamenti in base al valore dei campi selezionati. È possibile scegliere fino a 3 campi per creare gruppi e sotto-gruppi su 3 livelli.

3.8 Nome e formato del file scaricato

È possibile specificare il nome e l'estensione del file scaricato. Nel nome file non è possibile utilizzare i caratteri speciali [/ . \ : * ? | < > "]

È possibile inserire parametri dinamici nel nomefile:

  • [DATE] per la data precedente del file di elaborazione
  • [FILEDATE] per la data del file di elaborazione
  • [TIME] per l'ora del file di elaborazione

Es: File[DATE]_[TIME] sarà convertito in File20111025_16134.

Nel campo estensione; è possibile utilizzare qualsiasi estensione di file con 3 caratteri; specificare * nel campo significa che l'estensione è sottratta dal formato:

  • '.xml' per XML
  • '.csv' per valori delimitati da punto e virgola
  • '.txt' per lunghezza fissa o delimitata da tabulazioni

3.9 Opzioni aggiuntive

  • Casella di selezione intestazione: si possono inserire delle intestazioni per rendere i dati più leggibili oppure escludere le intestazioni per disporre solo dei dati pertinenti.
  • Separatore decimale: scegliere il separatore decimale da usare come formato di download [, oppure .].
  • Con intestazione di colonna: con questa opzione, il nome (ad es. nome di tag XML) di ciascun campo è visualizzato sulla riga che precede il primo pagamento (solo per i formati FIX e DEL).
  • Con dettagli: per i rivenditori con dettagli Viaggio, Merchant Assistant o Acquisto (solo per il formato DYN).

4. Dizionario dati

I campi sono ordinati in tag XML ascendenti; per la posizione del campo nelle strutture; fare riferimento a Struttura.

Tag XML
AAVCHECK Controllo di validità indirizzo automatico
ACCEPT Codice di autorizzazione dall'acquirente
ACTION Ultima azione
AIRTAX Tasse aeroportuali
ALIAS Alias
BATCHREF Riferimento batch
BOOKIND Indicatore di prenotazione
BRAND Tipo di carta
CARD Numero della carta
CARRIER Codice di vettore
CCCTY Paese emittente della carta
CHDETL Informazioni di addebito
CIE Società
CLASS Classe della compagnia aerea
CLIENTID ClientID
CONJTI Biglietto di congiunzione
COUNTRY Paese di fatturazione dell'acquirente
CUR Valuta
CVCCHECK Controllo del codice validità carta
DATE Data file
DELCOUNTRY Paese di spedizione
DELNAME1 Nome di spedizione, (riga 1)
DELNAME2 Nome di spedizione, (riga 2)
DELSTREET1 Indirizzo di spedizione, (riga 1)
DELSTREET2 Indirizzo di spedizione, (riga 2)
DELTOWN Città di spedizione
DELZIP CAP di spedizione
DESC Descrizione
DESTCITY Aeroporto di arrivo (Cod.)
DESTCITYL Aeroporto di arrivo
ECI Indicatore di commercio elettronico (Origine della transazione (ECI)).
EMAIL Indirizzo e-mail
EXP Data di scadenza
EXPDATE Data di scadenza (mm/aaaa)
EYCD Codice area di destinazione
FACNAME1 Nome di fatturazione, (riga 1)
FACNAME2 Nome di fatturazione, (riga 2)
FACSTREET1 Indirizzo di fatturazione, (riga 1)
FACSTREET2 Indirizzo di fatturazione, (riga 2)
FACTOWN Città di fatturazione
FACZIP CAP di fatturazione
FILEID Schedario di transazione caricato
FLDATE Data del volo
FLNUM Numero di volo
ID Riferimento Pagamento (Detail)
ID Riferimento Pagamento
IPCTY Paese indirizzo IP
IRST Codice area di destinazione (Typ.)
ITEMNAME Nome dell'articolo
ITEMNO ID dell'articolo
LIB Descrizione di stato
LIDDISCOUNTRATE Sconto
LIDGROSSAMT Prezzo (IVA incl.)
LIDNETAMT Prezzo (IVA escl.)
LIDREF1 Riferimento voce (1)
LIDREF2 Riferimento voce (2)
LIDTAXRATE Tasso IVA (in %)
MERCHREF Riferimento del rivenditore
METHOD Metodi di pagamento
Invoicing name Nome di fatturazione
NBPAY Numero di transazioni
NCID Transazione codice(NCID)
NCSTER Stato della transazione
OPERATION Operazione file
ORCITY Aeroporto di partenza (Cod.)
ORCITYL Aeroporto di partenza
ORDER Data dell'ordine
OWNER Titolare della carta
PASNAME Nome passeggero
PAYDATE Data di pagamento
PSPID PSPID
QUANTITY Quantità
REF Riferimento del rivenditore
REF Il riferimento file personale
REF1 Riferimento cliente (Ref.1)
REF2 Riferimento cliente (Ref.2)
REF3 Riferimento cliente (Ref.3)
REF4 Riferimento cliente (Ref.4)
REFID Entità
REFKIND Tipo di entità
SCORING Punteggio
SCO_CATEGORY Categoria di punteggio
SHIP Costo di spedizione
STATUS Stato del file
STATUS Stato
STOPOV Scalo
STRUCT Comunicazione strutturata
TAX Tasse
TICKET Biglietto virtuale
TIDATE Data del biglietto
TINUM Numero di biglietto
TOTAL Importo
TRANSACTION Transazione codice
TYPCH Tipo di tariffa
UID UID
UNITNETPRICE Prezzo dell'articolo (IVA escl.)
USERID Utente
VATAPPL Applicabilità dell'IVA
VC Tipo di carta virtuale

Domande frequenti

Con l'attivazione dell'account, diventa automaticamente disponibile il nostro strumento di riconciliazione se avete  un conto “Full Service” ho avete “Collect” come acquirente.
Il nostro strumento consente di riconciliare facilmente i pagamenti ricevuti sul conto bancario con gli ordini/le transazioni nell'account Nexi Payengine .

Nel menu dell'account Nexi Payengine, è possibile cercare facilmente le transazioni selezionando "Operations" (Operazioni) e facendo clic su "View transactions" (Visualizza le transazioni) o "Financial history" (Storia finanziaria), in funzione del tipo di risultati di transazione cercati.

Andare alla sezione Consultazione delle transazioni per ulteriori informazioni.

Per impostazione predefinita, è possibile inviare la merce o fornire il servizio una volta che la transazione ha raggiunto lo stato "9 - Payment requested" (9 - Pagamento richiesto). Tuttavia, anche se lo stato 5 indica un risultato positivo, si tratta solo di una prenotazione temporanea di un importo in denaro sulla carta del cliente. Una transazione in stato 5 deve ancora essere confermata (manualmente o automaticamente) per passare allo stato 9, lo stato positivo finale per la maggior parte dei metodi di pagamento.

È possibile rimborsare facilmente un pagamento con il pulsante "Refund" (Rimborsa) nella panoramica dell'ordine di una transazione (tramite View transactions). Se l'account lo consente, è inoltre possibile fare i rimborsi con una richiesta DirectLink o caricando un Batch file (per transazioni multiple).

L'opzione Refunds (Rimborsi) deve essere attivata nell'account.

Un'icona con pollice verde alzato indica che una transazione è stata completata con un metodo di autenticazione 3-D Secure, ad esempio Digipass o lettore di carte. Tuttavia, non significa necessariamente che il pagamento sia stato elaborato. Occorre sempre controllare lo stato della transazione per sapere se si riceverà il denaro.

Per controllare i dettagli specifici di un ordine/una transazione o eseguire la manutenzione delle transazioni, occorre utilizzare l'opzione View transactions. "Financial history" serve invece al controllo periodico dei fondi in entrata e in uscita.

È possibile eseguire rimborsi solo su transazioni per le quali i fondi hanno già ricevuto (lo stato 9 nel nostro sistema  ) per almeno 24 ore. Una cancellazione o annullamento può essere fatto entro circa 24 ore dopo che lo stato finale è stato ricevuto (stato 9 o 5).

Per conoscere l'ora di chiusura (cut-off time) dell'acquirente, si consiglia di verificare direttamente con il nostro servizio clienti.

Quando una transazione raggiunge lo stato 9, che indica il pagamento da parte del cliente, l'acquirente o la banca depositerà il denaro sul conto. Il momento in cui avviene questo pagamento varia in base al metodo di pagamento e all'acquirente. Si consiglia di controllare direttamente con l'acquirente o la banca, qualora si pensi che la ricezione del denaro non sia avvenuta in modo puntuale.