Informazioni su questa guida
Questa guida è destinata all’amministratore che configura un prodotto Flow per la propria azienda. Tratta gli aspetti comuni a tutti i prodotti Flow:
- come ottenere l’account e registrare l’azienda,
- l’accesso e la gestione delle password,
- l’area standard Setup (Configurazione) e
- una checklist di primo avvio per ciascun prodotto.
L’uso quotidiano di ciascun prodotto è descritto nella rispettiva Guida utente.
Ogni prodotto Flow si collega a SAP Business One tramite il Service Layer di SAP e condivide la stessa struttura di Setup. Dopo aver configurato un prodotto Flow, gli altri risulteranno familiari.
| Prodotto | Funzione | Ruoli |
|---|---|---|
| CollectFlow | Recupero crediti: lista di lavoro, solleciti, promesse di pagamento, contestazioni, portale clienti | Admin, Manager, Collector |
| RouteFlow | Pianificazione delle consegne, carico in banchina, prova di consegna dell’autista, resi | Admin, Dispatcher, Viewer, Loader |
| StockFlow | Gestione del magazzino su terminali palmari: ricevimento, stoccaggio, prelievo, imballaggio, inventario | Admin, Supervisor, Operator |
| FieldFlow | Assistenza tecnica sul campo: pianificazione degli interventi, app per smartphone del tecnico, fatturazione | Admin, Dispatcher, Technician, Viewer |
| RentalFlow | Noleggio di attrezzature (versione preliminare: solo piattaforma e sedi) | Admin, Manager, Viewer |
| InboxFlow | Documenti di fornitori e clienti ricevuti via email e acquisiti in SAP (versione preliminare) | Admin, Reviewer, Viewer |
1. Prima di iniziare
Tenere a disposizione quanto segue:
- I dati di benvenuto inviati da CSC-WORK. Si tratta di un Install ID, di una chiave API e di un link di registrazione. CSC-WORK li invia al momento della creazione dell’abbonamento.
- Accesso al Service Layer di SAP Business One:
- l’URL del Service Layer, ad esempio
https://sap.yourcompany.com:50000/b1s/v1, - il nome del database della società, ad esempio
SBODEMOUS, - un utente SAP e la relativa password, che il prodotto Flow utilizzerà.
FLOW_SVC), in modo che le registrazioni siano facilmente tracciabili in SAP. - l’URL del Service Layer, ad esempio
- Accesso di rete. Il prodotto Flow deve poter raggiungere il Service Layer tramite HTTPS. Se SAP si trova dietro il firewall aziendale, chiedere a CSC-WORK quali opzioni di connessione sicura sono disponibili.
- Un account email per la posta in uscita (facoltativo, ma consigliato). Sono necessari host SMTP, porta, nome utente e password, in modo che le email ai clienti partano dal proprio indirizzo.
- Il logo aziendale. PNG, JPEG, GIF, WebP o SVG, fino a 512 KB.
Suggerimento: tutti i passaggi di questa guida possono essere eseguiti prima di collegare SAP. Finché una società non è collegata, ogni prodotto mostra dati dimostrativi (chiaramente contrassegnati), così da poterlo provare in sicurezza.
2. Registrazione dell’azienda
CSC-WORK crea l’abbonamento nel proprio Command Center. Si riceve quindi un link di registrazione simile al seguente:
https://<product>.csc-work.com/register?install_id=<your install id>
Per registrarsi:
- Aprire il link di registrazione. Il campo Install ID è già compilato.
- Incollare la API key (chiave API) presente nei dati di benvenuto.
- Inserire il Company name (nome dell’azienda).
Diventa l’indirizzo web dell’azienda (ad esempio Acme Supply →
acme-supply). - Inserire Admin full name e Admin email (nome completo ed email) del primo amministratore, di norma chi sta eseguendo la registrazione. StockFlow richiede anche un Admin username, perché gli utenti dei palmari accedono con un nome utente.
- Fare clic su Create my company.
- La pagina Registered mostra l’email dell’amministratore e una password temporanea. Viene mostrata una sola volta: copiarla subito.
- Fare clic su Sign in to your company.
Una nuova azienda parte con una licenza dimostrativa. È possibile esplorare e configurare tutto; la registrazione effettiva in SAP resta disattivata finché il piano a pagamento non è attivo. Vedere Billing.
3. Accesso
- Aprire l’indirizzo della propria azienda e inserire Email e Password. I palmari StockFlow usano invece uno Username (nome utente).
- Al primo accesso con una password temporanea viene chiesto di Set your password (impostare la password). Inserire la password temporanea, quindi due volte una nuova password di almeno 8 caratteri.
- Single sign-on. CollectFlow e InboxFlow possono
eseguire l’accesso tramite Microsoft Entra, Google o Keycloak, se
l’azienda lo ha richiesto. Se è configurato un solo provider di accesso,
si viene indirizzati direttamente a quello. Aggiungere
?localall’indirizzo di accesso per usare invece una password. - Le sessioni durano al massimo 8 ore. Ogni persona collegata occupa una postazione (seat). Le postazioni contano le persone collegate contemporaneamente, non gli utenti nominativi.
- Password dimenticata?
- Un amministratore può emettere una nuova password temporanea in Setup → Users.
- Se l’amministratore stesso non riesce ad accedere, aprire un ticket su support.csc-work.com. CSC-WORK può inviare un’email di reimpostazione.
- Accesso del supporto. Se il supporto CSC-WORK accede per conto dell’utente per fornire assistenza, un banner in cima a ogni pagina lo segnala.
4. L’area Setup
Fare clic su Setup nella barra superiore. Setup è composta da una fila di schede. Ogni scheda riporta una descrizione di una riga e sono visibili solo le schede consentite al proprio ruolo. Le schede descritte di seguito sono le stesse in tutti i prodotti Flow. Le schede specifiche di ciascun prodotto sono elencate nella sezione 5.
Connections
Collegamento al Service Layer di SAP B1. Solo amministratori.
Nella scheda Connections (Connessioni) fare clic su Add connection e compilare:
| Campo | Cosa inserire |
|---|---|
| Display name | Un nome descrittivo, ad esempio Acme US. È il nome visibile agli utenti. |
| Company DB | Il nome del database della società SAP, ad esempio
SBODEMOUS. |
| Service Layer URL | Ad esempio https://sap.acme.com:50000/b1s/v1. |
| SL username / SL password | L’utente SAP con cui Flow accede. Quando si modifica una connessione in seguito, lasciare vuota la password per mantenere quella attuale. |
| DB platform | HANA o SQL Server. Visualizzato in RouteFlow, StockFlow, FieldFlow e RentalFlow. |
| Effective from / Expires | Facoltativi. Servono a pianificare un passaggio, ad esempio da una società di test alla società produttiva nel giorno dell’avvio. |
| Verify TLS certificate | Lasciarlo attivo. Disattivarlo solo per un server di test con certificato autofirmato. |
| Active | Deselezionarlo per disattivare una connessione senza eliminarla. |
Fare clic su Save connection, quindi su Test. Il test esegue l’accesso al Service Layer e segnala l’esito positivo oppure l’errore SAP esatto.
- Numero di società. Il numero di società SAP collegabili dipende dal valore B1 companies del proprio piano. La barra in alto mostra “N / M slots used”. Per aggiungerne altre, andare in Billing.
- Solo CollectFlow: impostare Keep history from per scegliere fino a quanto indietro nel tempo acquisire le fatture (predefinito: gli ultimi 24 mesi). Quando si riattiva una connessione che contiene ancora dati, viene chiesto se aggiungere a quello storico (Append) oppure ripartire da zero (Start fresh).
- Solo RouteFlow: impostare GL expense account e GL accrual account (conto di costo e conto di rateo Co.Ge.) usati per le registrazioni contabili del chilometraggio.
- Solo FieldFlow: dopo Test, fare
clic su Verify UDFs. Viene verificata l’esistenza del
campo definito dall’utente
U_FF_JobRef. FieldFlow non registra nulla finché il campo non esiste, perché è proprio questo campo a impedire le registrazioni duplicate.
Sync
Acquisizione dei dati anagrafici da SAP. Solo amministratori.
Ciò che la scheda Sync (Sincronizzazione) acquisisce dipende dal prodotto:
| Prodotto | Cosa acquisisce Sync | Modalità |
|---|---|---|
| CollectFlow | Clienti, fatture aperte, note di credito cliente, incassi | Automatica, ogni N minuti (Auto-sync enabled, Interval (minutes), Save schedule). Imposta anche l’Aging basis (base di calcolo dello scaduto): data di scadenza, oppure data documento più un termine standard. |
| RouteFlow | Magazzini SAP → Depots, dipendenti → Drivers, cespiti → Trucks | Selezionare le righe e importarle. I dati di patente e conformità inseriti in RouteFlow non vengono mai sovrascritti. |
| StockFlow | Stato dei dati SAP, delle registrazioni e della coda offline dei palmari | Stato in sola lettura, più Retry now / Discard per il lavoro in coda dei palmari. |
| FieldFlow | Articoli, magazzini, dipendenti e altri dati anagrafici | Refresh from B1. |
| RentalFlow | Magazzini SAP → Locations di noleggio | Selezionare le righe, quindi Import N as locations. |
| InboxFlow | Business partner e relativi referenti | Pianificazione automatica, più Sync now e Full pull. |
Users
Chi può accedere. Solo amministratori (in StockFlow anche i supervisori).
- Nella scheda Users (Utenti) fare clic su Add user (in alcuni prodotti si chiama Create user).
- Inserire Full name, Email e Role (nome completo, email e ruolo).
- Lasciare vuota la Password per generare una password temporanea. Viene mostrata una sola volta: copiarla e consegnarla alla persona interessata, che dovrà cambiarla al primo accesso.
- Per impedire a qualcuno di accedere, deselezionare Active o fare clic su Deactivate. La sua cronologia viene conservata.
Alcuni prodotti prevedono campi aggiuntivi:
| Prodotto | Opzioni utente aggiuntive |
|---|---|
| CollectFlow | Manager (il responsabile a cui riferisce un addetto al recupero crediti); Sales-rep access, che collega gli addetti vendite SAP agli utenti con un livello di accesso None, View only, Light o Full. |
| RouteFlow | Handheld PIN (4–8 cifre) e Badge code per gli addetti al carico; indicatore di approvatore dei Returns (resi); elenco Handheld devices (l’accesso con PIN e badge funziona solo su un dispositivo registrato); Unlock PIN dopo 5 tentativi errati. |
| StockFlow | Username per il palmare; Zones (vuoto = tutte); attrezzature e certificazioni; Badge; impostazioni di lavoro personali. |
| FieldFlow | Consumes a seat. I tecnici usano postazioni field (campo); tutti gli altri usano postazioni office (ufficio). |
Branding
Logo e nome dell’azienda su email e documenti. Solo amministratori.
Nella scheda Branding (Personalizzazione grafica) fare clic su Upload logo (PNG, JPEG, GIF, WebP o SVG, massimo 512 KB). Per cambiarlo in seguito usare Replace logo o Remove.
In CollectFlow, InboxFlow e RouteFlow è possibile impostare nome e logo per ciascuna società SAP. RouteFlow imposta inoltre, per ogni società, il nome del mittente, l’indirizzo del mittente e l’indirizzo di risposta. In questo modo i clienti vedono la società corretta su ogni comunicazione.
Email SMTP
Il server di posta attraverso cui passano le email. Solo amministratori.
| Campo | Valore tipico |
|---|---|
| SMTP host | smtp.office365.com, smtp.gmail.com o il
proprio server |
| Port | 587 con STARTTLS (il più comune), 465 con SSL oppure 25 senza crittografia |
| Username / Password | L’account della casella di posta. Per Microsoft 365 o Google è spesso una password per le app. |
| From address / From name | Ciò che vedono i clienti, ad esempio accounts@acme.com
/ Acme Accounts |
| Signature (HTML) | Aggiunta alle email di sistema |
Fare clic su Save, quindi usare Send test email per inviare a se stessi un messaggio di prova. Se i dati SMTP vengono lasciati vuoti, la posta viene inviata tramite il server predefinito di CSC-WORK.
- Solo RouteFlow: un interruttore Demo mode invia tutte le email destinate ai clienti a un elenco di destinatari di prova anziché ai clienti reali. Usarlo durante la fase di test.
- Solo CollectFlow: ogni società SAP può avere un proprio SMTP (Set up company SMTP).
Email templates
Il testo di ogni email. Amministratori e, a seconda del prodotto, manager, dispatcher, supervisori o revisori.
Nella scheda Email templates (Modelli email) ogni tipo di email ha un testo predefinito (Default) modificabile:
- Fare clic su un modello per aprirlo.
- Modificare Subject e Body (HTML)
(oggetto e corpo). Fare clic su un token (ad esempio
{customer_name}o{invoice_number}) per inserirlo. - Fare clic su Preview with sample data per vedere il risultato, oppure su Send test per inviarlo a se stessi via email.
- Fare clic su Save. Revert to default ripristina il testo predefinito.
Billing
Licenza, piano, postazioni e pagamento. Solo amministratori.
- Pannello della licenza: nella scheda Billing (Fatturazione) mostra il piano (livello), le postazioni, le società SAP e la data di scadenza. Usare Refresh per recuperare la licenza più recente, oppure Renew now.
- Profilo di fatturazione: ragione sociale, email di fatturazione, indirizzo e partita IVA. Questi dati compaiono sulle fatture.
- Subscribe: scegliere un Service level (Starter / Mid-Market / Enterprise), il numero di Seats e di B1 companies, la fatturazione mensile o annuale, e inserire una carta.
- Change service level o add seats in qualsiasi momento. Le modifiche vengono calcolate pro rata.
- Licenza offline: se il server non può raggiungere Internet, incollare il file di licenza inviato da CSC-WORK e fare clic su Verify & apply (StockFlow: Install licence).
FieldFlow mostra la licenza in sola lettura; postazioni e rinnovi si concordano tramite Support. Gli abbonamenti InboxFlow si concordano tramite Support mentre viene introdotta la tariffazione per singolo flusso.
Support
Ticket, risposte e videochiamate con CSC-WORK. Tutti i ruoli.
- Nella scheda Support (Assistenza) fare clic su New ticket (oppure compilare Open a support ticket).
- Descrivere l’accaduto, scegliere una Priority (Low, Medium, High o Urgent) e allegare eventuali schermate.
- Fare clic su File ticket.
- Le risposte compaiono nella conversazione del ticket. Rispondere lì, oppure fare clic su Join call per una videochiamata con condivisione dello schermo.
- Usare Close ticket quando il problema è risolto. Rispondere a un ticket chiuso lo riapre.
Gli amministratori vedono tutti i ticket dell’azienda; gli altri utenti vedono solo i propri. Il supporto è raggiungibile anche su support.csc-work.com.
5. Schede di Setup specifiche per prodotto
Ogni prodotto aggiunge alcune schede proprie accanto a quelle standard.
| Prodotto | Schede aggiuntive |
|---|---|
| CollectFlow | Assign: assegnare ogni cliente a un addetto al recupero crediti. Integrations: casella IMAP, Gmail, Google Calendar e provider di pagamento (PayPal, Braintree, Square, Authorize.Net, Stripe). |
| RouteFlow | SAP Setup: quando vengono registrati Consegne e Resi, la mappa dei conti Co.Ge., le regole per gli incassi in contanti, il carico verificato tramite scansione, il tabellone di magazzino, la consegna tramite scansione e le regole per le merci pericolose. Payment providers: Stripe e PayPal per gli addebiti su carta. System: licenza e livello, tolleranza di puntualità, accesso degli autisti e app di navigazione. |
| StockFlow | My setup: per ciascun terminale, fotocamera, voce, suoni e dimensione del testo. Site: per ciascun magazzino, come arriva il lavoro e quando vengono registrate le scansioni. |
| FieldFlow | Vans: magazzini dei furgoni e scorta minima. Technicians: dipendenti SAP, tariffe e chi guida quale furgone. Equipment: beni con contatore e intervalli di manutenzione. Job templates: checklist e ricambi. Invoicing: articoli di manodopera, a prezzo fisso e di spesa, e listino prezzi. Integrations: gateway di pagamento. |
| InboxFlow | Mailboxes: caselle IMAP e Google Workspace da leggere. |
La Guida utente di ciascun prodotto illustra queste schede.
6. Checklist di primo avvio
Seguire l’elenco relativo al proprio prodotto, dall’alto verso il basso.
CollectFlow
- Connections → aggiungere, Test.
- Sync → attivare la sincronizzazione automatica, scegliere la base di calcolo dello scaduto.
- Users → aggiungere manager e addetti al recupero crediti; configurare l’accesso degli addetti vendite.
- Assign → assegnare un addetto a ogni cliente.
- Branding, Email SMTP, Email templates.
- Billing → sottoscrivere l’abbonamento.
RouteFlow
- Connections → aggiungere, Test, impostare i conti Co.Ge.
- Sync → importare depositi, autisti e camion.
- SAP Setup → criteri di registrazione, regole per i contanti, flusso di carico, merci pericolose.
- Users → dispatcher, addetti al carico (PIN o badge); registrare i palmari della banchina.
- Fleet → associare lo smartphone di ciascun autista.
- Branding, Email SMTP (iniziare in modalità demo), Email templates.
- Billing.
StockFlow
- Connections → aggiungere, Test.
- Site → per ciascun magazzino, come arriva il lavoro e quando vengono registrate le scansioni.
- Users → operatori (nome utente, zone, badge) e supervisori.
- Su ogni palmare: accedere una volta, quindi My setup.
- Branding, Email SMTP, Email templates.
- Billing → registrare l’installazione e sottoscrivere l’abbonamento.
FieldFlow
- Connections → aggiungere, Test, Verify UDFs.
- Sync → Refresh from B1.
- Vans → aggiungere i furgoni e la scorta minima.
- Technicians → aggiungere i tecnici, quindi Who drives what.
- Job templates, Invoicing.
- Users, Branding, Email SMTP, Email templates, Integrations (pagamenti).
RentalFlow
- Billing → scegliere un piano.
- Connections → aggiungere, Test.
- Sync → importare i magazzini come sedi.
- Users, Branding, Email SMTP, Email templates.
InboxFlow
- Connections → aggiungere, Test.
- Sync → pianificare la sincronizzazione dei business partner.
- Mailboxes → aggiungere la casella di posta da leggere.
- Users → revisori e utenti in sola visualizzazione.
- Branding, Email SMTP, Email templates.
7. Risoluzione dei problemi
| Sintomo | Cosa verificare |
|---|---|
| Test non riesce con un errore di certificato | Il Service Layer usa un certificato autofirmato. Installare un certificato valido oppure (solo per i sistemi di test) deselezionare Verify TLS certificate. |
| Test non riesce con “401” o “Fail to get DB credentials” | Verificare utente SAP, password e Company DB. L’utente deve disporre in SAP della licenza per il Service Layer. |
| Test va in timeout | Il prodotto non riesce a raggiungere SAP. Verificare l’URL, la porta (di norma 50000) e il firewall. |
| Il contrassegno “Demo data” è ancora visibile | Nessuna connessione attiva. Verificare Active e la data Effective from. |
| Nessuna registrazione arriva in SAP | È attiva la licenza dimostrativa. Verificare Billing e fare clic su Refresh. |
| “At billed cap” quando si aggiunge una connessione | Aggiungere B1 companies in Billing. |
| “No seats available” all’accesso | Tutte le postazioni sono in uso. Chiedere a qualcuno di disconnettersi oppure aggiungere postazioni in Billing. |
| Le email non arrivano | Email SMTP → Send test email. Controllare le cartelle di posta indesiderata e le regole sulle password per le app del proprio provider di posta. In RouteFlow verificare che Demo mode sia disattivato. |
| Utente bloccato | Un amministratore emette una nuova password temporanea in Users (RouteFlow: Unlock PIN). |