Search

getConfParameters

Get account configuration — all the settings from the module Settings > Configuration and also a number of hidden settings that can be enabled by Erply technical support.

This API call returns exactly one result record. This record contains a variable number of attributes and it is not guaranteed that any one of these attributes will be present. The contents of this record should be saved into a dictionary or an associative array, and a default value (0, unless specified otherwise) assumed for all missing ones.

Some of the parameters are supposed to have a decimal/integer value, or a value of 1 or 0 (true/false, enabled/disabled). However API returns almost all fields as strings. If your programming environment requires that, please cast the parameters to the correct type. In the table below, the types are marked with an asterisk.

Most — but not all! — settings can be edited using saveConfParameter. Do NOT edit any undocumented settings or those marked as “Not Editable”.

Response

Field nameTypeDescription

General Settings

countryString (2)Do not edit. Country where this business resides. An uppercase two-letter country code, see http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.
default_languageString (3)Default language of this account. Possible values:
  • eng - English
  • est - Estonian
  • fin - Finnish
  • ger - German
  • gre - Greek
  • lat - Latvian
  • lit - Lithuanian
  • rus - Russian
  • spa - Spanish
  • swe - Swedish
timezoneStringAccount timezone. Names according to the tz database are used, eg. "America/New_York" or "Europe/Paris". See http://en.wikipedia.org/wiki/Tz_database and http://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
dateformatString (15)Date format to be used. Format descriptor consists of letters Y, m, d and interpunctuation.
  • Y - 4-digit year
  • m - month, with leading zeroes (00 to 12)
  • d - day of month, with leading zeroes (00 to 31)
. Examples: "m/d/Y" - default US date format. "d/m/Y", "d.m.Y" - typical European formats etc.
numberformatString (2)Number format to be used. This format descriptor consists of two letters. The first one is decimal separator and the second one is thousands separator. 3-digit grouping is assumed!

Examples: ".," - default US format (190,000.35), ", " - a sample European format (190 000,35)
fiscal_year_start_datefiscal year start date. Format '0000-mm-dd'. By default January 1.
export_sales_report_to_excelSales report export format. If 'csv', export as CSV. If 'xls' or empty, export as Excel file.
csv_separatorStringCustom CSV field separator defined by the user. Typically, it is not necessary to use this field. If users have NOT overridden the default CSV separator, then this field is missing or empty.

To get the actual CSV separator used in reporting (either the country-specific default, or the user-defined one, whichever is in effect), see the next parameter, "csv_field_separator" instead.
csv_field_separatorStringThe symbol that is used as a field separator in getSalesReport CSV output (or the CSV-formatted reports that can be downloaded from the back office).

By default, ERPLY uses a default region-specific separator which is either a semicolon or a comma. However, it can be overridden in the account settings (Settings → Configuration in the back office).
show_company_name_in_title_barshow company name in title bar
account_linksArrayAccount's special URLs for help pages and knowledge bases according to account's reseller and country. Each row (ie. each array element) has the following fields:
Field nameTypeDescription
helpStringDefault help URL
helpPOSStringHelp URL displayed in Berlin POS
terms_of_serviceStringURL to Erply terms of Service
knowledge_baseStringURL to Erply knowledge base

Invoices and Sales

payment_deadlineDefault payment deadline
invoice_roundingInteger*There are four possible values:
  • "-1" - invoice totals must not be rounded.
  • "0" - invoice totals to be rounded to closest 0.05 currency units.
  • "10" - invoice totals should be rounded to closest 0.1 currency units.
  • "100" - invoice totals should be rounded to full currency units.

Rounding is a separate operation that takes place at the very end of calculating invoice total. It does not affect invoice net total or tax. Example rounding:

