Caricare e scaricare file con PostFinance Batch (base)

Transcript

1

2 Tabella dei contenuti 1. Introduzione 2. Caricamento manuale di file 2.1 Preparazione dei file delle transazioni 2.2 Procedura di caricamento manuale Fase 1: Selezione dello schedario Fase 2: Controllo del formato Fase 3: Risultati del caricamento 3. Consultazione dei file caricati 3.1 Alcuni criteri per la consultazione di file Vari riferimenti file Stati dei file Codici 4. Download di file 4.1 Rapporto elettronico 5. Appendice: Layout dei file Page 1 of 12-30/06/2017

3 1. Introduzione La modalità PostFinance Batch consente di raggruppare i pagamenti in file formattati che possono essere successivamente caricati. Questa opzione è particolarmente adatta alla gestione di un gran numero di pagamenti o fatturazioni ricorrenti. Il presente documento spiega la procedura di creare/gestire i file Batch e caricarli. Per informazioni più dettagliate sul Batch (ad esempio automatizzare il caricamento e il processo di download), consultare Batch avanzata. Page 2 of 12-30/06/2017

4 2. Caricamento manuale di file 2.1 Preparazione dei file delle transazioni I file da caricare devono essere file di testo normale in un determinato formato che possono essere creati con qualsiasi applicazione (per esempio, MS Access, MS Excel, ecc.). Se non si dispone di una di queste applicazioni per creare questi file formattati delle transazioni, è possibile creare detti file manualmente, immettendo le righe delle transazioni una per una (max linee). Tuttavia, abbiamo preparato un file di MS Excel per facilitare la creazione dei file formattati delle transazioni destinati al caricamento. Il foglio di lavoro di MS Excel contiene una macro che consente di creare un file di testo semplice contenente tutte le informazioni del foglio di lavoro. Non si deve caricare il foglio di lavoro, bensì il file MS Excel di testo creato con la macro in esso contenuta. Per informazioni più dettagliate, consultare il layout dei file. 2.2 Procedura di caricamento manuale Fare clic sul collegamento "Schedario caricare" del menu di PostFinance back office per caricare un nuovo file dei pagamenti Fase 1: Selezione dello schedario Fare clic sul pulsante "Browse" per selezionare il file che si desidera caricare dal computer. Inserire il riferimento (nome) del file. È possibile utilizzare questo riferimento per consultare il file in un secondo momento. Fare clic sul pulsante "Caricamento file transazioni" Fase 2: Controllo del formato Dopo aver caricato un file procediamo innanzitutto a verificarne il formato. Convalidiamo la correttezza del layout del file e la corrispondenza del contenuto al formato. In questa fase non archiviamo il file nel nostro database, quindi è ancora possibile annullarlo se necessario. Nella pagina della verifica del formato vengono visualizzati: Le prime transazioni valide del file (il numero dipende dal numero inserito nella schermata precedente) Gli errori di convalida del formato delle transazioni Gli importi totali per valuta Il nostro riferimento file Un elenco dei file caricati nel corso dell'ultimo mese contenenti gli stessi importi totali e/o la stessa somma/addizione di numeri di carta, così da evitare di inviare due volte il medesimo file Un elenco dei file il cui stato non è ancora definitivo Se la verifica del formato dà esito positivo e non si sono verificati errori di convalida, è possibile fare clic su "Continua" per richiedere al Page 3 of 12-30/06/2017

