Manuale INTERFACCIA DOCFINANCE

Transcript

Manuale INTERFACCIA DOCFINANCE
Addon Integrazione
&
DocFinance
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 1 of 20
Title
Type
Responsible
Project
Date
Documentation/Manuals
Massimo Menzio
MTI SBO DocFinance Integrator
19.05.2008
Issue
Contact
Document
Email [email protected]
Document History
Information
Version
001
002
003
004
005
Section
0
0
0
0
0
Date
19.05.08
27.07.08
06.07.11
03.02.12
31.10.12
Employee
RYF
FOL
RYF
FOL
FOL
Description
Creation
Revisione
Revisione
Revisione
Revisione
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 2 of 20
Table of content
1
Introduzione .......................................................................................................................4
2
Configurazione ...................................................................................................................5
2.1
Percorsi .....................................................................................................................5
2.2
Campi DocFinance ....................................................................................................6
2.2.1
Tracciato scadenziario ...........................................................................................7
2.2.2
Importazione ..........................................................................................................8
2.3
3
Conti ..........................................................................................................................9
Esportazione .................................................................................................................... 10
3.1
Esportazione Anagrafiche ........................................................................................ 11
3.1.1
Esportazione Piano dei Conti ............................................................................... 11
3.1.2
Esportazione Anagrafiche BP............................................................................... 11
3.2
Esportazione Scadenze ........................................................................................... 13
4
Importazione .................................................................................................................... 15
5
Gestione “Sezione aziendale”........................................................................................... 17
6
Appendice ........................................................................................................................ 18
6.1
Campi utente ........................................................................................................... 18
6.2
Campi rilevanti per l’esportazione dei file gestiti in modo particolare ......................... 19
6.3
Eccezioni ................................................................................................................. 20
6.3.1
RollBack transazioni............................................................................................. 20
6.3.2
Documento con saldo aperto negativo .................................................................20
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 3 of 20
1
Introduzione
L’addon MTI-DF Integrator ha lo scopo di integrare le registrazioni effettuate in Sap Business
One con quelle di DocFinance.
Nello specifico, in DocFinance sono trasferite le anagrafiche Business Partner e le scadenze
Clienti e Fornitori; mentre sono importati in Sap Business One i documenti d’incasso,
pagamento e le prime note generate in DocFinance.
L’interfaccia sarà parametrizzabile in modo da coprire tutte le esigenze: si indicheranno i
percorsi per salvare i file, i conti su cui appoggiare le registrazioni, il nome della company in
Doc Finance (che quindi resta del tutto svincolata dai set up SAP), gestione sezione…
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 4 of 20
2
Configurazione
2.1 Percorsi
Indicare al sistema i percorsi dei file di Importazione e di esportazione.
Output folder:
percorso dei file di esportazione.
Input folder:
percorso dove verranno letti i file da importare.
Logfile folder:
percorso dove verranno scritti i file di log e copiati i file di import
dopo che saranno stati importati in SBO.
Logfile name:
nome del logfile.
Si consiglia di creare 3 cartelle differenti in modo da facilitarne la gesione.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 5 of 20
2.2 Campi DocFinance
Inserire i dati necessari per un corretto funzionamento della generazione dei file da
esportare (anagrafiche e scadenze) e per una completa importazione delle registrazioni.
Nome ditta: Tracciato Anagrafiche (posizione 1 - obbligatorio); nome della ditta da
indicare nelle righe del file di esportazione: questo è un campo che dipende dalla
parametrizzazione di DocFinance per cui impostare questo campo come richiesto dal
programma di tesoreria.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 6 of 20
2.2.1
Tracciato scadenziario
Impostazioni legate alla generazione del file di esportazione.
Sezione: Tracciato Scadenze (posizione 171). Indicare se si vuole riempire questo
campo con l’indicazione del progetto ad esse abbinato o senza nessun valore (scelte
possibili: Progetto – Nessuno).
Nel caso si voglia riempire questo campo è possibile accanto a questa impostazione
indiare un valore di default con cui devono essere riempite le scadenze che non hanno
un valore valido di progetto riempito sulla scadenza.
Nr. Titoli: : Tracciato Scadenze (posizione 51 – obbligatorio) Indicare il valore che si
deve obbligatoriamente avere in questo campo del tracciato; se non ci sono diverse
esigenze per la gestione della tesoreria impostare il valore di default 00001
Tipo pagamento: : Tracciato Scadenze (posizione 1 – obbligatorio) indica il tipo di
pagamento previsto per esitare la scadenza; tale valore nelle singole scadenze è legato
alla modalità di pagamento associata alla scadenza. Nel caso in cui non ci sia tale
informazione legata alla scadenza verrà utilizzato il default qui impostato in quanto il
dato è obbligatorio nel tracciato. Utilizzare un valore valido previsto dal programma di
tesoreria.
Esportazione IBAN: è possibile selezionare per quali anagrafiche esportare i dati
relativi all’ IBAN. Valori possibili: tutti (i dati verranno esportate per tutte le anagrafiche
ove presente) - solo esteri (tale dato verrà esportato solo per i BP esteri) – nessuno
(tale dato non verrà mai indicato nel tracciato delle anagrafiche).
Esportazione Ordini/Consegne/Resi: Se selezionato nel tracciato delle scadenze
verranno esportati anche i dati relativi a ordini clienti e fornitori, consegne e resi cliente,
ricevimenti e resi fornitori.
Data Consegna: nel caso si esportino anche i dati di ordini e consegne questo campo
indica da quando il sistema deve partire a calcolare la data scadenza del documento.
Le scelte possibili sono: Data effettiva (considera la data consegna a cui poi applica la
condizione di pagamento) – Fine mese (la partenza del calcolo della scadenza viene
portata alla fine del mese di consegna a cui poi viene applicata la condizione di
pagamento).
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 7 of 20
2.2.2
Importazione
Impostazioni legate alla funzionamento dell’importazione dei dati.
Rollback attivo: Se attivato, durante la fase di importazione sarà presente un
meccanismo di roll-back. Ovvero, prime note e pagamenti verranno scritti in SBO
soltanto se tutte le transazioni previste nel file di import saranno state importate con
successo. In caso di fallimento di una transazione, il database SBO non verrà
modificato: nel caso sia riscontrato un errore non verrà importata nessuna transazione
del file.
Sezione Prima Nota: Tracciato Importazione (posizione 197); indica dove deve essere
contabilizzato il valore che si trova in questo campo nel tracciato delle registrazioni da
importare. E’ possibile contabilizzare tale valore nel campo Progetto o Centro di costo
di SBO oppure non utilizzare tale valore nelle registrazioni contabili che verranno
importate (valori possibili Progetto/Centro di costo/Nessuno). Il valore accanto indica
l’eventuale default che andrà applicato alle registrazioni per le quali non vi è indicazione
della sezione nel file importato.
Causale CoGe: Tracciato Importazione (posizione 63); indicare se il codice indicato nel
file per le importazioni dei movimenti DocFinance va importato nel campo SBO “Codice
transazione” oppure non va importato.
Si ricorda che se questo campo verrà importato sarà necessario aver prima definito i
medesimi codici previsti nel programma di tesoreria anche nei possibili valori che il
campo “Codice transazione” di SBO può assumere.
I valori possibili che si possono definire sono: Codice Transazione oppure Nessuno (in
questo caso il campo non verrà utilizzato nell’importazione).
Importazione RIBA: Indicare se si voglio esportare nel file delle scadenza anche le
partite legate a Ricevute Bancarie Clienti emesse attraverso il programma SBO, questo
per evitare, in base alla gestione del programma di tesoreria, una presenza doppia in
DocFinance delle scadenze legate a Riba.
Valori possibili:
-
Includi inviato, creato e presentato: verranno esportate le scadenze legate a
ricevute bancarie che si trovano in stato inviato, creato e presentato.
-
Includi inviato, creato: verranno esportate le scadenze legate a ricevute bancarie
che si trovano solo in stato inviato e creato.
-
Non Includere: non verranno incluse scadenze legate a Ricevute Bancarie.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 8 of 20
2.3 Conti
Conto transitorio default: dato il diverso funzionamento di SBO rispetto a DocFinance
sarà necessario creare un conto apposta per poter permettere al sistema di
contabilizzare tutti i pagamenti singolarmente (proprio su questo conto transitorio) per
poi creare una prima nota che chiude il transitorio e movimenta il conto corretto
(solitamente il conto banca) .
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 9 of 20
3
Esportazione
L’addon genera due file formato testo secondo le specifiche standard DocFinance contenenti
informazioni che da Sap Business One devono essere trasferiti in DocFinance:
Anagrafiche
Viene generato un unico file contenente le informazioni del Piano dei Conti e dei BP.
Scadenze
Viene generato un file contenente tutte le partite che risultano ancora aperte in Sap
Business One.
Sono trasferite le rate riguardanti i seguenti documenti:
Fattura in uscita
Nota credito in uscita
Fattura in entrata
Nota credito in entrata
Prima nota su BP non legata a documenti precedenti
È inoltre possibile anche esportare i dati relativi ai seguenti documenti (se
opportunamente attivata la configurazione):
Ordini
Consegne/Ricevimenti
Resi
Per quanto concerne le scadenze con Ritenuta d’Acconto queste sono passate al netto
dell’importo della ritenuta come richiesto dalla gestione di DocFinance.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 10 of 20
3.1 Esportazione Anagrafiche
3.1.1
Esportazione Piano dei Conti
Per quanto riguarda il Piano dei conti sono riportate solo le indicazioni di Codice e
Descrizione
3.1.2
Esportazione Anagrafiche BP
Per i BP sono recuperate le principali informazioni inserite in anagrafica.
Vengono sempre esportati i codici di Clienti e Fornitori, mentre i Clienti potenziali
vengono esportati solo se attivato il flag di esportazione ordini nella configurazione del
modulo
I dati legati a Indirizzo/cap/città/provincia e nazione sono recuperati dall’indirizzo di
fatturazione/pagamento di default.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 11 of 20
Rating: ripreso dal campo utente di anagrafica U_Rating (nelle scadenze nel caso in
cui il campo utente sia vuoto verranno utilizzati dei codici di default).
GG Ritardo: ripreso dal campo utente di anagrafica U_GGRitardo.
Voce Finanziaria: dato ripreso dal campo utente di anagrafica U_VoceFin.
Banca e Rbn: Campo utente 4 della tabella della Banca Interna selezionata in
anagrafica BP (vengono presi i primi 12 caratteri: primi 8 dove inserire codice Banca
DocFinance e successivi 4 dove inserire il codice Rbn).
Dati bancari del BP (C/C, ABI, CAB, CIN, PAESE IBAN, CHECK Digit, BIC, IBAN): i
dati bancari vengono recuperati dalla banca di default del BP.
-
CIN, Paese e check degit: sono estrapolati dal codice Iban
-
Bic: recuperato dal campo swift della banca di default, se non inserito è
recuperato dalla tabella banche.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 12 of 20
3.2 Esportazione Scadenze
Tipo Pagamento: vedi paragrafo 2.2.1 della configurazione.
Rating: ripreso dal campo utente di anagrafica U_Rating; nel caso questo non sia
codificato verrà indicato il valore fisso “N”.
Data Valuta: alla data scadenza vengono aggiunti i giorno indicati nel campo utente di
anagrafica BP U_GGRitardo.
Voce Finanziaria: dato ripreso dal campo utente di anagrafica BP U_VoceFin nel caso
questo non sia codificato verranno utilizzati dei codici di default:
0101
Cliente nazionale
0102
Cliente Estero
0201
Fornitore Nazionale
0202
Fornitore Estero
Banca e Rbn: Dati legati alla banca interna della modalità di pagamento associata al
documento; nel caso non siano definite verrà utilizzata la banca interna di anagrafica
BP.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 13 of 20
Dati bancari (C/C, ABI, CAB, CIN, PAESE IBAN, CHECK Digit, BIC, IBAN): i dati
bancari vengono recuperati dalla banca fornitore selezionata sul documento.
Bloccata: Serve nella gestione DocFinance per indicare che la scadenza è bloccata.
Tale campo sarà riempito con “Y” se il documento o il BP è bloccato per il pagamento.
Nr titoli: valore fisso da configurazione [Vedi paragrafo 2.2.1]
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 14 of 20
4
Importazione
I file generati da DocFinance contenenti i movimenti generati da questo programma sono
importati in Sap Business One.
Le importazioni si possono suddividere in 3 tipologie di Documenti che sono creati:
Pagamenti in entrata
Pagamenti in uscita
Prime note.
Premettendo che Sap Business One:
non prevede la possibilità di registrare un unico documento di pagamento per più BP
contemporaneamente
un BP non definito con divisa multipla deve avere tutti i documenti nella valuta definita
in anagrafica; non è quindi consentito creare un pagamento con una contropartita con
una valuta differente
un pagamento non può avere più di una contropartita (non è possibile chiudere una
fattura ed avere come contropartita sia la banca, che le spese, che l’abbuono…..).
I movimenti importati da DocFinance vengono così gestiti:
Per ogni movimento di DocFinance che coinvolge un BP e contiene il riferimento del documento
Sap Business One di origine, viene generato un documento di pagamento: la contropartita
usata per questo movimento è un conto transitorio appositamente creato e definito nella
configurazione iniziale.
Successivamente viene creata una prima nota che chiude il conto transitorio e che contabilizza
tutte le righe presenti nel movimento DocFinance con gli importi in divisa interna e in divisa di
transazione forniti.
In questo modo sarà possibile chiudere la partita del BP con la medesima valuta in cui questa e
stata registrata e contemporaneamente creare un’unica prima nota che movimenta i molteplici
conti contabili eventualmente utilizzati nel movimento di tesoreria.
Eccezione:
Considerando il fatto che DocFinance utilizza un conto transitorio per la creazione delle distinte
di pagamento si è proceduto a gestire all’interno del Piano dei Conti Sap Business One un
nuovo campo utente in cui si andrà ad attribuire la qualifica di “conto transitorio DocFinance” in
modo tale che durante la procedura di importazione dei pagamenti se il sistema verifica che la
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 15 of 20
contropartita del BP è unicamente un conto appartenete a questa tipologia non utilizza il
passaggio a conto transitorio Sap Business One e successiva prima nota ma registra
direttamente come contropartita il conto originario passato da DocFinance.
E’ importante però, anche nelle registrazioni DocFinance utilizzare questo conto transitorio solo
legandolo alle distinte di bonifico e non per altre tipologie di registrazioni.
Per quanto riguarda le registrazioni non legate a documenti SBO viene generata una prima nota
che replica fedelmente il movimento di origine: ciò avviene anche se la registrazione prevede
anche una riga BP ma senza alcun riferimento ad un documento.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 16 of 20
5
Gestione “Sezione aziendale”
Nella Gestione DocFinance sia degli scadenziari che delle prime note è prevista la gestione del
sezionale aziendale; attualmente ci sono diverse parametrizzazioni possibili:
Sezione sulle scadenze:
Si può attualmente scegliere se non gestire questa informazione o se recuperarla dal Progetto
inserito a livello di singolo documento (fattura in entrata/uscita - pagina di contabilità - campo
progetto)
Sezione sulle prime note importate da DocFinance:
Si può attualmente scegliere se non gestire questa informazione, se indicarla nel campo
Progetto o nel campo Centro di Costo (regola di distribuziona) delle singole righe di Prima Nota.
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 17 of 20
6
Appendice
6.1 Campi utente
Verranno creati dall’Add-On i seguenti campi utente:
Piano dei conti – OACT
-
MTF_DF_Treasury (Y/N): Questo campo imposta il conto come un conto di
tesoreria. . [Vedi paragrafo 4].
Anagrafica clienti – OCRD
-
Rating (Alfanumerico): Questo campo è legato all’esportazione del file delle
anagrafiche e delle scadenze. [Vedi paragrafo 3.1 e 3.2].
-
VoceFin (Alfanumerico): Voce finanziaria. Questo campo è legato all’esportazione
del file delle anagrafiche e delle scadenze. [Vedi paragrafo 3.1 e 3.2].
-
GGRitardo (Numerico): Giorni di ritardo. Questo dato verrà esportato nel tracciato
delle anagrafiche Tale dato viene anche utilizzato per il calcolo della data valuta nel
tracciato delle scadenze (la data valuta verrà calcolata come data scadenza + gg
ritardo). [Vedi paragrafo 3.1 e 3.2].
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 18 of 20
6.2 Campi rilevanti per l’esportazione dei file gestiti in modo
particolare
Altri campi rilevanti per l’esportazione dei file sono:
-
Tipo pagamento su scadenze DocFinance.
Il tipo pagamento è un codice previsto nella gestione della tesoreria. Tale campo
nel file verrà impostato in funzione della modalità di pagamento associata alla
scadenza stessa. Se la scadenza avrà impostata la modalità di pagamento il
sistema andrà a recuperare i primi 2 caratteri del campo “chiave” della modalità
stessa (questo poiché il nome associato alla modalità potrebbe non corrispondere
al codice di 2 caratteri previsto nel programma DocFinace: sarà quindi sufficiente al
momento della creazione della modalità andare corrispondente del programma di
tesoreria nel campo “chiave”).
Nel caso non sia associata alcuna modalità alla scadenza oppure nella modalità
non sia definito un valore nel campo verrà indicato il codice impostato nella
configurazione.
-
Banca e Rbn su scadenze e anagrafiche BP: tali campi vengono recuperati dal
campo utente 4 della Banca Interna.
Il codice banca corrisponderà ai primi 8 caratteri codificati nel campo.
Il codice Rbn corrisponderà ai successivi 4 caratteri (dal campo 9 al campo 12).
[Vedi paragrafo 3.1.2 e 3.2].
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 19 of 20
6.3 Eccezioni
6.3.1
RollBack transazioni
Durante l’import del file creato da DocFinance, se una transazione dovesse risultare in
errore, tutti le registrazioni contenute nel file non verranno scritte in SAP.
Il file deve risultare interamente importabile per poter avere un effetto.
Nel log verranno indicati gli errori riscontrati.
6.3.2
Documento con saldo aperto negativo
Nel caso in cui un documento risulti aperto per un importo negativo questo non verrà
esportato e produrrà una segnalazione di errore nella riga del file di esportazione.
Ex: “+-0000..”
MTF Business Solutions SA, Via Cantonale, CH-6928 Manno
T +41 91 610 68 00, F +41 91 610 68 19, www.mtfbs.com, [email protected]
Page 20 of 20