Invoice total: 32.89
Tax: 2.63
Subtotal: 35.52
Rounding: -0.02
Invoice total: 35.50
make_sales_reports_by_revenueIf 1, dashboard graphs and widgets show sales revenue. If 0, dashboard graphs and widgets show the sales value of goods shipped from warehouse.
billing_invoice_use_todays_dateOn invoices made from billing statements, use today's date
final_price_input_on_invoiceAllow to enter final prices (with VAT included) on sales invoices
always_show_eek_prices_on_invoice_formDisplay prices both in selected currency and main currency
allowCreateInvForContactPersonAllow to create invoices for contact persons
do_not_create_automatic_credit_refundDo not create credit refund automatically
use_matrix_price_in_pricelistSelect a method for setting price list prices for matrix products. If 1 - Only matrix products are added to price lists. The same price will apply to all colors and sizes. If 0 - Each variation (color and size) is added to the price list as a separate item
reward_points_per_currency_unitFor all purchases, customer collects X reward points per one unit of currency
reward_points_durationReward points are valid for X months. If 0, points will not expire.
commission_methodSelect a method for calculating employee sales commission. 'percentage' - employees have commission percentage rates, 'amount' - each product has a specific sales commission amount.
commission_percentageDefault employee commission rate on net sales (%)
accounts_receivable_listedShow accounts receivable and calculate customer balance: 'by_payer' - according to invoice payers. 'by_receiver' or empty - according to customers (receivers of goods)
order_is_completed_whenStringAn order is considered completed when: 'packing_list_sent' - A waybill (invoice-waybill) has been made and a packing list sent to the warehouse. 'waybill_made' or empty - A waybill (invoice-waybill) has been made
partial_fulfilment_splits_order0 or 1*Partial fulfilment splits sales order
use_attendants_in_pos0 or 1*in POS and on invoices, every line can be associated with an attendant
show_credit_in_unpaid_invoices_report0 or 1*"Unpaid invoices" report also shows credit invoices
remake_billing_invoice_if_credited0 or 1*After crediting a billing statement invoice you can make a new invoice for the same period

Sales Document Printouts

ref_noPrint reference numbers on invoices. 'orgper', 'orgper_manual' or 'invoice'
code_on_invoiceProducts can have several codes. On inventory and purchase documents, show: 'code' / 'code2'
code_on_salesdocumentCompany's own code is printed on invoices and waybills
code2_on_salesdocumentEAN/UPC code is printed on invoices and waybills
code3_on_salesdocumentCode 3 is printed on invoices and waybills
code4_on_salesdocumentManufacturer code is printed on invoices and waybills
code5_on_salesdocumentCode 5 is printed on invoices and waybills. "Extra product codes" module must be enabled
code6_on_salesdocumentCode 6 is printed on invoices and waybills. "Extra product codes" module must be enabled
code7_on_salesdocumentCode 7 is printed on invoices and waybills. "Extra product codes" module must be enabled
code8_on_salesdocumentCode 8 is printed on invoices and waybills. "Extra product codes" module must be enabled
showCodeXOnPackListDocOn packing lists, show: 'code0' - same code as on invoices. 'code1' - company's own code. 'code2', 'code3' or 'code4'
sort_packinglist_bySort packing list and delivery act by: 'name', 'code', code2', 'code3', 'code4'
barcode_on_invwaybilldocumentPrint a barcode on each invoice line: Enable for Invoice-waybills
barcode_on_waybilldocumentPrint a barcode on each invoice line: Enable for Waybills
barcode_configurationGenerate barcode from: 'code', code2', 'code3', 'code4'
discount_printed_on_invoicesDiscount rate is printed on invoices by default
invoice_announcement_{LANG}Announcement/message printed on invoices. {LANG} signifies language code.
receipt_footerMessage in the footer of cash receipt
no_barcode_on_receipt_footerDo not print receipt # as a barcode on receipts.
receiver_signature_on_invoiceInvoice printouts include blanks for recipient's name and signature
display_customer_balance_on_invoicePrint customer balance on invoices and invoice-waybills
print_giftcard_balance_on_receipt0 or 1*If set to 1, and if customers pays with a gift card, receipt should display the remaining balance of the gift card.
invoice_group_rows_by_waybillInvoice printout shows lines grouped by waybill number
factoringFactoring notice on the invoice
invoiceExtraFooterLineAdditional text in the footer of invoice

