7. Wiederkehrende
Ausgangsrechnungen
recurring.get
Abfragen der Details einer oder mehrerer wiederkehrender Rechnungen. Wenn kein Filter gesetzt wird, werden alle wiederkehrenden Rechnungen zurückgeliefert.
Filter
INVOICE_ID
Rechnungsnummer
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>recurring.get</SERVICE>
<FILTER>
<INVOICE_ID>22115</INVOICE_ID>
</FILTER>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>recurring.get</SERVICE>
<FILTER>
<INVOICE_ID>22115</INVOICE_ID>
</FILTER>
</REQUEST>
<RESPONSE>
<INVOICES>
<INVOICE>
<INVOICE_ID>22115</INVOICE_ID>
<TYPE>recurring</TYPE>
<CUSTOMER_ID>1552</CUSTOMER_ID>
<CUSTOMER_COSTCENTER_ID>0</CUSTOMER_COSTCENTER_ID>
<CURRENCY_CODE>EUR</CURRENCY_CODE>
<TEMPLATE_ID>2</TEMPLATE_ID>
<INTROTEXT>Hiermit stellen wir folgende Posten in Rech
nung:</INTROTEXT>
<INVOICE_NUMBER>09/038</INVOICE_NUMBER>
<PAID_DATE>0000-00-00</PAID_DATE>
<IS_CANCELED>0</IS_CANCELED>
<INVOICE_DATE>2009-11-12</INVOICE_DATE>
<DUE_DATE>2009-11-26</DUE_DATE>
<DELIVERY_DATE>JANUAR 2011</DELIVERY_DATE>
<CASH_DISCOUNT_PERCENT>0</CASH_DISCOUNT_PERCENT>
<CASH_DISCOUNT_DAYS>0<CASH_DISCOUNT_DAYS>
<SUB_TOTAL>10</SUB_TOTAL>
<VAT_TOTAL>1.9</VAT_TOTAL>
<TOTAL>11.9</TOTAL>
<VAT_ITEMS>
<VAT_ITEM>
<VAT_PERCENT>19.00</VAT_PERCENT>
<VAT_VALUE>1.9</VAT_VALUE>
</VAT_ITEM>
</VAT_ITEMS>
<ITEMS>
<ITEM>
<INVOICE_ITEM_ID>23619</INVOICE_ITEM_ID>
<ARTICLE_NUMBER>1</ARTICLE_NUMBER>
<DESCRIPTION>Testposition</DESCRIPTION>
<QUANTITY>1.00</QUANTITY>
<UNIT_PRICE>10.00</UNIT_PRICE>
<VAT_PERCENT>19.00</VAT_PERCENT>
<VAT_VALUE>1.9</VAT_VALUE>
<COMPLETE_NET>10</COMPLETE_NET>
<COMPLETE_GROSS>11.9</COMPLETE_GROSS>
<SORT_ORDER>1</SORT_ORDER>
</ITEM>
</ITEMS>
</INVOICE>
</INVOICES>
</RESPONSE>
</FBAPI>
recurring.create
Erstellen einer neuen wiederkehrenden Rechnung.
Felder
CUSTOMER_ID
[REQUIRED] ID des Kunden
CUSTOMER_COSTCENTER_ID
ID der Kostenstelle
CURRENCY_CODE
CODE
der Währung:
EUR
CHF
GBP
USD
TEMPLATE_ID
ID der Rechnungsvorlage
INTROTEXT
Anschreiben der Rechnung
START_DATE
[REQUIRED]
Datum des ersten Rechnungslaufs
(Format: 2011-03-31)
FREQUENCY
[REQUIRED]
Wiederholrate des Rechnungslaufes:
weekly
2
weeks
4
weeks
monthly
2
months
3
months
6
months
yearly
OCCURENCES
Anzahl der Rechnungsläufe dieser wiederkehrenden Rechnung (0 = unbegrenzt)
OUTPUT_TYPE
[REQUIRED]
Typ der automatisch zu erzeugenden Rechnung:
draft = Entwurf
Outgoing =
fertige Rechnung
EMAIL_NOTIFY
Flag
für den Versand einer E-Mail (an die eigene
Adresse),
sobald eine euer Rechnungslauf erfolgt ist
0
= nein
1= ja
DELIVERY_DATE
Leistungszeitraum / Lieferdatum (Textfeld)
CASH_DISCOUNT_PERCENT
Skonto in Prozent
CASH_DISCOUNT_DAYS
Skonto-Zeitraum in Tagen
EU_DELIVERY
Flag
für die Anzeige einer innergemeinschaftlichen Lieferung
0
= nein
1 = ja
ITEMS
XML-Knoten, der Rechnungsposten (ITEM-Elemente) umfasst
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>recurring.create</SERVICE>
<DATA>
<CUSTOMER_ID>1552</CUSTOMER_ID>
<CUSTOMER_COSTCENTER_ID>0</CUSTOMER_COSTCENTER_ID>
<CURRENCY_CODE>EUR</CURRENCY_CODE>
<TEMPLATE_ID>1552</TEMPLATE_ID>
<INTROTEXT>
Hiermit stellen wir folgende Posten in Rechnung:
</INTROTEXT>
<INVOICE_DATE>2009-02-10</INVOICE_DATE>
<DELIVERY_DATE>JANUAR 2011</DELIVERY_DATE>
<ITEMS>
<ITEM>
<DESCRIPTION>Arbeitsstunde</DESCRIPTION>
<QUANTITY>11.00</QUANTITY>
<UNIT_PRICE>60.00</UNIT_PRICE>
<VAT_PERCENT>19.00</VAT_PERCENT>
<SORT_ORDER>1</SORT_ORDER>
</ITEM>
</ITEMS>
<EU_DELIVERY>0</EU_DELIVERY>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>recurring.create</SERVICE>
<DATA>
<CUSTOMER_ID>1552</CUSTOMER_ID>
<CUSTOMER_COSTCENTER_ID>0</CUSTOMER_COSTCENTER_ID>
<CURRENCY_CODE>EUR</CURRENCY_CODE>
<TEMPLATE_ID>1552</TEMPLATE_ID>
<INTROTEXT>
Hiermit stellen wir folgende Posten in Rechnung:
</INTROTEXT>
<INVOICE_DATE>2009-02-10</INVOICE_DATE>
<DELIVERY_DATE>JANUAR 2011</DELIVERY_DATE>
<ITEMS>
<ITEM>
<DESCRIPTION>Arbeitsstunde</DESCRIPTION>
<QUANTITY>11.00</QUANTITY>
<UNIT_PRICE>60.00</UNIT_PRICE>
<VAT_PERCENT>19.00</VAT_PERCENT>
<SORT_ORDER>1</SORT_ORDER>
</ITEM>
</ITEMS>
<EU_DELIVERY>0</EU_DELIVERY>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
<INVOICE_ID>11267</INVOICE_ID>
</RESPONSE>
</FBAPI>
recurring.update
Verändern der Daten einer wiederkehrenden Rechnung.
Felder
INVOICE_ID
[REQUIRED] ID der zu ändernden wiederkehrenden Rechnung.
DELETE_EXISTING_ITEMS
Flag,
das angibt, ob alle bestehenden Rechnungsposten gelöscht
werden sollen.
0 = nein
1 = ja
(siehe recurring.create)
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>recurring.update</SERVICE>
<DATA>
<INVOICE_ID>22267</INVOICE_ID>
<FREQUENCY>3 months</FREQUENCY>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>recurring.update</SERVICE>
<DATA>
<INVOICE_ID>22267</INVOICE_ID>
<FREQUENCY>3 months</FREQUENCY>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
</RESPONSE>
</FBAPI>
recurring.delete
Löschen einer wiederkehrenden Rechnung.
Felder
INVOICE_ID
[REQUIRED] ID der zu löschenden wiederkehrenden Rechnung.
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>recurring.delete</SERVICE>
<DATA>
<INVOICE_ID>11267</INVOICE_ID>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>recurring.delete</SERVICE>
<DATA>
<INVOICE_ID>11267</INVOICE_ID>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
</RESPONSE>
</FBAPI>