Skip to content

Apprenticeship Start (E3.4) ​

The E3.4 form announces the start of an apprenticeship (μαθητεία) at a business for a student of a vocational school (e.g. EPAS / EPAL apprenticeship year).

Overview ​

PropertyValue
Document ClassesApprenticeship, ApprenticeshipCorrection
Action CodesWebE34 (declaration), WebE34C (correction)
Declaration ModelApprenticeshipDeclaration
SchemaE34_v1.xsd (root AnaggeliesE34 / AnaggeliaE34)

Availability

As of November 2026 WebE34 / WebE34C are accepted by production. The trial environment does not have them deployed yet and rejects them with XSD File not found / Type: ... not valid.

Basic Usage ​

php
use OxygenSuite\OxygenErgani\Enums\MaritalStatus;
use OxygenSuite\OxygenErgani\Enums\Sex;
use OxygenSuite\OxygenErgani\Http\Documents\Apprenticeship\Apprenticeship;
use OxygenSuite\OxygenErgani\Models\Apprenticeship\ApprenticeshipDeclaration;

$declaration = ApprenticeshipDeclaration::make()
    // Submission & employer
    ->setBranchCode(0)
    ->setDypaServiceCode('101213')
    ->setLaborInspectionCode('24010')
    ->setProgramCode('001')
    ->setMainActivityCode('7022')
    ->setBranchActivityCode('7022')
    ->setMunicipalityCode('91860101')
    // Apprentice
    ->setLastName('ΠΑΠΑΔΟΠΟΥΛΟΣ')
    ->setFirstName('ΓΕΩΡΓΙΟΣ')
    ->setFatherName('ΝΙΚΟΛΑΟΣ')
    ->setMotherName('ΜΑΡΙΑ')
    ->setSex(Sex::MALE)
    ->setBirthDate('08/09/2005')
    ->setNationality('048')
    ->setIdType('ΔΑΤ')
    ->setIdNumber('ΑΒ123456')
    ->setMaritalStatus(MaritalStatus::SINGLE)
    ->setNumberOfChildren(0)
    ->setAfm('123456789')
    ->setAmka('08090512345')
    ->setEducationLevel('1')                       // 0-4 only
    ->setSchoolCode('4002')
    ->setSpecialtyGroupCode('4004')
    // Apprenticeship
    ->setApprenticeshipPeriod('14/09/2025', '30/06/2026') // f_date_proslipsis / f_orismenou_ews
    ->setPlacementTime('09:00')
    ->setScheduleDescription('ΔΕΥΤΕΡΑ - ΠΑΡΑΣΚΕΥΗ 09:00 - 15:00')
    ->setWeeklyHours(30)                           // free text, sent as "30"
    ->setScheduleAttached(false)
    ->setSpecialtyCode('4013')
    ->setGrossSalary(1000.0)                       // f_apodoxes → "1.000,00"
    ->setContractNumber('ΣΥΜΒ-2025/123')
    // Sign-off
    ->setLegalRepresentativeAfm('078776545')
    // last name, first name, capacity, address, AFM (or the individual setCertifier*() setters)
    ->setCertifier('ΛΟΓΙΣΤΗΣ', 'ΜΑΡΙΑ', 'ΛΟΓΙΣΤΡΙΑ', 'ΣΤΑΔΙΟΥ 10', '000000001')
    ->withDefaults(); // send every remaining optional field as an empty string

$response = (new Apprenticeship())->handle($declaration);

All fields are sent

ERGANI expects every E3.4 element to be present, even when empty. Call withDefaults() after setting your values to fill the remaining fields with empty strings.

Via Ergani Facade ​

php
use OxygenSuite\OxygenErgani\Ergani;

$ergani = new Ergani($accessToken);

$responses = $ergani->sendApprenticeship($declaration);

Helpers ​

php
// Apprenticeship period (f_date_proslipsis / f_orismenou_ews)
$declaration->setApprenticeshipPeriod('14/09/2025', '30/06/2026');

// School / specialty group not in the code list: leave the code empty and use free text
$declaration
    ->setSchoolCode('')
    ->setSchoolOther('ΕΠΑΣ ΜΑΘΗΤΕΙΑΣ ΑΘΗΝΑΣ')     // max 50 characters
    ->setSpecialtyGroupCode('')
    ->setSpecialtyGroupOther('ΤΟΜΕΑΣ ΠΛΗΡΟΦΟΡΙΚΗΣ'); // max 50 characters

