Guidelines for Associating Employee Social Insurance Details Cards for Oman
The card association record associates the Employee Social Insurance Details calculation card with the employee’s tax reporting unit.
![Employee social insurance details calculation card](images/_hdl-oman-emp-social-insurance-card-association.png)
The associated tax reporting unit is defined in the card association. The card association detail allows the Social Insurance Details card component to be associated with the employee’s assignments.
Card Association Attributes for Employee Social Insurance Details
The Card Association record type associates the Employee Social Insurance Details card with the employee’s tax reporting unit.
HCM Data Loader Attribute | Alternative User Key Attributes | Functional Description |
---|---|---|
SourceSystemId | CardSequence, TaxReportingUnitName, LegislativeDataGroupName, AssignmentNumber, DirCardDefinitionName | A unique identifier for the Employee Social Insurance Details card association. For new card associations supply the source key attributes. You can also identify card components with the user key attributes. |
SourceSystemOwner | N/A | The name of the source system owner used to generate the source system ID. |
LegislativeDataGroupName | N/A | The name of the legislative data group for the card definition. |
DirCardId(SourceSystemId) | CardSequence, AssignmentNumber, DirCardDefinitionName, LegislativeDataGroupName | The parent Employee Social Insurance Details calculation card
should be identified by using the same key type used to identify the
calculation card. When using source keys, supply this attribute with the value supplied for the calculation card’s SourceSystemId attribute. Otherwise, supply the user key attributes with the same values as the parent calculation card |
EffectiveStartDate | N/A | The start date of the card association or the update to the card association if you are providing date-effective history. This must be after or equal to the EffectiveStartDate provided for the Employee Social Insurance Details calculation card. |
TaxReportingUnitName | N/A | The name of the tax reporting unit to associate with the Employee Social Insurance Details calculation card. If source keys are used to identify the card association, you must still specify the LegislativeDataGroupName attribute to identify the tax reporting unit. |
Card Association Detail Attributes for Employee Social Insurance Details
The card association detail associates the Social Insurance Details card component with the payroll assignments for the employee.
If the employee has more than one payroll assignment provide a card association detail record for each payroll assignment.
HCM Data Loader Attribute | Alternative User Key Attributes | Functional Description |
---|---|---|
SourceSystemId | CardSequence, TaxReportingUnitName, LegislativeDataGroupName, AssignmentNumber, DirCardDefinitionName | A unique identifier for the card association detail record. For new card associations supply the source key attributes. You can also identify card components with the user key attributes. |
SourceSystemOwner | N/A | The name of the source system owner used to generate the source system ID. |
LegislativeDataGroupName | N/A | The name of the legislative data group for the card definition. |
DirRepCardId(SourceSystemId) | CardSequence, TaxReportingUnitName, LegislativeDataGroupName, AssignmentNumber, DirCardDefinitionName |
The parent card association record should be identified by using the same key type supplied to against the card association. When using source keys, supply this attribute with the value supplied for the card’s association SourceSystemId attribute. Otherwise, supply the user key attributes with the same values as the parent card association. |
EffectiveStartDate | N/A | The effective start date of the card association. |
EffectiveEndDate | N/A | The effective end date of the card association. |
DirCardCompId(SourceSystemId) | CardSequence, ComponentSequence, AssignmentNumber, DirCardDefinitionName, LegislativeDataGroupName, DirCardCompDefName | Thecard component this association is for. Supply either the source system ID value or user key attributes to identify the Social Insurance Details card component. |
AssociationAssignmentId(SourceSystemId) | AssociationAssignmentNumber | Identify the employee’s assignment to associate with card component. |
Example of Loading Employee Social Insurance Details Card Associations
This example creates the tax reporting unit association for the existing Employee Social Insurance Details card belonging to employee assignment E3715. User keys are provided to reference the existing Employee Social Insurance Details card and Social Insurance Details card component on the assumption they were auto generated and therefore the source key values are unknown.
METADATA|CalculationCard|LegislativeDataGroupName|DirCardDefinitionName|EffectiveStartDate|AssignmentNumber|CardSequence
MERGE|CalculationCard|OM LDG|Employee Social Insurance Details|2024/01/01|E3715|1
METADATA|CardAssociation|LegislativeDataGroupName|DirCardDefinitionName|EffectiveStartDate|AssignmentNumber|CardSequence|TaxReportingUnitName
MERGE|CardAssociation|OM LDG|Employee Social Insurance Details|2024/01/01|E3715|1|OM TRU
METADATA|CardAssociationDetail|LegislativeDataGroupName|DirCardDefinitionName|EffectiveStartDate|AssignmentNumber|CardSequence|TaxReportingUnitName|DirCardCompDefName|ComponentSequence|AssociationAssignmentNumber
MERGE|CardAssociationDetail|OM LDG|Employee Social Insurance Details|2024/01/01|E3715|1|OM TRU|Social Insurance Details|1|E3715
When associating an auto-generated card you don’t need to include the Card Component unless also making changes to its values.