Caricamento in corso...
Assistenza online
Per qualsiasi domanda, contattaci

Automatic import »

How to import your data automatically?

Translate this page to ItalianoItaliano ?
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:
how api works

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.)

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 documentoLink
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-04-29";"2026-05-06";"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

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

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

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)",
	},
}
← Indietro : Assistenza online » Problemi vari