Lieferanten

Alle Lieferanten auflisten

GET /api/suppliers
<!--?xml version="1.0" encoding="UTF-8"?-->
<suppliers type="array" page="1" per_page="100" total="2">
<supplier>
...
</supplier>
<supplier>
...
</supplier>
</suppliers>

Über Parameter kann gefiltert werden:

GET /api/suppliers?name=gmbh

Listet alle Lieferanten auf, die „gmbh“ im Namen haben. Groß- und Kleinschreibung wird ignoriert.
Folgende Parameter stehen zur Verfügung:

ParameterBeschreibung
nameFirma/Bezeichnung des Lieferanten
emailE-Mail-Adresse
first_nameVorname Ansprechpartner
last_nameNachname Ansprechpartner
country_codeLändercode nach ISO 3166 Alpha-2
creditor_identifierSEPA Gläubiger ID
noteNotiz
client_numberKundennummer beim Lieferanten
incoming_idID einer Eingangsrechnung für diesen Lieferanten, mehrere Werte kommasepariert
tagsKommaseparierte Liste der Schlagworte

Einzelnen Lieferanten aufrufen

GET /api/suppliers/{id}
<!--?xml version="1.0" encoding="UTF-8"?-->
<supplier>
<id type="integer">1</id>
<created type="datetime">2007-12-13T12:12:00+01:00</created>
<name>Musterfirma</name>
<salutation>Herr</salutation>
<first_name>Max</first_name>
<last_name>Muster</last_name>
<street>Musterstraße 123</street>
<zip>12345</zip>
<city>Musterstadt</city>
<state>Bundesland</state>
<country_code>DE</country_code>
    <phone>+49 123456789</phone>
    <fax>+49 123456789</fax>
<mobile>+49 123456789</mobile>
<email>info@example.com</email>
<www>www.example.com</www>
<tax_number>12/3456/789</tax_number>
<vat_number>DE123456789</vat_number>
<creditor_identifier>DE12ZZZ0123456789</creditor_identifier>
<bank_account_owner>Kontoinhaber</bank_account_owner>
<bank_number>123456789</bank_number>
<bank_name>Deutsche Bank</bank_name>
<bank_account_number>123456789</bank_account_number>
<bank_swift>SWIFT/BIC</bank_swift>
<bank_iban>IBAN</bank_iban>
<currency_code>CHF</currency_code>
<note>Sehr netter Lieferant</note>
<client_number>KD123</client_number>
<costs_gross type="float">Kosten brutto</costs_gross> <!-- read only -->
<costs_net type="float">Kosten netto</costs_net> <!-- read only -->
</supplier>

Lieferanten erstellen

POST /api/suppliers
XML-ElementBeschreibungTypDefault-WertPflichtfeld
nameFirmennameALNUM
streetStraßeALNUM
zipPLZALNUM
cityOrtALNUM
stateBundesland, Bezirk, RegionALNUM
country_codeLandLändercode nach ISO 3166 Alpha-2Wert aus eigener Firma
first_nameVornameALNUM
last_nameNachnameALNUM
salutationAnredeALNUM
phoneTelefonALNUM
faxFaxALNUM
mobileMobiltelefon-NummerALNUM
emailE-Mailgültige E-Mail-Adresse
wwwWebsiteURL (ohne http)
tax_numberSteuernummerALNUM
vat_numberUst-IdNr.gültige Ust-IdNr.
creditor_identifierSEPA Gläubiger-IDgültige Gläubiger-ID
bank_account_numberKontonummerALNUM
bank_account_ownerKontoinhaberALNUM
bank_numberBLZALNUM
bank_nameBanknameALNUM
bank_swiftSWIFT/BICALNUM
bank_ibanIBANgültige IBAN
noteNotizALNUM
client_numberKundennummer beim LieferantenALNUM
currency_codeWährung des Lieferanten. Ein leerer Wert bedeutet, dass die Account-Währung verwendet wird.ISO-Währungscode
<supplier>
<name>Musterfirma</name>
<salutation>Herr</salutation>
<first_name>Max</first_name>
<last_name>Muster</last_name>
<street>Musterstraße 123</street>
<zip>12345</zip>
<city>Musterstadt</city>
<state>Bundesland</state>
<country_code>DE</country_code>
    <phone>+49 123456789</phone>
    <fax>+49 123456789</fax>
