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

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