Sending invoices by e-mail

import_link_in_invoice_mailAdd an import link to purchase and sales documents sent out by e-mail
mailtemplate_default_{LANG}Default text used when sending invoice by e-mail. {LANG} signifies language code.
mailtemplate_inv{1}_{2}Document type-specific text used when sending invoice by e-mail. {1} signifies sales document type ID and {2} signifies language code.

Sales Quotes

display_pictures_on_quotesdisplay product pictures on sales quotes

Export to Hansa Financials

hansa_receivables_accountAccounts receivable
hansa_goods_revenue_accountRevenue from goods
hansa_services_revenue_accountRevenue from services (if unset, goods revenue account will be used)
hansa_rounding_accountInvoice rounding (if unset, rounding will not be sent as a separate invoice row)
hansa_cash_codePayment condition "Cash"
hansa_card_codePayment condition "Card"
hansa_credit_codePayment condition "Credited"
hansa_include_product_codesExport product codes
hansa_payables_accountAccounts payable
hansa_warehouse_accountWarehouse

Google Apps Integration

googleapps_default_usergroupDefault user group ID for new users arriving through Google Apps

Balance statements and Payment reminders

balance_statement_text1balance statement letter, header text
balance_statement_text2balance statement letter, footer text
payment_reminder_text1payment reminder letter, header text
payment_reminder_text2payment reminder letter, footer text
default_period_for_balance_statementsdefault period for balance statement letters. If 'last_month' or empty, then send end-of-month statement. 'last_year' = end-of-year statement

Spa and Salon Settings

salon_booking_email_requiredemail required when customer books an appointment
salon_booking_phone_requiredphone required when customer books an appointment
salon_booking_email_or_phone_requiredemail or phone required when customer books an appointment
salon_booking_charge1_serviceInteger*Extra charge or service 1. This is a product ID.
salon_booking_charge2_serviceInteger*Extra charge or service 2. This is a product ID.
salon_booking_charge3_serviceInteger*Extra charge or service 3. This is a product ID.
salon_booking_charge1_channelStringExtra charge 1 is applied when booking: 'walk-in', 'online' or 'phone'
salon_booking_charge2_channelStringExtra charge 2 is applied when booking: 'walk-in', 'online' or 'phone'
salon_booking_charge3_channelStringExtra charge 3 is applied when booking: 'walk-in', 'online' or 'phone'
salon_require_credit_card_for_online_booking0 or 1*Require credit card information when appointment is booked: online
salon_require_credit_card_for_phone_booking0 or 1*Require credit card information when appointment is booked: over phone
salon_booking_in_advance_minInteger*Customers must book appointments at least X hours in advance.
salon_booking_in_advance_maxStringCustomers can book appointments at most "1w", "2w", "3w" (n weeks) or "1m", "2m", "3m" "6m" (n months) in advance
salon_cancellation_feeDecimal*cancellation fee
salon_cancellation_serviceInteger*cancellation service. This is a product ID.
salon_cancellation_deadlineInteger*Cancellation fee is charged when appointment is canceled less than X hours before the appointment start time

POS Settings

default_client_idDatInteger*ID of default POS customer (the one that is selected in POS by default, typically "POS Customer", "Walk-in Customer" or similar). NB! It is possible to override this in POS settings, each register may have its own default customer. See getPointsOfSale.
touchscreen_pos0 or 1*Use POS with touchscreen interface
pos_opening_required0 or 1*In POS, days must be opened and closed
pos_add_rows_automatically0 or 1*POS: products identified by barcode will be instantly added to invoice
quickpos0 or 1*Enable automatic printing in POS (Firefox plugin "JS Print Setup" required)
do_not_use_numpad0 or 1*Remove numeric keypad and display more quick select buttons
show_total_discount_on_receipt0 or 1*If customer gets a discount, print a line with total discount on sales receipt.
total_discount_labelStringTitle of that line (eg. "Loyal customer rewards"). By default the line is titled "Total Discount".
pos_group_items_together0 or 1*When ringing up the same product several times, quantity of the last line is incremented
pos_use_giftcards_with_serial_numbers0 or 1*Use gift cards with serial numbers
pos_timeoutInteger*Log cashier automatically out after an idle period of X seconds.

