Importa i tuoi dati automaticamente → tramite FTPs (FTP protetto)

Assistenza online

Automatic import »
How to import your data automatically?

Translate this page to

Caricamento in corso...

Per usufruire di questa interfaccia, utilizza uno script che invierà ogni notte (ad esempio) o più volte al giorno i tuoi file relativi a documenti, clienti, utenti (opzionale) e contatti (opzionale) al nostro server.

Questo programma dovrà inviare file CSV o TXT (file separati da virgole nei dati POST) utilizzando gli identificativi, gli indirizzi e le sintassi riportati di seguito:

Accedi al tuo account tramite la nostra API

Per connetterti, utilizza questo login e password:

Indirizzo / URL:

https://account.mydsomanager.com/api/

Devi essere connesso per vedere queste informazioni

Esempio « Headers »

POST ...
...
Authorization: Devi essere connesso per vedere queste informazioni
...

Opzioni dell'importazione

Utilizza queste opzioni solo in caso di bisogno:

Impostazioni	API	Descrizione
encoding	all	Formato file Valori possibili: UTF-8 (predefinito), ISO-8859-1, ...
clear_items_not_modified	items	Saldare automaticamente i documenti? Valori possibili: true:Modalità « STOCK » → Importo sistematicamente tutti i documenti non saldati (fatture, note di credito, operazioni varie, non ancora registrati e saldati). In questo caso, se un documento è presente durante un'importazione ma non lo è più nella seguente importazione, MY DSO MANAGER lo salderà automaticamente. false:Modalità « DELTA » → Importiamo tutti i nuovi documenti (fatture, note di credito, operazioni varie, non ancora registrati e saldati) emessi dall'ultima importazione, nonché tutti quelli che sono stati saldati. Questi ultimi hanno il campo 'item_date_payment' compilato con la data in cui ogni documento è stato saldato nel sistema contabile. Ciò consentirà a MY DSO MANAGER di saldarli anch'essi. Predefinito: false
replace_users_association	users	Sostituisci le associazioni clienti/utenti o aggiungi unicamente le nuove associazioni clienti/utenti? Valori possibili: 0 o 1 Predefinito: 0

Esempio « Headers » e « Data »

POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

Aggiungi e modifica i tuoi documenti (fatture, note di credito, ecc.)

Indirizzo / URL: https://account.mydsomanager.com/api/items

Utilizza SSL per proteggere le connessioni

Sintassi delle colonne del file CSV:

Colonne	Descrizione
client_code *	Codice società
item_amount_initial	Importo iniziale senza IVA
item_amount_initial_inc_tax *	Importo iniziale con IVA Esempio / Valori possibili: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Importo senza IVA
item_amount_remaining_inc_tax	Importo con IVA
item_business_case	Nome dell'affare
item_currency	Valuta Esempio: EUR, USD, ...
item_date_due *	Data di scadenza Formato di data: YYYY-MM-DD
item_date_issue *	Data di emissione Formato di data: YYYY-MM-DD
item_date_order	Data dell'ordine Formato di data: YYYY-MM-DD
item_date_payment	Data pagamento Formato di data: YYYY-MM-DD
item_erp_type	Tipo di documento ERP
item_file_number	N°caso
item_number *	N° documento
item_order_number	N° ordine
item_sales_administrative	Direttore di mercato
item_sales_manager	Responsabile commerciale
item_type *	Tipo di documento Valori possibili: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Identificatore documento unico

Esempio « Headers » e « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Devi essere connesso per vedere queste informazioni
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2026-03-14";"2026-03-21";"6 580,10";"USD"
...

Colonne obbligatorie : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Aggiungi e modifica i tuoi clienti

Indirizzo / URL: https://account.mydsomanager.com/api/clients

Utilizza SSL per proteggere le connessioni

Sintassi delle colonne del file CSV:

Colonne	Descrizione
client_address_city	Indirizzo (Città)
client_address_country	Indirizzo (Paese)
client_address_postbox	Indirizzo (Casella postale)
client_address_state	Indirizzo (Stato / Provincia)
client_address_street	Indirizzo (Via)
client_address_street_line2	Indirizzo (Via Linea 2)
client_address_street_line3	Indirizzo (Via Linea 3)
client_address_street_number	Indirizzo (n° Via)
client_address_zip	Indirizzo (Cap)
client_blocked	Account bloccato (Sì / No) Valori possibili: 0, 1 (predefinito: 0 <=> No)
client_blocked_date	Account bloccato / Data Formato di data: YYYY-MM-DD
client_business_line	Mercato
client_business_name *	Ragione sociale
client_code *	Codice società
client_comments	Commenti
client_commercial_email	Responsabile vendite associato al cliente / E-mail
client_commercial_fax	Responsabile vendite associato al cliente / Fax
client_commercial_firstname	Responsabile vendite associato al cliente / Nome
client_commercial_lastname	Responsabile vendite associato al cliente / Cognome
client_commercial_matricule	Responsabile vendite associato al cliente / Numero ID
client_commercial_phone	Responsabile vendite associato al cliente / Telefono
client_commercial_phone_cell	Responsabile vendite associato al cliente / Cellulare
client_credit_limit	Rischio / Limite di fido
client_email	E-mail
client_fax	Fax
client_group	Gruppi Lista dei gruppi del cliente separati da virgole
client_guarantee_insurer	Rischio / Copertura assicurativa
client_guarantee_insurer_reference	Rischio / Referenza dell'assicuratore
client_guarantee_score	Rischio / Rating dell'assicuratore
client_guarantee_temporary	Rischio / Garanzia temporanea
client_guarantee_temporary_date_end	Rischio / Garanzia temporanea / Data di fine
client_guarantee_temporary_date_start	Rischio / Garanzia temporanea / Data di inizio
client_guarantee_type	Rischio / Tipo di copertura
client_guarantees_currency	Rischio / Valuta delle garanzie
client_id	Codice fiscale dell'impresa
client_order_backlog	Portafoglio delle ordinazioni
client_others_guarantees	Rischio / Altre coperture
client_payment_mean	Modalità di pagamento
client_payment_term	Termine di pagamento
client_phone	Telefono
client_phone_cell	Cellulare
client_siret	Siret (per le aziende francesi)
client_trading_name	Insegna commerciale
client_unique_key	Identificatore cliente unico
client_url	Sito web
client_vat	Numero di partita IVA

