Alle Vorlagen auflisten

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

Über Parameter kann gefiltert werden:

GET /api/templates?type=INVOICE

Listet alle Rechnungsvorlagen auf. Groß- und Kleinschreibung wird ignoriert.
Folgende Parameter stehen zur Verfügung:

ParameterBeschreibung
typeDokumenttyp, auf die sich die Vorlage bezieht (INVOICE, OFFER, CONFIRMATION, REMINDER, DELIVERY_NOTE, CREDIT_NOTE, LETTER). Mehrere Typbezeichnungen können per Komma getrennt werden und werden ODER-Verknüpft.
template_typeTyp der Vorlage (DEFINED = über den Editor konfigurierte Vorlage, UPLOADED = hochgeladene Vorlage).
is_defaultStandardvorlage (1 = ja, 0 = nein)

Einzelne Vorlage aufrufen

GET /api/templates/{id}
<?xml version="1.0" encoding="UTF-8"?>
<template>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <type>INVOICE</type>    
    <template_type>UPLOADED</template_type>
    <name>Meine Vorlage</name>
    <format>doc</format>
    <base64file>{base64-kodierte Vorlagendatei}</base64file>
    <is_default>1</is_default>
</template>

Hinweis: format und base64file stehen aus Performanzgründen nur zur Verfügung, wenn die Vorlage einzeln aufgerufen wird. Zudem werden diese Attribute nur zurückgegeben, wenn es sich um eine hochgeladene Vorlage handelt.

Vorlage erstellen

POST /api/templates
XML-ElementBeschreibungTypDefault-WertPflichtfeld
nameBezeichnung der VorlageALNUM
typeDokumenttyp (INVOICE, OFFER, CONFIRMATION, REMINDER, DELIVERY_NOTE, CREDIT_NOTE, LETTER)ENUMja
formatFormat (doc, docx oder rtf)ENUM
base64filebase64-kodierte VorlagendateiENUM
is_defaultGibt an, ob es sich um die Standardvorlage handelt (1 = ja, 0 = nein)BOOL0

Hinweis: template_type wird automatisch vergeben. Wird format und base64file übermittelt, bekommt template_type den Wert UPLOADED, ansonsten ist der Wert DEFINED.

<template>
    <name>Meine Vorlage</name>
    <type>INVOICE</type>
    <format>doc</format>
    <base64file>{base64-kodierte Vorlagendatei}</base64file>
</template>
<?xml version="1.0" encoding="UTF-8"?>
<template>
    <id type="integer">1234</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <type>INVOICE</type>
    <template_type>UPLOADED</template_type>
    <name>Meine Vorlage</name>
    <format>doc</format>
    <base64file>{base64-kodierte Vorlagendatei}</base64file>
    <is_default>0</is_default>
</template>

Vorlage bearbeiten

PUT /api/templates/{id}
<template>
    <name>Spezialvorlage</name>
</template>

Vorlagen löschen

DELETE /api/templates/{id}

Löscht eine Vorlage.

Vorschau einer Vorlage aufrufen

GET /api/templates/{id}/thumb

Es wird immer nur die erste Seite der Vorlage zurückgegeben.
Das gewünschte Bild-Format kann über den Parameter format angegeben werden.

ParameterBeschreibung
formatBild-Format. Kann png, gif oder jpg sein. Standard-Format ist png.