Offline POS Settings

allow_pay_with_checkenable check payments
pos_require_emailCashier must ask for customer's: Email address
pos_require_facebookCashier must ask for customer's: Facebook name
pos_require_twitterCashier must ask for customer's: Twitter ID
pos_ask_customer_dataCashier is reminded to ask for customer's information. 'beginning' - at the beginning of transaction, 'end' - at the end of transaction.
show_debit_button_on_posDebit/credit card payments. If 0, customer inserts card and selects whether to pay by debit or credit. If 1, salesperson must ask customer's preferred payment type and select the correct option in POS
cash_out_warning_tresholdPOS will prompt cashier to deposit cash when amount in drawer exceeds $X
cash_out_warning_intervalPrompting interval in minutes

Offline POS - weighed items

barcode_typeStringBarcode type - 'weight' or 'price'. If empty, then the feature has not been set up.
barcode_price_prefixStringBarcode prefix. This parameter is set only when price barcodes are enabled.
barcode_weight_prefixStringBarcode prefix. This parameter is set only when weight barcodes are enabled.
barcode_code_lengthInteger*Length of product code (number of digits)
barcode_measurement_lengthInteger*Length of price or weight (number of digits)
barcode_weight_decimalsInteger*Weight precision (in kg or lbs, number of decimal places) - only for barcodes with weight

Inventory and Purchase

positive_stock_requiredStock products
main_warehouseMain warehouse ID (Stock Replenishment Report will also show stock amounts in main warehouse, in addition to the warehouse you selected.)
product_code_unique0 or 1*If set to 1, all products must have a unique code. (Code may also be empty.)
product_code2_unique0 or 1*If set to 1, all products must have a unique EAN/UPC code. (EAN / UPC code may also be empty.)
product_code2_automaticGenerate EAN codes automatically
product_search_returns_matrix_and_variationsproduct search always returns both matrix products and variations
use_transport_costsEnable adding delivery expenses to purchase invoices
weights_on_invoicesPrint weights on purchase and sales invoices
transport_info_on_invoicesUse foreign transaction statistics
use_m2_calculatorUse m² → pcs. calculator on invoices
prcinvoice_with_salespriceInclude sales prices on purchase invoice printout
prodmove_with_salespriceInclude sales prices on inventory transfer printout
prcinvoice_send_price_variance_notice_toIf purchase invoice is confirmed and there are price variances, send a notification e-mail to (separated e-mail addresses with commas)
use_purchase_waybillsEnable purchase waybills and purchase invoices as separate document types
warehouse_transfer_reserves_goodsInventory Transfer Order puts items on hold
warehouse_transfer_order_removes_itemsInventory Transfer Order removes items from inventory

Purchase orders

code_on_prcorderWhich product code to print on purchase orders
prcorder_without_warehouse_locationPrint purchase order without warehouse locations
prcorder_without_weightPrint purchase order without weights
prcorder_without_regcodePrint purchase order without company number and VAT number
prcorder_send_price_variance_notice_toIf purchase order is confirmed and there are price variances, send a notification e-mail to (separated e-mail addresses with commas)

Assignments

workorderTextadditional text on assignment printout

Expected Transfer Report

processing_fee_debitPayment processing fee for: Debit cards
processing_fee_amexPayment processing fee for: American Express
processing_fee_visaPayment processing fee for: Visa
processing_fee_mcPayment processing fee for: MasterCard
processing_fee_discoverPayment processing fee for: Discover
expected_transfer_add_visa_mc_togetherIn "Expected Transfer" report, Visa and MasterCard are added together

