mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-26 06:30:29 +01:00
95 lines
4.9 KiB
Markdown
95 lines
4.9 KiB
Markdown
###To find under Apps -> Master data -> Kupferzuschlag
|
|
|
|
The modul adds extra positions to business documents which contain articles with copper.
|
|
The purchase prices of these surcharge articles can be edited quickly with the module 'Tagespreise' (index.php?module=tagespreise)
|
|
Theses purchase prices represent the DEL-values (DEL stands for Deutsches Elektrolytkupfer für Leitzwecke)
|
|
|
|
###Preparation:
|
|
|
|
The following values get mangaged in the module:
|
|
|
|
- copper surcharge article (Kupferzuschlagsartikel)
|
|
an article which gets addes as surcharge position in all business documents
|
|
|
|
- Add position (Position einfügen)
|
|
There are three posibilities how surcharge articles can be added as positions:
|
|
- a position gets added for every article which is a copper article
|
|
- only one position gets added for all copper articles
|
|
- for every group a surcharge position gets added
|
|
|
|
- Copper surcharge - offer to order (Kupferzuschlag - Angebot zu Auftrag)
|
|
two posibilities:
|
|
- DEL from offer date: if an offer exists the date from it will be used to evaluate the DEL. If there is no offer the present day is used
|
|
- DEL from order date: the date from the order is used
|
|
|
|
- coppersurcharge - create invoice (Kupferzuschlag Rechnung erstellen)
|
|
four posibilities:
|
|
- DEL from order date: date from order, if not found present day
|
|
- DEL from order delivery date: delivery date, if not found present day
|
|
- DEL from invoice date: date from invoice
|
|
- DEL from offer date: offer date, if not found present day
|
|
|
|
- Where should the values get specified (Wie sollen die Daten gespeichert werden?)
|
|
There are two posibilities to save the data needed to specify a copper article:
|
|
By the app raw materials (Rohstoffe) or with additional fields in articles (managed in (Grundeinstellungen -> Freifelder))
|
|
|
|
- article specific copper number (kg/km) (Artikelspezifische Kupferzahl (kg/km))
|
|
this field only appears when 'with additional article fields is seleted'. Only fields which are already set in the 'Grundeinstellungen' appear
|
|
|
|
- delivery costs (in percent) (Bezugskosten (in Prozent))
|
|
The current calculation includes always a delivery cost addition. Normally this is 1% for all articles
|
|
|
|
- standard copper base (Standard Kupferbasis (in EUR pro 100kg))
|
|
The current calculation also includes this value, default is 150
|
|
|
|
- article specific copper base (Artikelspezifische Kupferbasis (in EUR pro 100kg))
|
|
if the value from the field before differs in an article another additional field in the article can be assigned here
|
|
|
|
####Create copper surcharge article:
|
|
|
|
New surcharge positions need an article as base. Therefore an new one must be created.
|
|
This article must be marked as daily price article (the checkbox 'Daily prices'(Tagespreise))
|
|
In Artikelbeschreibung (DE) several placeholders can be used to get replaced in the position:
|
|
{ARTIKELNUMMER}, {ARTIKELNAME}, {NETPRICE} the net price for the surcharge, {COPPERBASIS} the copper base (see calculation), {COPPERNUMBER} the copper weight (kg/km) (see calculation), {DELVALUE} the DEL value
|
|
|
|
####Mark an Article as copper base:
|
|
|
|
Dependinfg on how the module should work (raw materials or additional article fields) the article must be marked as 'Raw material list' (Rohstoffliste) or the additional field(s) must be filled
|
|
If raw materials are used, switch to teh slider 'raw materials' (Rohstoffe) and create a new entry with the surcharge article as article and amount as copper weight (kg/km)
|
|
|
|
####Daily Prices:
|
|
|
|
in the module daily prices (Tagespreise - index.php?module=tagespreise ), in the slider configuration select the surcharge article in one of the seven possible rows and add a name
|
|
In the slider 'overview' (Übersicht) you now can add the newest DEL values every day. DEL values can be found here: http://www.del-notiz.org/ - neu ausgegeben
|
|
If a new daily price is added an an older one is existing the old will be changed to invalid and the new one gets added
|
|
|
|
####Price calculation:
|
|
|
|
Copper surcharge EUR/km = (copper weight (kg/km) * (DEL + 1% delivery costs)) - copper base / 100
|
|
|
|
Example:
|
|
|
|
copper weight/km: 13,00 kg
|
|
copper base: 150,00 EUR/100 kg
|
|
DEL: 550,00 EUR/100 kg
|
|
|
|
13 * ((550,00 + (550,00 * 0.01)) - 150,00) / 100 = 52,72 EUR/km
|
|
|
|
###How the code works:
|
|
|
|
The logic starts its work by calling the hooks 'ANABREGSNeuberechnen_1' (adding positions)
|
|
and 'ANABREGSNeuberechnenEnde' (updating some unneccesary values which are filled between the hooks).
|
|
|
|
Because there is no relation between different positions of on business document, I always delete all
|
|
surcharge positions and create new ones. Time will show if this is not too much and if it wouldn't be better
|
|
to add a relation table for positions and their dependencies.
|
|
|
|
After deleting these positions the code starts collecting all necessary copper positions.
|
|
It differentiates between regular articles and part list articles.
|
|
The main difference between these types of articles is, that part list elements with copper get always grouped.
|
|
|
|
After that the prices get calculated and depending on the settings the positions get added.
|
|
|
|
|
|
|