Lädt...
Online-Hilfe
Bei Fragen stehen wir Ihnen gerne zur Verfügung

Automatic import »

How to import your data automatically?

Translate this page to DeutschDeutsch ?
Lädt...
Um von diesem Interface profitieren, nutzen Sie ein Skript, das (zum Beispiel) jede Nacht oder mehrmals am Tag Ihre Buchungsposten-, Kunden-, Benutzer- (optional) und Kontaktdateien (optional) an unseren Server sendet.
Dieses Programm muss mithilfe der unten angegegebenen Kennungen, Adressen und Syntaxen CSV- oder TXT-Dateien senden (mit Semikolon getrennte Dateien in den POST-Daten):
how api works

Anmeldung bei Ihrem Konto über unsere API

Verwenden Sie dieses Login und dieses Passwort, um sich anzumelden:
Adresse / URL:
https://account.mydsomanager.com/api/
Sie müssen angemeldet sein, um diese Informationen anzusehen
Beispiel « Headers » 
POST ...
...
Authorization: Sie müssen angemeldet sein, um diese Informationen anzusehen
...

Optionen Import

Nutzen Sie diese Optionen nur, wenn Sie sie brauchen:
Parameter API Beschreibung
encoding all Dateiformat
Mögliche Werte: UTF-8 (standardmäßig), ISO-8859-1, ...
clear_items_not_modified items Buchungsposten automatisch begleichen?
Mögliche Werte:
  • true:« STOCK » Modus → Ich importiere systematisch alle nicht beglichenen Buchungsposten (Rechnungen, Gutschriften, verschiedene Transaktionen … noch nicht ausgeziffert und beglichen). Wenn in diesem Fall ein Buchungsposten bei einem Import vorhanden ist und beim darauf folgenden nicht mehr vorhanden ist, dann begleicht MY DSO MANAGER ihn automatisch.
  • false:« DELTA » Modus → Ich importiere alle neuen Buchungsposten (Rechnungen, Gutschriften, verschiedene Transaktionen … noch nicht ausgeziffert und beglichen), die seit dem letzten Import erstellt wurden, sowie alle, die beglichen wurden. Bei letzteren ist das Feld "item_date_payment" mit dem Datum, an dem jeder Buchungsposten im Buchhaltungssystem beglichen wurde, ausgefüllt. Das ermöglicht es MY DSO MANAGER , sie ebenfalls zu begleichen.
Standardmäßig: false
replace_users_association users Kunden/Benutzer-Zuordnungen ersetzen oder nur neue Kunden/Benutzer-Zuordnungen hinzufügen?
Mögliche Werte: 0 oder 1
Standardmäßig: 0
Beispiel « Headers » und « Data » 
POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

Ihre Buchungsposten (Rechnungen, Gutschriften usw.) hinzufügen oder bearbeiten

Nutzen Sie SSL zum Schutz Ihrer Anmeldungen
Spaltensyntax der CSV-Datei:
Spalten Beschreibung
client_code * Kundennummer
item_amount_initial Rechnungsbetrag exkl. MwSt
item_amount_initial_inc_tax * Rechnungsbetrag inkl. MwSt
Beispiel / Mögliche Werte:
  • 1200
  • 1 200,00
  • 1200.00123
  • ...
item_amount_remaining Offener Betrag exkl. MwSt
item_amount_remaining_inc_tax Offener Betrag inkl. MwSt
item_business_case Geschäftsfall
item_currency Währung
Beispiel: EUR, USD, ...
item_date_due * Fälligkeitsdatum
Datumsformat: YYYY-MM-DD
item_date_issue * Rechnungsdatum
Datumsformat: YYYY-MM-DD
item_date_order Auftragsdatum
Datumsformat: YYYY-MM-DD
item_date_payment Zahlungsdatum
Datumsformat: YYYY-MM-DD
item_erp_type ERP-Elemententyp
item_file_number Auftragsnummer
item_number * Re.-Nummer
item_order_number Bestellnummer
item_sales_administrative Administrationsmitarbeiter
item_sales_manager Verkaufsmanager
item_type * Art des BuchungspostenLink
Mögliche Werte: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key Identifikator spezifischer Buchungsposten
Beispiel « Headers » und « Data » 
POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Sie müssen angemeldet sein, um diese Informationen anzusehen
...

"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"
...
Spalten obligatorisch : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Ihre Kunden hinzufügen oder bearbeiten

