Skip to content

API Reference

This section provides detailed API documentation for the Oxygen Ergani package.

Package Structure

OxygenSuite\OxygenErgani
├── Ergani                          # Main facade class
├── Enums/                          # Enum definitions
├── Exceptions/                     # Exception classes
├── Http/
│   ├── Client                      # Base HTTP client
│   ├── Documents/                  # Document submission classes
│   │   ├── WorkCard/               # Work card submissions
│   │   ├── WorkTime/               # Work time declarations
│   │   ├── Hiring/                 # E3 hiring forms
│   │   ├── Termination/            # E5/E7 termination forms
│   │   ├── Dismissal/              # E6 dismissal forms
│   │   ├── Modification/           # MA modification forms
│   │   ├── Construction/           # E12 construction forms
│   │   ├── SixthDay/              # Sixth day declarations
│   │   ├── PreAnnouncement/       # Pre-announcement exemptions
│   │   └── Internship/            # E3.5 internship forms
│   └── Services/                   # Query services
├── Models/                         # Data models
├── Responses/                      # Response wrappers
└── Storage/                        # Token management

Core Classes

Ergani Facade

The Ergani class provides a simplified interface for common operations.

php
use OxygenSuite\OxygenErgani\Ergani;
use OxygenSuite\OxygenErgani\Enums\Environment;

$ergani = new Ergani($accessToken, Environment::PRODUCTION);

See Ergani Facade for full documentation.

Documents

Documents handle submissions to the ERGANI API:

ClassActionDescription
WorkCard-Employee check-ins/check-outs
DailyWorkTimeWTODailyDaily work time declarations
WeeklyWorkTimeWTOWeekWeekly work time declarations
OvertimeOVTOvertime declarations

Hiring Documents (E3)

ClassActionDescription
HiringNewWebE3NNew employee hiring
HiringModificationWebE3MTransfer from another company
HiringDeletionWebE3DEmployee lending FROM employer
HiringWithLendingWebE3PDHiring TO indirect employer

Termination Documents (E5)

ClassActionDescription
VoluntaryResignationWebE5NStandard resignation
ResignationNotificationWebE5ONotification of possible resignation
ResignationAfterNotificationWebE5AOConfirmed resignation after E5O
TerminationByDeathWebE5DTermination due to death
VoluntaryExitCompensationWebE5EVoluntary exit with severance
RetirementVoluntaryWebE5SVoluntary retirement
RetirementMandatoryWebE5DSMandatory retirement

Dismissal Documents (E6)

ClassActionDescription
DismissalWithoutNoticeWebE6NXPImmediate dismissal
DismissalWithNoticeWebE6NMPDismissal with notice
RetirementDismissalWebE6SXPRetirement dismissal
EndOfLoanWebE6LDEnd of loan arrangement
TrialPeriodTerminationWebE6LTTrial period termination
TransferWebE6MEmployee transfer

Fixed-Term Documents (E7)

ClassActionDescription
FixedTermTerminationWebE7NFixed-term contract termination

Modification Documents (MA)

ClassActionDescription
EmploymentModificationWebMAModify regular employee
BorrowedEmploymentModificationWebMADModify borrowed employee

Construction Documents (E12)

ClassActionDescription
ConstructionWorkDeclarationE12Construction work personnel declaration
ConstructionWorkCensusE12ApogrConstruction work census

Other Documents

ClassActionDescription
SixthDaySixthDaySixth day / extra shift declaration
PreAnnouncementExemptionExProanPre-announcement exemption
Internship57E3.5 internship declaration

Services

Services query ERGANI data:

ClassCodeDescription
EmployerInfoEX_BASE_01Employer details
BranchInfoEX_BASE_02Branch details
ParameterLookupEX_BASE_03Parameter lists
MonthlyStatusEX_BASE_04Monthly employee status
WorkforceStatusEX_BASE_05Workforce status
AcceptanceStatusEX_BASE_06Acceptance status

API Reference Pages

Released under the MIT License.