<mobile>+49 123456789</mobile>
<email>info@example.com</email>
<www>www.example.com</www>
<tax_number>12/3456/789</tax_number>
<vat_number>DE123456789</vat_number>
<creditor_identifier>DE12ZZZ0123456789</creditor_identifier>
<bank_account_owner>Kontoinhaber</bank_account_owner>
<bank_number>123456789</bank_number>
<bank_name>Deutsche Bank</bank_name>
<bank_account_number>123456789</bank_account_number>
<bank_swift>SWIFT/BIC</bank_swift>
<bank_iban>IBAN</bank_iban>
</supplier>
<!--?xml version="1.0" encoding="UTF-8"?-->
<supplier>
<id type="integer">1234</id>
<created type="datetime">2007-12-13T12:12:00+01:00</created>
<name>Musterfirma</name>
<salutation>Herr</salutation>
<first_name>Max</first_name>
<last_name>Muster</last_name>
<street>Musterstraße 123</street>
<zip>12345</zip>
<city>Musterstadt</city>
<state>Bundesland</state>
<country_code>DE
    <phone>+49 123456789</phone>
    <fax>+49 123456789</fax>
<mobile>+49 123456789</mobile>
<email>info@example.com</email>
<www>www.example.com</www>
<tax_number>12/3456/789</tax_number>
<vat_number>DE123456789</vat_number>
<creditor_identifier>DE12ZZZ0123456789</creditor_identifier>
<bank_account_owner>Kontoinhaber</bank_account_owner>
<bank_number>123456789</bank_number>
<bank_name>Deutsche Bank</bank_name>
<bank_account_number>123456789</bank_account_number>
<bank_swift>SWIFT/BIC</bank_swift>
<bank_iban>IBAN</bank_iban>
<currency_code></currency_code>
<note></note>
<client_number></client_number>
<costs_gross type="float">0</costs_gross>
<costs_net type="float">0</costs_net>
</country_code></supplier>

Lieferanten bearbeiten

PUT /api/suppliers/{id}
<supplier>
<name>Die super Musterfirma</name>
</supplier>
<supplier>
<id type="integer">1234</id>
<created type="datetime">2007-12-13T12:12:00+01:00</created>
<name>Die super Musterfirma</name>
<salutation>Herr</salutation>
<first_name>Max</first_name>
<last_name>Muster</last_name>
<street>Musterstraße 123</street>
<zip>12345</zip>
<city>Musterstadt</city>
<state>Bundesland</state>
<country_code>DE
    <phone>+49 123456789</phone>
    <fax>+49 123456789</fax>
<mobile>+49 123456789</mobile>
<email>info@example.com</email>
<www>www.example.com</www>
<tax_number>12/3456/789</tax_number>
<vat_number>DE123456789</vat_number>
<creditor_identifier>DE12ZZZ0123456789</creditor_identifier>
<bank_account_owner>Kontoinhaber</bank_account_owner>
<bank_number>123456789</bank_number>
<bank_name>Deutsche Bank</bank_name>
<bank_account_number>123456789</bank_account_number>
<bank_swift>SWIFT/BIC</bank_swift>
<bank_iban>IBAN</bank_iban>
<currency_code></currency_code>
<note></note>
<client_number></client_number>
<costs_gross type="float">0</costs_gross>
<costs_net type="float">0</costs_net>
</country_code></supplier>

Lieferanten löschen

DELETE /api/suppliers/{id}

Ist nur möglich, wenn keine Dokumente zu diesem Lieferanten existieren.