Collmex API: Rückmeldungen

Fehler- und Erfolgsmeldungen

Die komplette Kommunikation findet in einer Datenbank-Transaktion statt. Im Falle eines Fehlers wird die Datenbank-Transaktion zurück gerollt. Das bedeutet, dass entweder alle Änderungen oder gar keine übernommen werden.

Für den Fall, dass es bei der Kommunikation einen Fehler gab, wird ein Fehlersatz zurückgegeben (Meldungstyp 'E').

Wenn es keinen Fehler gab, wird das angeforderte Ergebnis zurückgegeben und als letzte Meldung immer eine Erfolgsmeldung (Meldungstyp 'S', Meldungsnummer 20420, Meldungstext 'Datenübertragung erfolgreich. Es wurden XXX Datensätze verarbeitet.').

NrFeldTypMax.LängeBemerkung
1SatzartC Festwert MESSAGE
2MeldungstypC2'S' = Success
'W' = Warnung
'E' = Fehler
3MeldungsnummerC20Die interne Collmex-Meldungsnummer
4MeldungstextC255-
5ZeileI8Zeilennummer der Upload-Datei, auf die sich die Meldung bezieht.
Rückmeldung von Nummern

Sofern das Programm bei eine Nummer für ein Dokument vergeben hat, wird diese über die Satzart NEW_OBJECT_ID zurückgegeben. Mehr Informationen dazu unter Nummernvergabe.

Beschränkungen / Limits

Pro Tag können unter einer Kundennummer maximal 10.000 API-Aufrufe ausgeführt werden.

Minimieren Sie die Anzahl der Aufrufe, indem Sie die Objekte nicht einzeln, sondern gesammelt abfragen bzw. übergeben und verwenden Sie Benachrichtigungen, um geänderte Daten nur bei Bedarf abzufragen.

Siehe auch: Collmex API Inhalt, Nummernvergabe