Element Naming Conventions in Spain

Understanding the naming convention that is developed for Oracle-delivered elements can help you determine the element type, the functional area it serves, and how it is used.

This topic discusses:

  • Naming conventions.

  • Functional area codes.

  • Element type codes (PIN_TYPE).

This topic discusses:

  • Primary elements.

  • Supporting elements.

  • Additional clues to the use of Spanish elements.

  • Component names (suffixes).

Primary Elements

Primary elements (such as earnings, deductions, absence take, and absence entitlement elements) do not contain functional area codes or element type codes in their names. Primary elements have names that identify their functions and element types without the use of additional codes. For example, the name of the earning element SALARIO BASE identifies this element as a base salary element.

Supporting Elements

For supporting elements (such as variables, formulas, dates, and durations), Oracle uses this naming convention: FFF TT NAME.

For example, in the tax array TAX AR ING A EST:

  • TAX represents the functional area (taxes).

  • AR represents the element type (array).

  • ING A EST (ingresos anuales estimados) represents a further means of identifying the element.

Note: This naming convention applies to these element types: accumulators, arrays, brackets, counts, dates, durations, formulas, rate codes, variables, historical rules, fictitious calculation rules, proration rules, rounding rules, writable arrays, and generation control conditions as well as sections and element groups.

Additional Clues to the Use of Spanish Elements

Many Spanish elements contain abbreviations that provide clues to their use in the system (beyond those provided by the functional area codes or element type codes). For example, these duration elements have been defined for Spain: GEN DR PERIODO D, GEN DR PERIODO M, and GEN DR PERIODO A. While the functional area code GEN indicates that these elements are used across various functional areas (they have general relevance), and the element type code DR identifies them as duration elements, the abbreviations D, M, and A provide additional clues to how each element measures time. The duration element GEN DR PERIODO D measures time in days (dias) , hence the D in the element's name. Likewise, the code M reveals that the element GEN DR PERIODO M measures time in months (meses). As you become more familiar with the payroll rules created for Spain, these abbreviations will help you to further identify and understand the role played by each element.

This table lists the most common abbreviations used in the names of Spanish elements.

Abbreviations Used in PeopleSoft Global Payroll for Spain

English Equivalent

A

Years or annual

BS

Base

CC

Common contingencies

CP

Professional contingencies

CT

Tax quota

D

Days

DD

Deductions

DEV

Earnings

DIN

Income

EX

Exempt

M

Months or monthly

MN

Minimum

MX

Maximum

N

Number and negation

S

Segment

SPC

In kind

T

Total and quarterly

TP

Ceiling

U

Unit

Component Names (Suffixes)

In PeopleSoft Global Payroll for Spain, suffixes are used to name the components of earnings and deduction elements. For example, when you create an earning, deduction, or absence element in Global Payroll, you must define the components that make up the element, such as base, rate, unit, and percentage. The system automatically generates the components and accumulators for the element based on the calculation rule or accumulator periods that are used. The system also names the components and accumulators by appending a suffix to the element's name.

For example, suppose that you define the earning element named EARN1 with this calculation rule:

EARN1 = Rate × Unit

The system automatically creates two additional elements for the components in the calculation rule:

  • Rate element: EARN1_RATE.

  • Unit element: EARN1_UNIT.

The system creates suffixes to name the components of the element (_RATE and _UNIT).

In PeopleSoft Global Payroll for Spain, all components and accumulators have:

  • Country: ESP

  • Separator: _

In Global Payroll, all suffixes fall into one of these types:

  • Separator.

  • Earnings or deductions component suffixes.

  • Earnings or deductions accumulator suffixes.

  • Deduction arrears component suffixes.

  • Deduction arrears accumulator suffixes.

  • Absence entitlement component suffixes.

  • Absence entitlement accumulator suffixes.

To view all of the suffixes defined for Spain, use the Element Suffixes component (GP_SUFFIX) in Global Payroll .

See Understanding Elements.

For some elements, you need to use a functional area in the naming convention. The three-digit functional area codes are used in naming conventions to identify the functional area where the element is being used.

This table contains the functional area codes used in the names of Spanish elements:

Functional Area

Description

AJB

Gross to net

AJN

Net to gross

ANT

Seniority

AUS

Absences

AYP

Loans and advances

CLI

Customer-oriented accumulators

FNQ

Termination

GEN

General (multiple areas)

RTR

Retroactivity

SIN

Unions

SS

Social security

TAX

Taxes

XTR

Extra period

DEV

Devengos (earnings)

DD

Deduction

EXP

Expatriates

LIQ

Liquidation

PP

Pension plans

This table contains codes for all of the element types. Because not all element types are delivered for Spain, not all of these codes appear in the names of Spanish elements:

Element Type

Description

AE

Absence entitlement

AT

Absence take

AC

Accumulator

AR

Array

AA

Auto assigned

BR

Bracket

CT

Count

DT

Date

DD

Deduction

DR

Duration

ER

Earning

EG

Element group

EM

Error message

FC

Fictitious calculation

FM

Formula

GC

Generation control

HR

Historical rule

PR

Process

PO

Proration rule

RC

Rate code

RR

Rounding rule

SE

Section

SY

System element

VR

Variable

WA

Writable array