fetchSuppliers

Navigation:  WebService Calls > Options for Growth >

fetchSuppliers

Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Abfrage von Lieferantendaten.

Beispiel Request

Code

Feldliste Request

Name

Beschreibung        

Anz.

Typ

sonstiges

request

Root-Element der Anfrage

1

Element


method

Attribut von request. Name der Webservice-Methode.

1

string

Fester Wert:

„fetchSuppliers“

version

Attribut von request. Legt die Version der Anfrage fest.

1

integer

Fester Wert:

„1.0.0“

filter

Legt Parameter fest nach denen die Ergebnismenge eingeschränkt wird. Mehrere Filter werden als ODER-Verknüpfung, Elemente innerhalb des Filters als UND-Verknüpfung behandelt.

1..N

Element


supplier_id

Schränkt die Ergebnismenge der Abfrage auf einen bestimmten Lieferanten ein.

1

Element


filter_method

Attribut von supplier_id. Legt das Verhalten des Lieferanten-Filters fest.

1

string

Fester Wert:

„=“

filter_value

Attribut von supplier_id. Legt den Filterwert des Lieferanten-Filters fest.

1

integer


supplier_number

Schränkt die Ergebnismenge der Abfrage auf die angegebene Lieferantennummer ein.

1

Element


filter_method

Attribut von supplier_number. Legt das Verhalten des Lieferanten-Filters fest.

1

string

Fester Wert:

„=“

filter_value

Attribut von supplier_number. Legt den Filterwert des Lieferanten-Filters fest.

1

integer


supplier_name

Schränkt die Ergebnismenge der Abfrage auf den angegebenen Lieferantennamen ein.

 

0..1

string

Länge:

0 - 200 Zeichen

filter_method

Attribut von supplier_name. Legt das Verhalten des Lieferanten-Filters fest.

1

string

Feste Werte:

„=“, „like“, „IS“, „IS NOT“

filter_value

Attribut von supplier_name. Legt den Filterwert des Lieferanten-Filters fest.

1

integer

Falls filter_

method = „IS“  oder „IS NOT“:

„NULL“

allow_null

Attribut von supplier_name. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden.

0..1



postal_code

Schränkt die Ergebnismenge der Abfrage auf die angegebene PLZ ein.

0..1

string

Länge:

0 - 50 Zeichen

filter_method

Attribut von supplier_name. Legt das Verhalten des Lieferanten-Filters fest.

1

string

Feste Werte:

„=“, „like“, „IS“, „IS NOT“

filter_value

Attribut von supplier_name. Legt den Filterwert des Lieferanten-Filters fest.

1

integer

Falls filter_

method = „IS“  oder „IS NOT“:

„NULL“

allow_null

Attribut von supplier_name. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden.

0..1



mandator_id

Schränkt die Ergebnismenge der Abfrage auf einen bestimmten Mandanten ein.

1

Element


filter_method

Attribut von mandator_id. Legt das Verhalten des Lieferanten-Filters fest.

1

string

Fester Wert:

„=“

filter_value

Attribut von mandator _id. Legt den Filterwert des Lieferanten-Filters fest.

1

integer


last_changed_at

Schränkt die Ergebnismenge der Abfrage nach dem letzten Änderungsdatum der Auftragsdatensätze ein.

0..1

Element


from_date

Attribut von last_changed. Selektiert alle Aufträge die ab einschließlich des angegebenen Datums geändert wurden.

0..1

dateTime


to_date

Attribut von last_changed. Selektiert alle Aufträge die bis einschließlich des angegebenen Datums geändert wurden.

0..1

dateTime


allow_null

Attribut von last_changed_at. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden.

0..1

boolean


created_at

Schränkt die Ergebnismenge der Abfrage nach dem Erstellungsdatum der Auftragsdatensätze ein.

0..1

Element


from_date

Attribut von created_at. Selektiert alle Aufträge die ab einschließlich des angegebenen Datums erstellt wurden.

0..1

dateTime


to_date

Attribut von created_at. Selektiert alle Aufträge die bis einschließlich des angegebenen Datums erstellt wurden.

0..1