Export to QuickBooks

qb_bank_depositBank Deposit
qb_accounts_receivable_tradeAccounts Receivable - Trade
qb_sales_and_use_tax_payableSales and Use Tax Payable
qb_cash_over_and_shortCash Over and Short
qb_counted_over_short_amounts0 or 1Report cash counted in POS and day over/short amounts
qb_inventoryInventory
qb_undeposited_fundsUndeposited Funds
qb_credit_defaultSales Income (default account, you may override it for specific product groups)
qb_debit_defaultCOGS (default account, you may override it for specific product groups)

Matrix settings

matrix_update_variations_automaticallywhen you edit a matrix product, its variations are updated with the same changes
matrix_select_fieldsThe following variation fields are not updated by default. Select the ones that you want to be updated:
matrix_update_codecode
matrix_update_namename
matrix_update_pricenet sales price
matrix_update_isactiveactive
matrix_update_show_in_webshopshow in webshop
matrix_update_commission_amountcommission amount
matrix_update_warehouse_locationlocation in warehouse
matrix_update_costpriceproduct cost

Settings not found in Erply Settings » Configuration

price_decimalsIntegerThe degree of precision for net prices. Eg. if price_decimals = 4, all net prices should be stored with 4 digits precision. Typically, price_decimals = 2 for US, 3 or 4 for European accounts. Prices with VAT/tax and invoice totals should be always calculated and displayed with a precision of 2 decimals, regardless of any settings.

NB! Invoice total calculation method in Erply is a separate, complicated topic. Ask us for further information.
default_currencyString (3)Not editable. Currency code (EUR, USD, JPY) of the account's default currency. See getCurrencies.
date_installedDate (yyyy-mm-dd)Account's set-up date.
invoice_algorithm_versionIntegerNot editable. Version number of the algorithm to be used for calculation invoice totals. The version numbers and corresponding algorithms are internally defined. This setting may change day-by-day, so it is advised to check this value at the beginning of each day. If account is not aware of algorithm versions yet, parameter will be set to 0
locale_uses_price_with_tax0 or 1Not editable. If 0, prices in this locale are commonly shown without sales tax (US, CA). If 1, prices are commonly shown with VAT included (the rest of the world).
invoice_waybills_show_price_with_tax0 or 1Not editable. If 1, invoice-waybill totals are calculated according to the same method as POS receipts. This is an optional feature that Erply technical support can enable.
languagesStringComma-separated list of all languages that are installed in this account.
**********The product card in ERPLY by default has only one field for product description, and one field for long (HTML) product description. Fields for other languages are not enabled by default. Check these parameters to see if the extra fields for multi-language descriptions have been enabled on your account.
product_description_eng_enabled0 or 1The value of this parameter is 1 if your account has English as a non-default language, and if product card has a field for English-language product description. Otherwise (if no field, or that language is not in use) the value is 0.
product_description_rus_enabled0 or 1The value of this parameter is 1 if your account has Russian as a non-default language, and if product card has a field for Russian-language product description. Otherwise (if no field, or that language is not in use) the value is 0.
product_description_fin_enabled0 or 1The value of this parameter is 1 if your account has Finnish as a non-default language, and if product card has a field for Finnish-language product description. Otherwise (if no field, or that language is not in use) the value is 0.
product_longdescription_eng_enabled0 or 1The value of this parameter is 1 if your account has English as a non-default language, and if product card has a field for English-language long (HTML) product description. Otherwise (if no field, or that language is not in use) the value is 0.
product_longdescription_rus_enabled0 or 1The value of this parameter is 1 if your account has Russian as a non-default language, and if product card has a field for Russian-language long (HTML) product description. Otherwise (if no field, or that language is not in use) the value is 0.
product_longdescription_fin_enabled0 or 1The value of this parameter is 1 if your account has Finnish as a non-default language, and if product card has a field for Finnish-language long (HTML) product description. Otherwise (if no field, or that language is not in use) the value is 0.