5 nostro sistema di procedere all'elaborazione del file. Se si dimentica di fare clic sul pulsante "Continua", il file non viene elaborato e il suo stato resta impostato su "Checked". Quando all'interno del file sono presenti più di 100 transazioni, si visualizza una casella di riepilogo a discesa in cui è possibile selezionare la modalità SYNC (Sincrona) o ASYNC (Asincrona) per l'elaborazione del file: Se si seleziona la modalità SYNC (Sincrona), i risultati di caricamento verranno visualizzati sullo schermo al passaggio successivo, purché il browser in uso non chiuda automaticamente la sessione, trascorso un determinato periodo di tempo (i risultati di caricamento mostrati non sono i risultati di autorizzazione/finanziari con gli acquirenti, in quanto questa parte della procedura è sempre eseguita off line per i caricamenti di file). Nella modalità ASYNC (Asincrona) il caricamento viene eseguito off line e si riceve un' quando il file è stato convalidato dal nostro sistema. La modalità ASYNC (Asincrona) è consigliata per i file che contengono un gran numero di transazioni. Lo screenshot seguente illustra un file contenente un errore di convalida per una transazione (numero di carta di credito non valido). Quando si incontrano errori di convalida è possibile procedere in due modi: Facendo clic sul pulsante "Continua" così che il nostro sistema possa procedere all'elaborazione di file e rispettive transazioni, tenendo presente che le transazioni che presentano un errore di convalida (visualizzate in rosso nell'elenco) non verranno elaborate. Sarà poi necessario creare e inviare un nuovo file, contenente le transazioni in rosso, assicurandosi di aver risolto il problema elencato per ciascuna transazione. Facendo clic su "Annulla" per annullare il file, risolvere gli errori delle transazioni e rinviare il file. Se tutti i problemi sono stati risolti, a questo punto la verifica del formato darà esito positivo e sarà possibile continuare l'elaborazione. Non caricare due volte lo stesso file (a meno che il primo invio non sia stato annullato), neanche se non si è ricevuta risposta dal nostro server. Verificare sempre lo stato del file, prima di procedere con qualsiasi operazione. Page 4 of 12-30/06/2017

6 2.2.3 Fase 3: Risultati del caricamento Al Passaggio 3 elaboriamo il file, ossia importiamo le transazioni nel nostro database e le inviamo agli acquirenti/alle banche. Il risultato dell'importazione delle transazioni nel nostro database è visibile nella pagina "Risultati del caricamento". Modalità SYNC (Sincrona): Nella pagina "Risultati del caricamento"si visualizzano le seguenti informazioni aggiuntive: Il numero delle transazioni e il numero delle transazioni "accettate" (accettate per essere elaborate dal nostro sistema, non i risultati finanziari!). Le transazioni che non sono state elaborate dal nostro sistema a causa di errori di convalida del formato. L'intervallo di PAYID (ID pagamento) delle transazioni. Dopo il Passaggio 3, il file passa allo stato "Loaded" finché tutte le transazioni non sono state inviate agli acquirenti/alle banche e non hanno ricevuto lo stato definitivo da parte di questi ultimi. Dopo di che, lo stato del file passa da "Loaded" a "Processed" ed è possibile consultare gli stati definitivi delle transazioni nel back office. Lo screenshot seguente illustra i risultati di caricamento di un file contenente una transazione rifiutata dal nostro sistema. La transazione non verrà elaborata. Se si desidera elaborare comunque la transazione, sarà necessario creare e inviare un nuovo file, contenente la transazione in rosso, assicurandosi di aver risolto il problema elencato per la transazione. È piuttosto probabile che il numero delle righe di errore al Passaggio 3 sia più elevato rispetto al Passaggio 2, poiché al Passaggio 3 eseguiamo numerose verifiche aggiuntive. Modalità ASYNC (Asincrona): Nella pagina "Risultati del caricamento" non sono fornite informazioni aggiuntive, poiché il file viene caricato off line. Si riceverà un' una volta che il file è stato convalidato dal nostro sistema. Dopo il Passaggio 3, il file passa allo stato "To be loaded" finché tutte le transazioni non sono state caricate, ossia importate nel nostro database. Una volta che tutte le transazioni sono state caricate, il file passa allo stato "Loaded" finché tutte le transazioni non sono state inviate agli acquirenti/alle banche e non hanno ricevuto lo stato definitivo da parte di questi ultimi. Dopo di che, lo stato del file passa da Page 5 of 12-30/06/2017