Nutzen Sie SSL zum Schutz Ihrer Anmeldungen
Spaltensyntax der CSV-Datei:
Spalten Beschreibung
client_address_city Adresse (Ort)
client_address_country Adresse (Land)
client_address_postbox Adresse (Postfach)
client_address_state Adresse (Bundesland)
client_address_street Adresse (Straße)
client_address_street_line2 Adresse (Straße Leitung 2)
client_address_street_line3 Adresse (Straße Leitung 3)
client_address_street_number Adresse (n° Straße)
client_address_zip Adresse (PLZ)
client_blocked Konto gesperrt (Ja / Nein)
Mögliche Werte: 0, 1 (standardmäßig: 0 <=> Nein)
client_blocked_date Konto gesperrt / Datum
Datumsformat: YYYY-MM-DD
client_business_line Branche
client_business_name * Firmenname
client_code * Kundennummer
client_comments Kommentare
client_commercial_email Verkaufsmanager / Email
client_commercial_fax Verkaufsmanager / Fax
client_commercial_firstname Verkaufsmanager / Vorname
client_commercial_lastname Verkaufsmanager / Nachname
client_commercial_matricule Verkaufsmanager / Kennnummer
client_commercial_phone Verkaufsmanager / Telefon
client_commercial_phone_cell Verkaufsmanager / Mobiltelefon
client_credit_limit Risiko / Kreditlimit
client_email Email
client_fax Fax
client_group Gruppen
Liste der Kundengruppen, mit Kommas getrennt
client_guarantee_insurer Risiko / Garantie des Versicherers
client_guarantee_insurer_reference Risiko / Versicherungsreferenz
client_guarantee_score Risiko / Rating Creditreform
client_guarantee_temporary Risiko / Temporäre Garantie
client_guarantee_temporary_date_end Risiko / Temporäre Garantie / Enddatum
client_guarantee_temporary_date_start Risiko / Temporäre Garantie / Startdatum
client_guarantee_type Risiko / Garantietyp
client_guarantees_currency Risiko / Währung der Garantien
client_id LEI-Code
client_order_backlog Auftragsportfolio
client_others_guarantees Risiko / Andere Garantien
client_payment_mean Zahlungsmittel
client_payment_term Zahlungsfrist
client_phone Telefon
client_phone_cell Mobiltelefon
client_siret Siret
(für französische Unternehmen)
client_trading_name Handelsname
client_unique_key Spezifischer Benutzername
client_url Webseite
client_vat Steuernummer
Beispiel « Headers » und « Data » 
POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Sie müssen angemeldet sein, um diese Informationen anzusehen
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...
Spalten obligatorisch : client_code + client_business_name

Kontakte zu Ihren Kunden hinzufügen

Nutzen Sie SSL zum Schutz Ihrer Anmeldungen
Spaltensyntax der CSV-Datei:
Spalten Beschreibung
client_code * Kundennummer
contact_collection Kontakt für Mahnungen (Ja / Nein)
Mögliche Werte: 0, 1 (standardmäßig: 0 <=> Nein)
contact_comments Kommentare
contact_email Email
contact_email_copy_collection_auto E-Mail in Kopie bei automatischen E-Mails (Ja / Nein)
Mögliche Werte: 0, 1 (standardmäßig: 0 <=> Nein)
contact_fax Fax
contact_firstname Vorname
contact_lastname * Nachname
contact_phone Telefon
contact_phone_cell Mobiltelefon
contact_role Rolle
Mögliche Werte:
  • accounting: Buchhalter
  • buyer: Kunde
  • company: Firma
  • manager: Geschäftsleiter
  • other: Andere (standardmäßig)
contact_title Anrede (Herr, Frau ...)
contact_unique_key Spezifischer Login
Beispiel « Headers » und « Data » 
POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Sie müssen angemeldet sein, um diese Informationen anzusehen
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...
Spalten obligatorisch : client_code + contact_lastname

Benutzer Ihren Kunden zuordnen

Nutzen Sie SSL zum Schutz Ihrer Anmeldungen
Spaltensyntax der CSV-Datei:
Spalten Beschreibung
client_code * Kundennummer
user_email Email
user_firstname Vorname
user_lastname * Nachname
user_matricule Kennnummer
Beispiel « Headers » und « Data » 
POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Sie müssen angemeldet sein, um diese Informationen anzusehen
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...
Spalten obligatorisch : client_code + user_lastname
If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

Zurückgegebene Daten

Nach der Ausführung der POST-Anfrage dieser Daten verarbeitet MY DSO MANAGER diese sofort und antwortet, falls es einen Fehler gab oder wie viele Daten hinzugefügt und bearbeitet wurden.
Diese Antwort wird im JSON-Format vorliegen und gibt die folgenden Informationen zurück:
Bereich Beschreibung
success Gibt an, ob der Import erfolgreich durchgeführt wurde
Mögliche Werte: true, false
error_code Fehlercode (falls es einen Fehler gab)
Mögliche Werte: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description Fehlermeldung (falls es einen Fehler gab)
exception_lines Ignorierte Linien (nicht definiert, wenn keine Linie ignoriert wurde)
nb_client_added Kunden hinzugefügt
nb_client_modified Kunden aktualisiert
nb_contact_added Kontakte hinzugefügt
nb_item_added Buchungsposten hinzugefügt
nb_item_modified Buchungsposten aktualisiert
nb_user_added Benutzer hinzugefügt
nb_user_modified Benutzer geändert
Beispiel « 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)",
	},
}
← Zurück : Online-Hilfe » Diverse Fragen