Esempio « Headers » e « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Devi essere connesso per vedere queste informazioni
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...

Colonne obbligatorie : client_code + client_business_name

Aggiungi i contatti ai tuoi clienti

Indirizzo / URL: https://account.mydsomanager.com/api/contacts

Utilizza SSL per proteggere le connessioni

Sintassi delle colonne del file CSV:

Colonne	Descrizione
client_code *	Codice società
contact_collection	Contatto per la riscossione (Sì / No) Valori possibili: 0, 1 (predefinito: 0 <=> No)
contact_comments	Commenti
contact_email	E-mail
contact_email_copy_collection_auto	Email in copia nelle email automatiche (Sì / No) Valori possibili: 0, 1 (predefinito: 0 <=> No)
contact_fax	Fax
contact_firstname	Nome
contact_lastname *	Cognome
contact_phone	Telefono
contact_phone_cell	Cellulare
contact_role	Ruolo Valori possibili: accounting: Contabile buyer: Compratore company: Società manager: Amministratore delegato other: Altro (predefinito)
contact_title	Titolo (Sig., Sig.ra. ...)
contact_unique_key	Identificatore contatto unico

Esempio « Headers » e « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Devi essere connesso per vedere queste informazioni
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...

Colonne obbligatorie : client_code + contact_lastname

Associa gli utenti ai tuoi clienti

Indirizzo / URL: https://account.mydsomanager.com/api/users

Utilizza SSL per proteggere le connessioni

Sintassi delle colonne del file CSV:

Colonne	Descrizione
client_code *	Codice società
user_email	E-mail
user_firstname	Nome
user_lastname *	Cognome
user_matricule	Numero ID

Esempio « Headers » e « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Devi essere connesso per vedere queste informazioni
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...

Colonne obbligatorie : client_code + user_lastname

If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

Dati di ritorno

Dopo aver effettuato il POST di questi dati, MY DSO MANAGER li elaborerà immediatamente e risponderà se ci sono stati errori o quanti dati sono stati aggiunti e modificati.

La risposta sarà nel formato JSON e conterrà le seguenti informazioni:

Campo	Descrizione
success	Indica se l'importazione è stata eseguita correttamente Valori possibili: true, false
error_code	Codice di errore (in caso di errore) Valori possibili: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Messaggio di errore (in caso di errore)
exception_lines	Righe ignorate (non definito se nessuna riga ignorata)
nb_client_added	Clienti aggiunti
nb_client_modified	Clienti modificati
nb_contact_added	Contatti aggiunti
nb_item_added	Documenti aggiunti
nb_item_modified	Documenti modificati
nb_user_added	Utenti aggiunti
nb_user_modified	Utenti modificati

Esempio « Response »

{
	"success": "true",
	"nb_client_added": 0,
	"nb_client_modified": 0,
	"nb_contact_added": 0,
	"nb_item_added": 5,
	"nb_item_modified": 2,
	"nb_user_added": 0,
	"nb_user_modified": 0,
	"exception_lines": {
		"line 3": "Column count doesn't match (defined=8, found=10)",
	},
}

Importa automaticamente i tuoi dati tramite FTPs o SFTP!

Questo programma dovrà inviare file CSV o TXT (file separati da virgole nei dati POST) utilizzando gli identificativi, gli indirizzi e le sintassi riportati di seguito:

How FTPs and SFTP works with My DSO Manager

Compatibile con molti software: SAP

...

Accedi al tuo account tramite FTP protetto o connettiti per utilizzare SFTP

Per connetterti, utilizza questo login e password:

Impostare:

Utilizza gli stessi file CSV che utilizzi durante l'importazione manuale « Smart Upload »
Nominali in modo che MY DSO MANAGER sappia che tipi di file è state inviato
(i file Clienti devono iniziare con "clienti", i file Documenti con "documenti" e i file Contatti con "contatti")
Invia questi file
I dati sono elaborati all'istante e aggiornati nel tuo account. Il file che hai inviato è sostituito da un file rapporto che indica che tutto è andato bene e quante modifiche sono state apportate.

Anteprima utilizzando il software FileZilla per trasferire i tuoi file:

Questa anteprima mostra una importazione manuale ma potrai automatizzarla creando uno script che invia i file CSV.

Come automatizzare l'invio tramite FTP protetto:

Invia tramite curl (Windows, Linux):

curl -u login:password ftp://ftp.mydsomanager.com:21 --ftp-ssl --ftp-pasv -T clients.csv

Invia tramite LFTP (Linux, Windows via cygwin):

lftp -e "set ftp:prefer-epsv no; put clients.csv; quit" -u login,password ftp.mydsomanager.com

Invia tramite WinSCP (Windows):

winscp.com /ini=nul /command "open ftpes://login:password@ftp.mydsomanager.com/" "put clients.csv" "exit"

Grazie ai nostri connettori, potrai importare i dati clienti e contabili (fatture, note di credito, ecc.) in modo semplice e automatico!

Per farlo, seleziona il tuo software di gestione e segui le istruzioni di seguito per sincronizzare i dati con My DSO Manager alla frequenza desiderata (tutti i giorni, tutte le settimane o manualmente).