dateTime


allow_null

Attribut von created_at. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden.

0..1

boolean


Beispiel Response

Code

Feldliste Response

Name

Beschreibung        

Anz.

Typ

sonstiges

response

Root-Element der Antwort

1

Element


method

Attribut von response. Name der Webservice-Methode.

1

string

Fester Wert:

„fetchSuppliers“

version

Attribut von response. Legt die Version der Anfrage fest.

1

integer

Fester Wert:

„1.0.0“

report

Information über die ausgeführte Operation.

1

Element


return_code

Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind.

1

integer

0 = OK.

< 0 = Fehler

error_description

Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert

0..1

string


supplier

Wrapper-Element für die Lieferantendaten

0..N

Element


supplier_id

ID des Lieferanten

1

integer


mandator_id

ID des Mandanten

1

integer


supplier_number

Lieferantennummer

1

integer


supplier_name

Bezeichnung des Lieferanten

1

string

Länge:

0-200 Zeichen

street

Straße

1

string

Länge:

0-200 Zeichen

house_number

Hausnummer

1

string

Länge:

0-50 Zeichen

additional_street_data

Straßenzusatz

0..1

string

Länge:

0-200 Zeichen

postal_code

Postleitzahl

1

string

Länge:

0-50 Zeichen

city

Stadt

1

string

Länge:

0-200 Zeichen

country_code_iso

Land

1

string

Ländercode ISO 3166-1 ALPHA-2 (z.B. „DE“)

free_field

Freifeld

0..1

string

Länge:

0-200 Zeichen

phone_number

Telefonnummer

0..1

string

Länge:

0-50 Zeichen

mobile_phone_number

Mobiltelefonnummer

0..1

string

Länge:

0-50 Zeichen

fax_number

Faxnummer

0..1

string

Länge:

0-50 Zeichen

email_address

Email-Adresse

1

string

Länge:

0-100 Zeichen

salutation

Wrapper-Element, das die Anrede enthält.

1

Element


salutation_id

Element von salutation. ID der Anrede.

1

integer

Zulässige Werte:

1 (= Herr)

2 (= Frau)

3 (= Firma)

salutation_identifier

Element von salutation. Bezeichner der Anrede.

1

string

Zulässige Werte:

„mr“ | „ms“| „business“

contact_title

Titel des Ansprechpartners

0..1

string

Länge:

0-50 Zeichen

contact_first_name

Vorname des Ansprechpartners

0..1

string

Länge:

0-100 Zeichen

contact_last_name

Nachname des Ansprechpartners

0..1

string

Länge:

0-200 Zeichen

contact_email_address

Email-Adresse des Ansprechpartners

0..1

string

Länge:

0-100 Zeichen

contact_phone_number

Telefonnummer des Ansprechpartners

0..1

string

Länge:

0-50 Zeichen

contact_mobile_phone_number

Mobiltelefonnummer des Ansprechpartners

0..1

string

Länge:

0-50 Zeichen

contact_fax_number

Faxnummer des Ansprechpartners

0..1

string

Länge:

0-50 Zeichen

additional_charge_percentage

Prozentualer Aufschlag des Lieferanten

0..1

decimal


comment

Kommentar

0..1

string


drop_shipping

Gibt an ob der Lieferant die Ware direkt verschickt (true) oder an ein Lager liefert (false)

1

boolean


ware_house

Wrapper-Element, das Daten über ein Lager zusammenfasst.

0..1

Element


ware_house_id

ID des Lagers

1

integer


ware_house_identifier

Bezeichner des Lagers

1

string

Länge:

0-100 Zeichen

email_template

Wrapper-Element, das die Daten einer E-Mail-Vorlage zusammenfasst.

0..1

Element


email_template_id

ID der E-Mail-Vorlage

1

integer


email_template_identifier

Bezeichner der E-Mail-Vorlage

1

string

Länge:

0-100 Zeichen

created_at

Erstellungsdatum des Lieferanten

0..1

dateTime


last_changed

Datum der letzten Änderung des Lieferanten

0..1

dateTime


 

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.75

Redaktionelle Überarbeitung