E3.4 validation rules

  • setEducationLevel() only accepts 0-4, and setEmployerOrganization() is limited to 20 characters.
  • f_date_time_proslipsis (setPlacementTime()), f_orario (setScheduleDescription()), f_week_hours (setWeeklyHours()) and f_contract (setContractNumber()) are required.
  • f_week_hours is free text (setWeeklyHours(40) sends "40"), while f_apodoxes is a Greek decimal (setGrossSalary(1000.0) sends "1.000,00").

Corrections (WebE34C) ​

php
use OxygenSuite\OxygenErgani\Http\Documents\Apprenticeship\ApprenticeshipCorrection;

$declaration->setRelatedSubmission(               // f_protocol_sx / f_date_ypovolis_sx
    $original[0]->protocol,
    $original[0]->submissionDate,
);

$response = (new ApprenticeshipCorrection())->handle($declaration);

// or
$responses = $ergani->sendApprenticeshipCorrection($declaration);

Field Reference ​

Every element must be present in the payload; "Required" marks the elements whose XSD pattern does not accept an empty value.

MethodAPI FieldTypeRequiredDescription
setBranchCode()f_aa_pararthmatosint|stringYesBranch sequence number (0 for HQ)
setRelatedProtocol()f_protocol_sxstringNoProtocol of the original declaration (corrections only).
setRelatedDate()f_date_ypovolis_sxDateTimeInterface|stringNoSubmission date of the original declaration (corrections only).
setDypaServiceCode()f_ypiresia_oaedstringYesDYPA service code.
setLaborInspectionCode()f_ypiresia_sepestringYesLabour inspectorate service code (5 digits).
setProgramCode()f_programma_novitiatestringYesApprenticeship program code (3 digits).
setEmployerOrganization()f_mer_organizationstringNoEmployer organization (max 20 characters).
setMainActivityCode()f_mer_stakod1stringYesMain activity code (KAD, 4 digits).
setSecondaryActivityCode1()f_mer_stakod2stringNoSecondary activity code1
setSecondaryActivityCode2()f_mer_stakod3stringNoSecondary activity code2
setSecondaryActivityCode3()f_mer_stakod4stringNoSecondary activity code3
setSecondaryActivityCode4()f_mer_stakod5stringNoSecondary activity code4
setBranchActivityCode()f_mpa_stakodstringYesActivity code (KAD) of the branch.
setMunicipalityCode()f_mpa_kallikratisstringYesKallikratis code of the branch (8 digits).
setLastName()f_mea_eponimostringYesLast name
setFirstName()f_mea_onomastringYesFirst name
setFatherLastName()f_mea_eponimo_paterastringNoFather last name
setFatherName()f_mea_onoma_paterastringYesFather name
setMotherLastName()f_mea_eponimo_miterasstringNoMother last name
setMotherName()f_mea_onoma_miterasstringYesMother name
setSex()f_mea_sexSex|string|intYes0=Male, 1=Female (or use Sex enum)
setBirthPlace()f_mea_birth_citystringNoBirth place
setBirthDate()f_mea_date_birthDateTimeInterface|stringYesBirth date (DD/MM/YYYY)
setNationality()f_mea_nationalitystringYesNationality code (3 digits, see ParameterLookup::NATIONALITY).
setIdType()f_mea_typos_taytotitasstringYesIdentity document type (see ParameterLookup::ID_TYPE).
setIdNumber()f_mea_ar_taytotitasstringYesIdentity document number
setIdIssuingAuthority()f_mea_ekdousastringNoId issuing authority
setIdIssueDate()f_mea_date_ekdosisDateTimeInterface|stringNoIdentity document issue date (DD/MM/YYYY)
setIdExpiryDate()f_mea_date_ekdosis_lixiDateTimeInterface|stringNoIdentity document expiry date (DD/MM/YYYY)
setResidencePermit()f_mea_res_permitstring|boolNoWhether the beneficiary holds a residence or work permit.
setResidencePermitType()f_mea_res_permit_typestringNoResidence permit type (see ParameterLookup::RESIDENCE_PERMIT).
setResidencePermitNumber()f_mea_res_permit_arstringNoResidence permit number
setResidencePermitExpiry()f_mea_res_permit_lixiDateTimeInterface|stringNoResidence permit expiry date (DD/MM/YYYY)
setMaritalStatus()f_mea_marital_statusMaritalStatus|string|intYes0=Single, 1=Married, 2=Divorced, 3=Widowed (or use MaritalStatus enum)
setNumberOfChildren()f_mea_ar_teknonint|stringYesNumber of children
setAfm()f_mea_afmstringYesBeneficiary tax ID (AFM)
setTaxOffice()f_mea_doystringNoTax office code (4 digits, see ParameterLookup::DOY).
setInsuranceAgency()f_mea_insurance_agencystringNoMain insurance agency code (see ParameterLookup::PRIMARY_INSURANCE).
setAmika()f_mea_am_ikastringNoe-EFKA insurance registry number.
setAmka()f_mea_amkastringNoBeneficiary social security number (AMKA)
setUnemploymentCardNumber()f_mea_code_anergiasstringNoUnemployment card number
setMinorBookNumber()f_mea_ar_vivliou_anilikoustringNoMinor book number
setAddress()f_mea_dieythinsistringNoAddress
setResidenceMunicipalityCode()f_mea_kallikratisstringNoKallikratis code of the beneficiary residence (8 digits).
setPostalCode()f_mea_tkstringNoPostal code
setPhone()f_mea_tilstringNoPhone
setFax()f_mea_faxstringNoFax
setEmail()f_mea_emailstringNoE-mail
setEducationLevel()f_mea_epipedo_morfosisstringYesEducation level code — E3.4 accepts only 0-4.
setSchoolCode()f_mea_noviciate_sxolhstringNoVocational school code (4 digits); leave empty and use setSchoolOther() if not listed.
setSchoolOther()f_mea_noviciate_sxolh_otherstringNoSchool name as free text when the school code is not listed (max 50 characters).
setSpecialtyGroupCode()f_mea_noviciate_omadastringNoSpecialty group / sector code (4 digits); leave empty and use setSpecialtyGroupOther() if not listed.
setSpecialtyGroupOther()f_mea_noviciate_omada_otherstringNoSpecialty group as free text when the group code is not listed (max 50 characters).
setPlacementDate()f_date_proslipsisDateTimeInterface|stringYesFirst day of the apprenticeship (DD/MM/YYYY).
setPlacementTime()f_date_time_proslipsisstringYesStart time on the first day (HH:MM).
setScheduleDescription()f_orariostringYesWorking / training days and hours as free text (max 200 characters).
setWeeklyHours()f_week_hoursint|stringYesWeekly apprenticeship hours as free text (e.g. "40").
setBreakDescription()f_orario_dialeimastringNoBreak hours as free text (max 200 characters).
setScheduleAttached()f_wres_externalstring|boolYesWhether the working days and hours are given in an attached file.
setSpecialtyCode()f_novitiate_educationstringYesApprenticeship specialty code (4 digits).
setGrossSalary()f_apodoxesfloatYesGross apprentice wage (Greek float, 1000.0 → "1.000,00").
setEndDate()f_orismenou_ewsDateTimeInterface|stringYesApprenticeship end date (DD/MM/YYYY).
setContractNumber()f_contractstringYesApprenticeship contract number / reference (max 50 characters).
setComments()f_commentsstringNoComments
setLegalRepresentativeAfm()f_mek_afmstringYesAFM of the responsible provider / legal representative.
setCertifierLastName()f_eponymostringYesCertifier last name
setCertifierFirstName()f_onomastringYesCertifier first name
setCertifierCapacity()f_idiotitastringYesCapacity of the certifying person (e.g. accountant)
setCertifierAddress()f_dieythinsistringYesCertifier address
setCertifierAfm()f_afm_bebaiwnstringYesAFM of the certifying person
setFormFile()f_filestringNoSigned form (base64-encoded PDF).
setForeignFile()f_foreign_filestringNoThird-country national labour-market access documents (base64-encoded PDF).
setMinorFile()f_young_filestringNoMinor worker book (base64-encoded PDF).

Response Handling ​

php
$response = (new Apprenticeship())->handle($declaration);

foreach ($response as $result) {
    echo $result->id;              // Unique submission ID
    echo $result->protocol;        // Protocol number
    echo $result->submissionDate->format('d/m/Y H:i:s');
}

Retrieve PDF ​

php
$pdfBase64 = (new Apprenticeship())->pdf(
    $response[0]->protocol,
    $response[0]->submissionDate
);

file_put_contents('apprenticeship.pdf', base64_decode($pdfBase64));

Testing with Factories ​

php
use OxygenSuite\OxygenErgani\Models\Apprenticeship\ApprenticeshipDeclaration;

$declaration = ApprenticeshipDeclaration::factory()->make();

$declaration = ApprenticeshipDeclaration::factory()
    ->forBranch(1)
    ->asMinor('ΒΑ123456')                        // minor worker book number
    ->asCorrection('ΑΚ123', '01/10/2026')
    ->make();

See Also ​

Released under the MIT License.