2026-09-04, AVE: v1 6.8.0.20 2 None Global tarifrechnerplus_api_key Tarifrechnerplus API key false CustomfieldAmountInDispute Project cf_amount_in_dispute Amount in dispute Currency true 60 None CustomfieldOpposingParties "-", "1", "2", "3", "4", "5", "6", "7", "8", "9+" Project cf_opposing_parties Opposing parties Multistring true 160 None CustomfieldRepresentedParties "-", "1", "2", "3", "4", "5", "6", "7", "8", "9+" Project cf_represented_parties Represented parties Multistring true 150 None ClasssettingsCaseRATG Used for ConfigSet LegalFeeScheduleAT. <Page Name="RATG" LabelWidth="150" Header="{Translate 'RATG-Information'}" PlaceAfter="Project" > <TextBox Name="AmountInDispute" Label="{Translate 'Amount in dispute'}" ShowLabel="True" ValueExpression="customfieldcurr('cf_amount_in_dispute')" WidthFraction="0.5" ContentAlignment="Right" /> <AdditionalFieldComboBox Name="RepresentedParties" Label="{Translate 'Represented parties'}" ValueExpression="customfieldint('cf_represented_parties')" WidthFraction="0.5" /> <AdditionalFieldComboBox Name="OpposingParties" Label="{Translate 'Opposing parties'}" ValueExpression="customfieldint('cf_opposing_parties')" WidthFraction="0.5" /> </Page> Project ClasssettingsOpenService Used for ConfigSet LegalFeeScheduleAT. OpenService 17 true true OpenService 0 0 cmbProject false project false 0 Project true 153 false false false 0 1 cmbPhase false phase false 0 Phase true 0 false false false 1 10 true xfeeExt false 0 External fees true 80 false false false 0 2 false entryDate false 0 Date false 70 false false false 0 3 cmbExpenditureUser false user false 0 User false 70 false false false 0 4 cmbServicetype false type false 0 Service type true 60 false false false 0 5 false text false 0 Text true 180 false false true project.language 1 6 rndMinute true minutesInt false 0 Effort true 64 false false false 1 7 rndFeeRate false feeRateInt false 0 Rate false 64 false false false 1 8 rndCostItemFee true feeInt false 0 Fee false 64 false false false 0 9 renderer_legal_fee_schedule.ShowRatgButton false false 0 true 22 false false false ClasssettingsService Used for ConfigSet LegalFeeScheduleAT. <!-- =============== Service: ServiceFurtherInfoPage =============== --> <Page Override="ServiceFurtherInfo" > <TextBlock Name="RATG" Label="RATG" ShowLabel="True" ValueExpression="keystring('ratg')" VisibleExpression="keystring('ratg').length>0" Renderer= "renderer_legal_fee_schedule.RatgKeyOnPage" FitMode="Wrap" /> </Page> Service ClasssettingsServiceType Used for ConfigSet LegalFeeScheduleAT. <!-- =============== Service: ServiceFurtherInfoPage =============== --> <Page Override="FurtherInfo" > <TextBlock Name="RATG" Label="{Translate 'RATG setting'}" ShowLabel="True" ValueExpression="keystring('ratg')" VisibleExpression="keystring('ratg').length>0" Renderer= "renderer_legal_fee_schedule.RatgKeyOnPage" FitMode="Wrap" /> </Page> Servicetype ScriptAssignRatgFee RATG Assign fee OpenService,Servicetype false self->size=1 # coding: windows-1252 # # Designation: RATG Assign fee # Show in Vertec menus: True # Classes: OpenService, Servicetype # Display condition: self->size=1 # Event script for: None # Event classes: - # Event fields: - # Extended rights: True # Calculates the RATG fee based on a service # and assigns the value and the RATG parameter # 2026-03-17 AVE: Script created from module_legal_fee_schedule import tarif_request tarif_request(ratg_object = argobject) None false true true Python3 ScriptEventRatgParameterChanged RATG Recalculate fee OpenService false # coding: windows-1252 # # Designation: Recalculate services with RATG fee # Show in Vertec menus:True # Classes: OpenService # Display condition: - # Event script for: None # Event classes: - # Event fields: - # Extended rights: False # # If RATG parameters on case has changed, # the services with RATG can be recalculated # # 2026-08-17, AVE: Script created from module_legal_fee_schedule import recalculate_ratg_fee_on_service, check_ratg_requirements def main(selectedobjects): # recalulate services fees_old = 0.00 fees_new = 0.00 # Assign currency from frist open service, as in the current # implementation of RATG we only accept one currency (Euro) currency = str(selectedobjects[0].project.currency) for service in selectedobjects: # We only process services with RATG parameters if not service.getkeystring('ratg'): continue # If one of the cases/projects of the selected open services does not # the requirements met, we stop the whole script as a long list of # open services on different cases/projects were selected. if not check_ratg_requirements(service.project): return # RATG requirments ok, continue fees_old += service.xfeeext recalculate_ratg_fee_on_service(service) fees_new += service.xfeeext dlg_definition=""" <Dialog Title="{Translate 'RATG recalculation'}" Width="250" > <TextBlock Name="fees_old" Label="{Translate 'Total of old rates'}" ShowLabel="True" ContentAlignment="Right" /> <TextBlock Name="fees_new" Label="{Translate 'Total of new rates'}" ShowLabel="True" ContentAlignment="Right" /> <Dialog.Buttons> <Button Text="OK" IsAccept="True" Command="{Binding OkCommand}" /> </Dialog.Buttons> </Dialog> """ init_values = {} init_values["fees_old"] = "{} {}".format(vtcapp.formatnumber(fees_old), currency) init_values["fees_new"] = "{} {}".format(vtcapp.formatnumber(fees_new), currency) ok, values = vtcapp.showcustomdialog(dlg_definition, init_values) return if selectedobjects and vtcapp.evalocl("TimSession.allInstances->first.hasGui"): main(selectedobjects) None false false true Python3 ScriptEventServicetypeChanged Event ServiceType changed type Service false # coding: windows-1252 # # Designation: Event ServiceType changed # Show in Vertec menus:False # Classes: - # Display condition: - # Event script for: Changed # Event classes: Service # Event fields: type # Extended rights: True # Handles the calculation for RATG # 2026-08-17, AVE: Script created # we only catch here when the service type has changed # we also check argobject for the case it was deleted import json from module_legal_fee_schedule import get_tariff, recalculate_ratg_fee_on_service, check_ratg_requirements service = argobject if service.type and args.eventmember == "type": # Service type has changed. Check if there are RATG-parameters on type # and requirements for RATG are met? if service.type.getkeystring('ratg') != "" : if check_ratg_requirements(service.project): # There are ratg parameters defined on the # service type, take it over for the service service.setkeyvalue('ratg', service.type.getkeystring('ratg')) else: # RATG requirements not fullfilled. We remove the servicetype from the service service.type = None else: # No service type with RATG: remove key service.setkeyvalue('ratg', None) if service.getkeystring('ratg') == "": # Nothing to do, no ratg parameters. But reset fixed priceflag (can be set before by RATG) service.fixedprice = False else: # There are RATG-Parameters. Calculate the fees # Dict wit the parameters is stored as string in key, so we need to convert to python dict tp_parameters = json.loads(service.getkeystring('ratg')) # update parameters with such from case tp_parameters['Streitwert'] = service.project.cf_amount_in_dispute tp_parameters['VertretenePersonen'] = service.project.cf_represented_parties tp_parameters['Gegner'] = service.project.cf_opposing_parties tp_parameters['serviceDate'] = service.entrydate.strftime("%Y-%m-%d") # Calculate the RATG fees result, err = get_tariff("RATG", tp_parameters) if err: # Append error text on the beginning of existing text service.text = "{}{}{}".format(err['error']['message'], "\n" if service.text else "", service.text) else: # Save changed parameters as key service.setkeyvalue("ratg", json.dumps(tp_parameters)) # Save new parameters recalculate_ratg_fee_on_service(service) Changed false true false Python3 ScriptModuleLegalfeeschedule module_legal_fee_schedule false # Designation: module_LegalFeeSchedule # Show in Vertec menus: Y # Classes: Services, serviceType # Display condition: - # Event script for: - # Event classes: - # Event fields: - # Extended rights: - # Gets RATG/GGG fees # using the API from tarifrechnerplus.de # 2026-08-17, AVE: Script created from module_tarifrechnerplus_api import TarifrechnerplusClient, get_input_types_static, get_form_schema, get_tariff from datetime import datetime import json # ------------------------------------------------------------------ # Following methods are used to generate the form (python dialog) # for the selected "tarifposten" # # Dialog XML builder # ------------------------------------------------------------------ def build_dialog_xml(law, tp_id, date): """ Generate Vertec custom dialog XML from visible field definitions and the corresponding init_values Field type mapping: 'select' -> IndexComboBox (options rendered as 0-based ComboBoxItems) 'number' -> TextBox (right-aligned, half-width) 'checkbox' -> CheckBox 'date' -> DatePicker 'hidden' -> TextBox (not visible, no help, label not visible) """ form_schema, err = get_form_schema(law, tp_id, date) if err: raise Exception(err) fields = form_schema.get('fields') input_type = form_schema.get('inputType') summary = input_type.get('reference') # Selection-Fields contain text as selections but return an index value in dialog. # We need therefore to store the texts as reference to hand over them to the API as parameter select_options = {} # Parts contains the xml(-parts) for the dialogue parts = [] if summary: parts.append('<TextBlock HorizontalAlignment="Left" Text="{}" Appearance="Info" FitMode="Wrap" Width="550" />'.format(_xmlchar(summary))) for field in fields: fid = field['id'] label = _xmlchar(field.get('label', fid)) ftype = field.get('type', 'text') ref = field.get('legalReference', '') help_attr = 'Help="{}"'.format(_xmlchar(ref)) if ref else '' required = field.get('requirement').lower() == "required" label_star = ('* ' + label) if required else label if ftype == 'select': options = field.get('options') or [] select_options[fid] = options parts.append('<IndexComboBox Name="{}" Label="{}" {}>' .format(fid, label_star, help_attr)) parts.append(' <IndexComboBox.ListItems>') for idx, opt in enumerate(options): opt_text = _xmlchar(opt.get('label', '')) parts.append(' <ComboBoxItem Value="{}" Text="{}"/>' .format(idx, opt_text)) parts.append(' </IndexComboBox.ListItems>') parts.append('</IndexComboBox>') elif ftype == 'number': parts.append( ' <TextBox Name="{}" Label="{}" ContentAlignment="Right"' ' WidthFraction="0.5" {}/>'.format(fid, label_star, help_attr) ) elif ftype == 'textarea': parts.append( ' <TextArea Name="{}" Label="{}" ' ' WidthFraction="1" Lines="1" {} MaxLength="65"/>'.format(fid, label_star, help_attr) ) elif ftype == 'checkbox': parts.append('<CheckBox Name="{}" Label="{}" ShowLabel="True" {}/>' .format(fid, label_star, help_attr) ) elif ftype == 'date': parts.append('<DatePicker Name="{}" Text="{}" ShowLabel="False" {}/>' .format(fid, label_star, help_attr) ) elif ftype == 'hidden': parts.append('<TextBox Name="{}" Label="{}" ShowLabel="False" IsVisible="False" />' .format(fid, label_star) ) elif ftype == 'number_list': options = field.get('options') or [] parts.append('<IndexComboBox Name="{}" Label="{}" WidthFraction="0.8" {}>' .format(fid, label_star, help_attr)) parts.append(' <IndexComboBox.ListItems>') for idx, opt in enumerate(options): opt_text = _xmlchar(opt.get('label', '')) parts.append(' <ComboBoxItem Value="{}" Text="{}" />' .format(idx, opt_text)) parts.append(' </IndexComboBox.ListItems>') parts.append('</IndexComboBox>') else: vtcapp.msgbox("Invalid field definition: {}".format(ftype)) # Add information about the meaning of the * in labels parts.append('<Spacer Height="10" />' '<TextBlock Name="pflichtfeldinfo" ShowLabel="False" Text="{Translate \'* are mandatory fields\'}" />') # Return xml for dialog and the corresponding init_values return '\n'.join(parts), build_init_values(fields, input_type), select_options # -------------- # Initial values # -------------- def build_init_values(fields, input_type): """ Build the init_values dict for showcustomdialog. select -> integer index matching the default option (0 if none) number -> string representation of defaultValue, or '' checkbox -> bool date -> date (converted from date string) hidden -> string representation of defaultValue, or '' """ init = {} for field in fields: fid = field['id'] ftype = field.get('type', 'text') default = field.get('defaultValue') if ftype == 'select': options = field.get('options') or [] init[fid] = _option_default_index(options, default) elif ftype == 'number': init[fid] = '' if default is None else str(default) elif ftype == 'checkbox': init[fid] = bool(default) if default is not None else False elif ftype == 'date': init[fid] = '' if default is None else datetime.strptime(default, "%Y-%m-%d") elif ftype == 'textarea': init[fid] = '' if default is None else str(default) elif ftype == 'hidden': init[fid] = '' if default is None else str(default) elif ftype == 'number_list': options = field.get('options') or [] init[fid] = _option_default_index(options, default) return init # ---------- # XML helper # ---------- def _xmlchar(text): """ Escape text for use inside an XML attribute value (double-quoted). """ return (str(text or '') .replace('&', '&amp;') .replace('<', '&lt;') .replace('>', '&gt;') .replace('"', '&quot;')) def _option_default_index(options, default_value): """ Return 0-based index of the option whose 'value' matches default_value. """ for i, opt in enumerate(options): if opt.get('value') == default_value: return i return 0 # ------------- # Tarif dialogs # ------------- def tarif_request(case = None, law = 'RATG', ratg_object = None): """ Dialogs to select and calculate the needed fee (tariff) position. case is optional; if provided its case data (dispute amount, parties) prefill the dialog. law is optional ('RATG' or 'GGG'). If not provided, RATG is used. ratg_object is optional; if it is an open service, its entrydate and project are used as date/case. If not provided, today's date is used. """ if is_openservice(ratg_object): # Is an open service as of this date date = ratg_object.entrydate # Assign project/case from the open service case = ratg_object.project else: date = vtcapp.currentdate() # Check if requirmentes to calculate RATG-tarif are met if not check_ratg_requirements(case): return # input_types is a dict with an 'inputTypes' list (each item a dict) plus 'law' metadata input_types, err = get_input_types_static(law, date) if err: vtcapp.msgbox(vtcapp.translate("The following error occurred during data transmission:") + "\nError: {}" .format(err['error']['message']), 16) return # Dialog definitions # Top part of fee schedule dialog dlg_header = """ <Dialog Title="{}" Width="650"> <Group Orientation="Horizontal" VerticalAlignment="Top" HorizontalAlignment="Stretch" > <Group Orientation="Vertical" FlexWidth="6" LabelWidth="120"> <TextBlock Name="title" Label="{{Translate 'Project'}}" ContentAlignment="Right" ShowLabel="True" IsBold="True" LabelWidth="80"/> <TextBlock Name="AmountInDisputeOnCase" Label="{{Translate 'Amount in dispute'}}" ContentAlignment="Right" ShowLabel="True" IsBold="True" /> <TextBlock Name="RepresentedParties" Label="{{Translate 'Represented parties'}}" ShowLabel="True" IsBold="True" ContentAlignment="Right"/> <TextBlock Name="OpposingParties" Label="{{Translate 'Opposing parties'}}" ShowLabel="True" IsBold="True" ContentAlignment="Right"/> </Group> <Spacer /> <Group Orientation="Vertical" FlexWidth="8" LabelWidth="60"> <TextBlock Name="serviceDate" Label="{{Translate 'Date'}}" ShowLabel="True" /> <TextBlock Name="quelle" Label="{{Translate 'Source'}}" ShowLabel="True" FitMode="Wrap" /> </Group> </Group> <ScrollableGroup Orientation="Vertical" HorizontalAlignment="Left" LabelWidth="150" ShowVerticalScrollbar="True" Separator="Always" Width="600" MaxGroupHeight="600"> <TextBlock Name="selected_tp" ShowLabel="False" FitMode="Wrap" LabelWidth="100" ContentAlignment="Left" IsBold="True" Appearance="Info"/> <TextBlock Name="inputTypeId" Visible="False" /> <Spacer Height="2"/> """.format(law) # Lower part of fee dialog dlg_footer = """ </ScrollableGroup> <Dialog.Buttons> <Button Name="back" Text="{Translate 'Back'}" Command="{Binding CloseCommand}" /> <Button Name="next" Command="{Binding CloseCommand}" IsAccept="True" /> </Dialog.Buttons> </Dialog> """ dlg_tarifposten_liste = """ <ListBox Name="tarifposten_liste" Lines="20" /> """ # Initialize the init values tarifposten_liste = [] for tp in input_types['inputTypes']: tarifposten_liste.append(tp['label']) init_values = {} init_values['title.Text'] = case.code if case else "" init_values['AmountInDisputeOnCase'] = vtcapp.formatnumber(case.cf_amount_in_dispute) if case else "0" init_values['RepresentedParties'] = str(case.cf_represented_parties) if case else "0" init_values['OpposingParties'] = str(case.cf_opposing_parties) if case else "0" init_values['quelle'] = "{} (Version: {})".format(input_types['law']['sourceLabel'],input_types['law']['version']) if is_servicetype(ratg_object): # If we just assign a RATG fee (tariff) to a servicetype, 'Streitwert' # and 'VertretenePersonen', 'Gegenpartei' are not needed as the will # taken into account when a open service is created (as they are defined on project/case). Therefore: hide on service type init_values['title.Visible'] = False init_values['AmountInDisputeOnCase.Visible'] = False init_values['RepresentedParties.Visible'] = False init_values['OpposingParties.Visible'] = False # For the dummy calculation of the RATG fee on service type, we need default values # that will be overwritten, when service type is assigned to the open service init_values['AmountInDisputeOnCase'] = "0.0" init_values['RepresentedParties'] = "1" init_values['OpposingParties'] = "1" # Dialog_nr is used to control, which dialog should be displayed. Used to navigate with forward/backward dialog_nr = 1 selected_tp_from_list = 0 tp_id = None # Definitions done, here we start! # Outer while embedding the dialogs while dialog_nr > 0 : if dialog_nr == 1: # Show first dialog till user selected a 'tarifposten' or pressed [cancel] init_values['back.Visible'] = False init_values['selected_tp'] = vtcapp.translate("Tariff positions") init_values['serviceDate'] = vtcapp.datetostr(date) init_values['next.Text'] =vtcapp.translate("Next") init_values['tarifposten_liste'] = selected_tp_from_list init_values['tarifposten_liste.Items'] = tarifposten_liste # Dialog to select the needed 'Tarifposten' dlg_tarifposten = dlg_header + dlg_tarifposten_liste + dlg_footer ok, values = vtcapp.showcustomdialog(dlg_tarifposten, init_values) if not ok: return # Store the value if we have to come back selected_tp_from_list = values['tarifposten_liste'] # Get the technical id that is needed to get the details for the form # and to show in the following dialog tp_id = input_types['inputTypes'][values['tarifposten_liste']]['id'] dialog_nr = 2 elif dialog_nr == 2: # Detail dialog to enter the parameters for the selected tp # Get the Form (XML-Code) for the selected tp_id dlg_form, form_init_values, select_options = build_dialog_xml(law, tp_id, date) if values['back']: # Dialog is called again (with "back button"), so use the saved values init_values = dlg2_init_values else: # Is new dialog, add/overwrite 'Streitwert' # to the init_values of the form # we want to use our own init_value['Streitwert'] form_init_values['Streitwert'] = init_values['AmountInDisputeOnCase'] form_init_values['VertretenePersonen'] = init_values['RepresentedParties'] form_init_values['Gegner'] = init_values['OpposingParties'] init_values.update(form_init_values) if is_servicetype(ratg_object): # If a the dialog is called on a service type, we do not show this fields init_values['Streitwert.Visible'] = False init_values['VertretenePersonen.Visible'] = False init_values['Gegner.Visible'] = False init_values['back.Visible'] = True init_values['selected_tp'] = tp_id init_values['next.Text'] =vtcapp.translate("Next") # Just store the 'Tarifposten id' to use it later (hidden field) init_values['inputTypeId'] = tp_id dlg_tp_details = dlg_header + dlg_form + dlg_footer ok, values = vtcapp.showcustomdialog(dlg_tp_details, init_values) if not ok: return dlg2_init_values = {} # Store Init_values in case the dialog will be called again # using the [back] button for key in list(values.keys()): dlg2_init_values[key] = values[key] # Go to next or previous menu if values['next']: dialog_nr = 3 else: dialog_nr = 1 elif dialog_nr == 3: # Prepare values for fee calculation # We just have to send the values from the form (and inputTypeId, service date) tp_parameters = {} # Selected Tarifposten tp_parameters['inputTypeId'] = tp_id # Convert the string-date that is returned with the system specific format, # that convert it back to YYYY-mm-dd sd = vtcapp.strtodate(values['serviceDate']) tp_parameters['serviceDate'] = "{}-{:02d}-{:02d}".format(sd.year, sd.month, sd.day) for key in list(form_init_values.keys()): # Is this a value from a selection field? if key in select_options: # get the text from the selection by the index value tp_parameters[key] = select_options[key][values[key]]['label'] else: # get value but only if key in values exists if key in values: # Take over the value as they are tp_parameters[key] = values[key] # Get the fee from the entered parameters result, err = get_tariff(law, tp_parameters) # For a servicetype we do not have to calculate the fee value. # We just need the parameters. Therefore we end the dialog here # if there is no error (dialog_nr not longer needed, therefore not # set here.) if is_servicetype(ratg_object) and not err: set_ratg_values_on_ratg_object(ratg_object, tp_parameters) return dlg_result = "" if err: # There is an error dlg_result += """ <Table Width="550" ShowHeader="False" FillLastColumn="True" > <Table.Columns> <TableColumn /></Table.Columns> <TableRow> <TableCell> <TextBlock Name="errortext" Label="{{Translate 'Error'}}" LabelWidth="80" HorizontalAlignment="Left" ShowLabel="True" IsBold="True" Appearance="Error" FitMode="Wrap" Text="{}"/> </TableCell> </TableRow> </Table> """.format((err['error']['message']).replace('"', "'")) # Hide ok Button init_values['next.Visible'] = False else: # Result dialog part dlg_result =""" <Group Orientation="Vertical" HorizontalAlignment="Left" > """ for breakdown in result['breakdown']: dlg_result += """ <TextBlock Name="{}" Label="{}" LabelWidth="150" ShowLabel="True" Text="{}" ContentAlignment="Right" /> """.format(breakdown['key'], breakdown['label'], vtcapp.formatnumber(float(breakdown['value']))) # Add total incl. currency dlg_result += """ <Group Separator="Always" LabelWidth="150" > <TextBlock Name="total" Label="{{Translate 'Total'}}" ShowLabel="True" Text="{} {}" IsBold="True" ContentAlignment="Right" /> </Group> </Group> """.format(result["amountText"][-3:], vtcapp.formatnumber(result['total'])) # Show back button init_values['back.Visible'] = True # This is the last dialog, so there is no "next", just "OK" init_values['next.Text'] = "OK" ok, values = vtcapp.showcustomdialog((dlg_header + dlg_result + dlg_footer), init_values) if not ok: return # End or go to previous menu if values['back']: dialog_nr = 2 else: dialog_nr = 0 # If an RATG object was used, then assign the parameters and fee if is_openservice(ratg_object): set_ratg_values_on_ratg_object(ratg_object, tp_parameters, result['total']) # End While dialog for dialogs return def is_servicetype(ratg_object): """ Is object not None and ocl type of "Servicetype"? """ return (ratg_object and ratg_object.evalocl("oclIsTypeOf(Servicetype)")) def is_openservice(ratg_object): """ Is object not None and ocl type of "Open service"? """ return (ratg_object and ratg_object.evalocl("oclIsTypeOf(OpenService)")) def set_ratg_values_on_ratg_object(ratg_object, tp_parameters, total="0.0"): """ Calculates the RATG fee (tariff) based on the parameters and sets the corresponding values on service total is only used on openservice """ if is_openservice(ratg_object): # Set values on service, we do not want to trigger the event # as this function is also used in an event script! ratg_object.fixedprice = True ratg_object.extfixed = True ratg_object.isunitservice = True ratg_object.quantity = 1 ratg_object.feerateext = float(total) # Store parameters under the 'ratg' key ratg_object.setkeyvalue('ratg', json.dumps(tp_parameters)) elif is_servicetype(ratg_object): # Streitwert, represented and counter parties we do not store on # servicetype as these come from the case/project tp_parameters.pop('Streitwert', None) tp_parameters.pop('VertretenePersonen', None) tp_parameters.pop('Gegner', None) ratg_object.code = tp_parameters['inputTypeId'] # Append RATG-Tariff in front of existing text ratg_object.text = "(RATG: {}){}{}".format(tp_parameters['inputTypeId'], "\n" if ratg_object.text else "", ratg_object.text) # Store parameters under the 'ratg' key ratg_object.setkeyvalue('ratg', json.dumps(tp_parameters)) return def recalculate_ratg_fee_on_service(open_service): """ Recalculates the RATG fee (tariff) for an open service Ex. needed if 'Streitwert' has changed """ # Does the service have RATG parameters? if len(open_service.getkeystring("ratg"))>0: try: tp_parameters = json.loads(open_service.getkeystring("ratg")) except Exception: vtcapp.msgbox("Invalid RATG definition on service {}".format(open_service)) return # Take over the parameters that are defined on the case / project tp_parameters['Streitwert'] = open_service.project.cf_amount_in_dispute tp_parameters['VertretenePersonen'] = open_service.project.cf_represented_parties tp_parameters['Gegner'] = open_service.project.cf_opposing_parties tp_parameters['serviceDate'] = open_service.entrydate.strftime("%Y-%m-%d") result, err = get_tariff("RATG", tp_parameters) if err: raise Exception(err) try: total = result['total'] except Exception: total = "0.0" set_ratg_values_on_ratg_object(open_service, tp_parameters, total) return def check_ratg_requirements(case): """ Checks if the requirements for a RATG calculation are given Result is also true if case is None, as this fuction is also called for service types where no case/project is assigned """ error_list = [] if not case: # If no mandate is provided we assign RATG parameters on a # service type, so the requirments are always ok return True # RATG requires EUR as currency if (case.currency.designation != "EUR") : error_list.append(vtcapp.translate("RATG only supports EUR as curreny.")) # Amount in dispute must not be none if (case.cf_amount_in_dispute is None): error_list.append(vtcapp.translate("Field amount in dispute must not be empty.")) # Represented and opposing parties must be defined if (case.cf_represented_parties==0) or (case.cf_opposing_parties==0): error_list.append(vtcapp.translate("Represented and opposing parties must be defined.")) error_text = "\n".join(error_list) if error_text and vtcapp.evalocl("TimSession.allInstances->first.hasGui"): vtcapp.msgbox(error_text, 0, "RATG" ) return not error_list None false true false Python3 ScriptModuleTarifrechnerplusApi module_tarifrechnerplus_api false # coding: windows-1252 # # Designation: module_tarifrechnerplus_api # Show in Vertec menus:False # Classes: - # Display condition: - # Event script for: None # Event classes: - # Event fields: - # Extended rights: False # 2026-08-17, AVE:Script created import vtcapp import json import requests # Debug on tarifrechnerplus.de DEBUG = True API_KEY = vtcapp.getpropertyvalue("tarifrechnerplus_api_key") # API-URL for RATG BASE_URL_RATG = "https://tarifrechnerplus.de/api/laws/ratg" # GGG not yet implemented BASE_URL_GGG = "https://tarifrechnerplus.de/api/laws/ggg" # --------------------- # BasicAPI definition # --------------------- class TarifrechnerplusClient(object): """ Basic API class with core functions. """ def __init__(self,law): """ Initializes the client. """ self.logging = False if law.upper() == 'RATG': base_url = BASE_URL_RATG elif law.upper() == 'GGG': base_url = BASE_URL_GGG else: raise Exception("Wrong law selected: {}".format(law)) self.base_url = base_url.rstrip("/") self.session = self._create_session() self.Log("API new session opened") return def Log(self, message): """ helper method for logging """ if self.logging: print("[Log]: {}".format(message)) def _create_session(self): """ Creates a Requests session with standard headers. """ session = requests.Session() session.headers.update({ "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer " + API_KEY, "X-API-Sprache": "de", "X-RATG-Debug": str(DEBUG) }) session.verify = True return session def _build_url(self, path): """Builds complete URL from path.""" if not path.startswith("/"): path = "/" + path return self.base_url + path def _check_response(self, resp): """Checks HTTP status and returns the error payload (or None on success); does not raise.""" err = None if not (200 <= resp.status_code < 300): try: err = resp.json() except ValueError: err = resp.text return err def _safe_json(self, resp): """Safe JSON parsing with fallback.""" try: return resp.json() except ValueError: self.Log("error on _safe_json") return resp.text def close_session(self): """ Close current session """ self.session.close() self.session = None self.Log("API session closed") # ------------------------------------------------------ # Core API functions. We only need GET and POST # ------------------------------------------------------ def get(self, path, params=None): """Generic GET request.""" url = self._build_url(path) resp = self.session.get(url, params=params, timeout=10) self.Log("GET {} params: {}".format(url, params)) err = self._check_response(resp) return self._safe_json(resp), err def post(self, path, data=None): """Generic POST request.""" url = self._build_url(path) resp = self.session.post(url, data=data, timeout=10) self.Log("POST {} data: {}".format(url, data)) err = self._check_response(resp) return self._safe_json(resp), err # --------------------- # Basic Tariff methods # --------------------- def get_input_types_static(law, date): """ Fetches tariffs including source info for a specific date returns a json """ parameters = {} parameters['serviceDate'] = date.strftime("%Y-%m-%d") tariff_client = TarifrechnerplusClient(law) input_types, err = tariff_client.get("/input-types-static", params=parameters) tariff_client.close_session() return input_types, err def get_form_schema(law, input_type_id, date): """ Fetches tariff details for the needed inputs """ parameters = {} parameters['inputTypeId'] = input_type_id parameters['serviceDate'] = date.strftime("%Y-%m-%d") tariff_client = TarifrechnerplusClient(law) form_schema, err = tariff_client.get("/form-schema", params=parameters) tariff_client.close_session() return form_schema, err def get_tariff(law, tp_parameters): """ Get the tariff for the entered data """ tariff_client = TarifrechnerplusClient(law) calculated_tariff, err = tariff_client.post("/calculate-static", data=json.dumps(tp_parameters)) tariff_client.close_session() return calculated_tariff, err # ------------- # Usage example # ------------- def main(): # get the list of the available 'Tarifposten' date = vtcapp.currentdate() input_types, err = get_input_types_static('RATG', date) for typ in input_types['inputTypes']: print(typ['group'], " ", typ['label']) # get the form schema for one of the types print(get_form_schema('RATG', input_types['inputTypes'][40]['id'], date)) if __name__ == "__main__": main() None false false false Python3 ScriptRatgFeeInformation RATG fee information Project false self->size=1 # coding: windows-1252 # # Designation: RATG fee information # Show in Vertec menus:True # Classes: Project # Display condition: - # Event script for: None # Event classes: - # Event fields: - # Extended rights: False # # Gets a RATG fee # 2026-08-17, AVE: Script created from module_legal_fee_schedule import tarif_request tarif_request(argobject) None false false true Python3 ScriptRendererLegalfeeschedule renderer_legal_fee_schedule false # coding: windows-1252 # # Designation: renderer_legal_fee_schedule # Show in Vertec menus: N # Classes: - # Display condition: - # Event script for: - # Event classes: - # Event fields: - # Extended rights: # Custom renderer for services related to RATG # 2026-08-17, AVE: Script created import json class ShowRatgButton(): """ Renderer defintions to display a button and the corresponding actions """ display_type = "button" # No text beside button value = "" def get_buttoniconid(self, rowobj, expression, subscriber): return 'calculate' def get_buttontooltip(self,rowobj, expression, subscriber): return "RATG" def get_background_color(self, rowobj, expression, subscriber): # Are there already RATG parameters? if self.evalocl("keystring('ratg')<>''",rowobj): return "clAqua" else: return "" def button_clicked(self, rowobj, expression): """ Calls the RATG dialog to assign a fee """ script_text = self.evalocl("scripteintrag->select(entryid='ScriptAssignRatgFee')->first.scripttext") return vtcapp.scriptexecute(script_text, rowobj) class RatgKeyOnPage(): """ Displays the RATG key (dict) on a service or service type nice """ def get_value(self, rowobj, expression, subscriber): nice_string = "" # get key as dict. key 'ratg' must be a dict stored as string! try: ratg = json.loads(self.evalocl("keystring('ratg')", rowobj)) if ratg: for key in sorted(ratg.keys()): nice_string += "{}: {}\n".format(key, ratg[key]) except Exception: pass return nice_string None false true false Python3 TranslationAmountInDispute Streitwert Amount in dispute Montant du litige Valore della controversia Streitwert Geschilwaarde Amount in dispute TranslationAreMandatoryFields * sind Pflichtfelder * are mandatory fields * sont des champs obligatoires * sono campi obbligatori * sind Pflichtfelder * zijn verplichte velden * are mandatory fields TranslationAssignRatgFee RATG Tarif zuweisen RATG Assign fee RATG Attribuer le tarif RATG Assegnare la tariffa RATG Tarif zuweisen RATG tarief toewijzen RATG Assign fee TranslationFieldAmountInDisputeMustNotBeEmpty Das Feld Streitbetrag darf nicht leer sein. Field amount in dispute must not be empty. Le champ montant du litige ne doit pas être vide. Il campo valore della controversia non deve essere vuoto. Das Feld Streitbetrag darf nicht leer sein. Bedrag in geschilwaarde mag niet leeg zijn. Field amount in dispute must not be empty. TranslationRatgFeeInformation RATG Tarifauskunft RATG fee information RATG Informations tarifs RATG Informazioni sulle tariffa RATG Tarifauskunft RATG Tariefinformatie RATG fee information TranslationRatgOnlySupportsEurAsCurreny RATG unterstützt nur EUR als Währung. RATG only supports EUR as curreny. RATG ne prend en charge que l’EUR en tant que devise. RATG sostiene solo l’euro come valuta. RATG unterstützt nur EUR als Währung. RATG ondersteunt alleen de euro als valuta. RATG only supports EUR as curreny. TranslationRatgRecalculateFee RATG Tarif neu berechnen RATG Recalculate fee RATG Recalculer le tarif RATG Ricalcolare la tariffa RATG Tarif neu berechnen RATG Tarief opnieuw berekenen RATG Recalculate fee TranslationRatgRecalculation Recalculation RATG Neukalkulation RATG RATG recalculation Recalcul RATG Ricalcolo RATG Neukalkulation RATG Herberekening RATG RATG recalculation TranslationRatgSetting RATG Vorgabe RATG setting Réglage RATG Impostazione RATG RATG Vorgabe RATG-instelling RATG setting TranslationRepresentedAndOpposingPartiesMustBeDefined Die vertretenen und die gegnerischen Parteien müssen definiert sein. Represented and opposing parties must be defined. Les parties représentées et opposées doivent être définies. Occorre definire le parti rappresentate e quelle opposte. Die vertretenen und die gegnerischen Parteien müssen definiert sein. Vertegenwoordigde partijen en opposanten moeten worden gedefinieerd. Represented and opposing parties must be defined. TranslationRepresentedParties Vertretene Parteien Represented parties Parties représentées Parti rappresentate Vertretene Parteien Vertegenwoordigde partijen Represented parties TranslationSource Quelle Source Source Fonte Quelle Bron Source TranslationTariffPositions Tarifpositionen Tariff positions Positions tarifaires Voci tariffarie Tarifpositionen Tariefposten Tariff positions TranslationTotalOfNewRates Summe neue Tarife Total of new rates Total des nouveaux tarif Totale nuova tariffa Summe neue Tarife Totaal nieuwe tarieven Total of new rates TranslationTotalOfOldRates Summe alte Tarife Total of old rates Total des anciens tarif Totale delle vecchie tariffe Summe alte Tarife Totaal oude tarieven Total of old rates