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.