Settings | Billomat Accounting API - Create Online Invoices

View settings

GET /api/settings

<?xml version="1.0" encoding="UTF-8"?>
<settings>
    <bgcolor>999999</bgcolor>
    <color1>336600</color1>
    <color2>99CC00</color2>
    <color3>E6EFC2</color3>
    <currency_code>EUR</currency_code>
    <locale>en_GB</locale>
    <sepa_creditor_id>...</sepa_creditor_id>
    <number_range_mode>CONSIDER_PREFIX</number_range_mode>
    <article_number_pre>ART</article_number_pre>
    <article_number_length type="integer">4</article_number_length>
    ...
</settings>

Edit settings

PUT /api/settings

Updates the settings with the given parameters.

XML element	Description	Type
bgcolor	Background color at the customer portal as a hexadecimal RGB value	ALNUM
color1	Color 1 at the customer portal as a hexadecimal RGB value	ALNUM
color2	Color 2 at the customer portal as a hexadecimal RGB value	ALNUM
color3	Color 3 at the customer portal as a hexadecimal RGB value	ALNUM
currency_code	Default currency of the account	ISO currency code
locale	Locale of the account	ALNUM
net_gross	Price basis (net, gross)	NET, GROSS
sepa_creditor_id	SEPA Creditor Identifier	ALNUM
number_range_mode	Influential of the prefix on the numbering (“IGNORE_PREFIX”, “CONSIDER_PREFIX”)	ENUM
article_number_pre	Prefix of an article number	ALNUM
article_number_length	Minimum length of article numbers (to be filled with leading zeros)	INT
article_number_next	Next sequential article number	INT (readonly)
price_group2, price_group3, price_group4, …	Name of the price groups	ALNUM
client_number_pre	Prefix of a client number	ALNUM
client_number_length	Minimum length of client numbers (to be filled with leading zeros)	INT
client_number_next	Next sequential client number	INT (readonly)
invoice_number_pre	Prefix of an invoice number	ALNUM
invoice_number_length	Minimum length of invoice numbers (to be filled with leading zeros)	INT
invoice_number_next	Next sequential invoice number	INT (readonly)
invoice_filename	Filename of an invoice	ALNUM
due_days	Maturity in days from invoice date	INT
discount_rate	Cash discount in percent	FLOAT
discount_days	Discount period in days from invoice date	INT
offer_number_pre	Prefix of an offer number	ALNUM
offer_number_length	Minimum length of offer numbers (to be filled with leading zeros)	INT
offer_number_next	Next sequential offer number	INT (readonly)
offer_filename	Filename of an offer	ALNUM
offer_validity_days	Validity of offers in days	INT
confirmation_number_pre	Prefix of a confirmation number	ALNUM
confirmation_number_length	Minimum length of confirmation numbers (to be filled with leading zeros)	INT
confirmation_number_next	Next sequential confirmation number	INT (readonly)
confirmation_filename	Filename of a confirmation	ALNUM
credit_note_number_pre	Prefix of a credit note number	ALNUM
credit_note_number_length	Minimum length of credit note numbers (to be filled with leading zeros)	INT
credit_note_number_next	Next sequential credit note number	INT (readonly)
credit_note_filename	Filename of a credit note	ALNUM
delivery_note_number_pre	Prefix of a delivery note number	ALNUM
delivery_note_number_length	Minimum length of delivery note numbers (to be filled with leading zeros)	INT
delivery_note_number_next	Next sequential delivery note number	INT (readonly)
delivery_note_filename	Filename of a delivery note	ALNUM
reminder_filename	Filename of a reminder	ALNUM
reminder_due_days	Maturity of reminder in days from reminder date	INT
letter_filename	Filename of a letter	ALNUM
print_version	Specifies whether a print version should be created without a background image. 1=yes; 0=no	BOOL
default_email_sender	Default sender of emails	[Company.email], [User.email] or any email address
bcc_addresses	A list of bcc_address entries of addresses e-mails. E-mails are send to this addresses as BCC.	-Tags

Please note: If the default currency will be changed, possibly some of the invoice and offers currency exchange rates (quote) become invalid. It must therefore be taken to ensure that the courses will be updated.

<settings>
    <due_days>7</due_days>
</settings>