7 "Loaded" a "Processed" ed è possibile consultare gli stati definitivi delle transazioni nel back office. È anche possibile caricare i file dei pagamenti automaticamente (utilizzando un'applicazione) anziché manualmente (tramite il back office). Consultare la Guida integrativa Batch avanzata per ulteriori informazioni. Page 6 of 12-30/06/2017

8 3. Consultazione dei file caricati È possibile consultare un elenco dei file caricati (manualmente o automaticamente) di recente tramite il collegamento "Visualizza i file" del menu di back office. È possibile consultare i file che non sono più nell'elenco dei file caricati di recente con il pulsante "Altri file". Possibile consultare il riepilogo dei dati dei file, la cronologia finanziaria delle transazioni contenute nel file o scaricare le informazioni sulle transazioni del file (vedere il Capitolo "Download di file") selezionando rispettivamente i pulsanti "Riepilogo", "Dettagli" o "Download". Lo screenshot seguente mostra un esempio di riepilogo dei dati del file e dei risultati delle transazioni. Per ulteriori informazioni, consultare consultazione delle transazioni. I risultati delle transazioni sono definitivi nel momento in cui lo stato del file caricato è impostato su "Processed". 3.1 Alcuni criteri per la consultazione di file La sezione seguente descrive alcuni criteri importanti associati alla consultazione di un file. Per informazioni più dettagliate sulla consultazione dei file, fare clic sul link "Maggiori info" nel menu "Operazioni > Visualizza file" Vari riferimenti file ID file: il riferimento univoco del file specificato dal nostro sistema. Rif vend.: il riferimento file inserito dall'utente all'atto del caricamento del file. Page 7 of 12-30/06/2017

9 3.1.2 Stati dei file Uploaded: il file è stato ricevuto, ma non ancora convalidato. To be checked: il file è in attesa di convalida. Checked: il file è stato convalidato. Cancelled: il file è stato annullato dopo la fase di verifica. To be loaded: il file è in attesa di essere caricato nel nostro modulo di elaborazione (solo in modalità ASYNC (Asincrona)). Being loaded: il caricamento del file nel nostro modulo di elaborazione è in corso. Loaded: il file è stato caricato nel nostro modulo di elaborazione, ma alcuni dei pagamenti non sono ancora stati inviati agli acquirenti/alle banche. Processed: tutti i pagamenti contenuti nel file sono stati inviati agli acquirenti/alle banche Codici Le transazioni del file possono presentare i seguenti codici: ATR: codice per le nuove transazioni. MTR: codice per le operazioni di manutenzione sulle transazioni esistenti. Ogni file che si carica è automaticamente un file ATR, se non è stato specificato diversamente nell'intestazione del file. Page 8 of 12-30/06/2017

10 4. Download di file È possibile scaricare manualmente un file dei pagamenti (risultati delle transazioni) procedendo come segue: Fare clic sul collegamento "Rapporto elettronico" del menu di back office. Selezionare la struttura e il formato file di preferenza. Inserire i criteri di ricerca per i risultati delle transazioni che si desidera scaricare tramite il collegamento "Visualizza le transazioni" o "Storia finansaria" del menu di back office o selezionare il file delle transazioni che si desidera scaricare tramite il collegamento "Visualizza i file" del back office. Fare clic sul pulsante "Scarica elenco". È anche possibile scaricare i file dei pagamenti automaticamente (utilizzando un'applicazione) anziché manualmente (tramite il back office). Per ulteriori informazioni, consultare Batch avanzata. 4.1 Rapporto elettronico Nella pagina Rapporto elettronico è possibile specificare il formato e la struttura che si desidera utilizzare per i report elettronici, per esempio i download di file. Quando nell'account sono attivati i report push, il collegamento dei report elettronici darà accesso a un elenco dei report push dell'utente. A seconda della struttura file, nel download di file verranno visualizzati campi specifici. È possibile scegliere tra strutture di file diverse: Standard Extended File Management Dynamic È anche possibile scegliere tra formati di output diversi: XML Fixed-length Delimited Per la descrizione completa delle strutture di download, consultare la pagina nella sezione Supporto del PostFinance back-office. Ulteriori informazioni sui vari formati di file sono anche disponibili nella Batch avanzata. Consigli: Consigliamo di utilizzare la struttura "Dynamic" e il formato di file "Delimited" (;) con estensione.csv per ottenere un file dei risultati di MS Excel. Per attivare le intestazioni delle colonne nel file dei risultati, abilitare la casella di controllo "Con intestazione di colonna" nella sezione "Altro" della pagina Rapporto elettronico. Page 9 of 12-30/06/2017

11 5. Appendice: Layout dei file Preparare il file tenendo conto delle regole seguenti: I file devono essere file di testo ASCII. Devono contenere una riga per ordine (eccetto per le intestazioni e/o i trailer), le righe devono essere separate da una coppia di caratteri di ritorno a capo e avanzamento riga (ASCII: HEX: 0xD 0xA). I campi devono essere separati da un ";". I campi non possono contenere al proprio interno alcun ";". Panoramica dei campi del file: N. campo Campo Utilizzo 1 AMOUNT L'importo da pagare MOLTIPLICATO PER 100, poiché il formato dell'importo non deve contenere decimali né altri separatori 2 CURRENCY Il codice alfabetico ISO della valuta, per esempio: EUR, USD, GBP, CHF, ecc Nota: per garantire l elaborazione ottimale dei file batch, tutte le valute configurate nell account PostFinance sotto Configurazione > Abbonamento > Valuta devono essere configurate in base al metodo di pagamento utilizzato (Configurazione > Mezzo di pagamento> Dati del contratto). 3 BRAND Il marchio della carta ( Direct Debits NL per Direct Debits NL o informazioni similari per altri metodi di pagamento) 4 CARDNO Il numero della carta/del conto (un numero di conto bancario deve sempre avere 10 cifre: se il conto ha meno di 10 cifre, completi di zeri a sinistra. Per i conti Postbank: digits or P digits) 5 ED La data di scadenza (MM/AA o MMAA) (99/99 or 9999 per Direct Debits NL) 6 ORDERID La data di scadenza (MM/AA o MMAA) (99/99 or 9999 per Direct Debits NL) 7 COM La descrizione dell'ordine 8 CN Il nome del cliente 9 PAYID Il riferimento univoco della transazione del nostro sistema 10 OPERATION La procedura di pagamento configurata alla finestra Parametri globali della transazione, sezione Codice di operazione predefinito, della pagina Informazioni tecniche indicheranno l'operazione predefinita per la transazione. Quando si invia un valore per l'operazione nel campo Operation del batch, esso sovrascriverà il valore predefinito. Consultare la Guida pratica ai parametri per i valori possibili 11 AUTHORIZATION CODE Il codice di autorizzazione, non ricevuto tramite il nostro sistema 12 AUTHORIZATION MODE Il modo in cui è stato ricevuto il codice di autorizzazione al campo 11. Valore possibile: "TEL" per "telefono" Page 10 of 12-30/06/2017

12 13 AUTHORIZATION DATE La data/l'ora in cui è stato ricevuto il codice di autorizzazione al campo 11 (MM/GG/AA HH:MM:SS) 14 PSPID Il nome dell'affiliazione dell'utente nel nostro sistema 15 GLOBORDERID Il riferimento che raggruppa insieme più ordini e consente, in un secondo momento, di richiedere un'operazione congiunta di manutenzione su queste transazioni... Campi vuoti OWNERADDRESS L'indirizzo e il numero civico del cliente 23 OWNERZIP Il CAP del cliente 24 OWNERTOWN Il nome della città del cliente 25 OWNERCTY Il paese del cliente 26 OWNERTELNO Il numero di telefono del cliente 27 CVC Il codice di verifica della carta... Campi vuoti... Electronic Commerce Indicator (Indicatore commercio elettronico). È possibile configurare un valore ECI alla finestra Parametri globali della transazione, sezione Valore ECI per difetto, della pagina Informazioni tecniche. Quando si invia un valore ECI nel campo ECI del batch, esso sovrascriverà il valore ECI predefinito. Valori (numerici) possibili: 35 ECI 0 - Passato in un dispositivo di lettura della banda magnetica (Swiped) 1 - Inserimento manuale 2 - Pagamenti ricorrenti 3 - Pagamenti a rate 7 - E-commerce con codifica SSL 9 - Pagamenti ricorrenti da e-commerce Nota: è possibile anche inviare i campi opzionalmente aggiuntivi se avete attivato alcune opzioni/funzionalità nel tuo account PostFinance. Controllare la documentazione dell'opzione per ulteriori informazioni sui relativi campi aggiuntivi. Intestazioni e trailer: OHL: informazioni di accesso (non necessarie quando si esegue il caricamento manuale dei file). OHF: intestazione contenente i parametri generici del file (necessaria solo quando il codice della transazione è MTR). Formato: OHF;Riferimento file commerciante;codice transazione (ATR/MTR);Operazione;Numero ordini. OTF: trailer di file generico, specificato al termine del file (necessario solo quando nel file è presente un'intestazione). Consultare Batch avanzata per ulteriori informazioni. Esempi: File ATR Page 11 of 12-30/06/2017

13 OHF;File ;ATR;;3; 1000;EUR;; ;11/02;Order0001;;Paul Smith; 100;EUR;; ;11/02;Order0002;; Bill Durand; 2032;EUR;; ;11/02;Order0003;;John Doe; OTF; o 1000;EUR;; ;11/02;Order0001;;Paul Smith; 100;EUR;; ;11/02;Order0002;; Bill Durand; 2032;EUR;; ;11/02;Order0003;;John Doe; File MTR OHF;Nomefile;MTR;SAS;1; 1000;EUR;;;;;;; ; OTF; Page 12 of 12-30/06/2017