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:
Parameter |
Beschreibung |
type |
Dokumenttyp, 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_type |
Typ der Vorlage (DEFINED = über den Editor konfigurierte Vorlage, UPLOADED = hochgeladene Vorlage). |
is_default |
Standardvorlage (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-Element |
Beschreibung |
Typ |
Default-Wert |
Pflichtfeld |
name |
Bezeichnung der Vorlage |
ALNUM |
|
|
type |
Dokumenttyp (INVOICE, OFFER, CONFIRMATION, REMINDER, DELIVERY_NOTE, CREDIT_NOTE, LETTER) |
ENUM |
|
ja |
format |
Format (doc, docx oder rtf) |
ENUM |
|
|
base64file |
base64-kodierte Vorlagendatei |
ENUM |
|
|
is_default |
Gibt an, ob es sich um die Standardvorlage handelt (1 = ja, 0 = nein) |
BOOL |
0 |
|
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.
Parameter |
Beschreibung |
format |
Bild-Format. Kann png, gif oder jpg sein. Standard-Format ist png. |