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</country>
    <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>
</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</country>
    <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>
</supplier>

Lieferanten löschen

DELETE /api/suppliers/{id}

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