Skip to content

Practical Training Start (E3.3) ​

The E3.3 form announces the start of the practical training (πρακτική άσκηση) that follows the theoretical training of a program beneficiary (E3.2). It is submitted by the host business; the theoretical training provider is identified through the setTheory*() fields.

Overview ​

PropertyValue
Document ClassesPracticalTraining, PracticalTrainingCorrection
Action CodesWebE33 (declaration), WebE33C (correction)
Declaration ModelPracticalTrainingDeclaration
SchemaE33_v1.xsd (root AnaggeliesE33 / AnaggeliaE33)

Availability

As of November 2026 WebE33 / WebE33C 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\Training\PracticalTraining;
use OxygenSuite\OxygenErgani\Models\Training\PracticalTrainingDeclaration;

$declaration = PracticalTrainingDeclaration::make()
    // Submission & host business
    ->setBranchCode(0)
    ->setDypaServiceCode('101213')
    ->setLaborInspectionCode('24010')
    ->setInvitationCode('002')
    ->setMainActivityCode('7022')
    ->setBranchActivityCode('7022')
    ->setMunicipalityCode('91860101')
    ->setBranchWorkforce(men: 12, women: 8, minors: 0)
    // Beneficiary
    ->setLastName('ΠΑΠΑΔΟΠΟΥΛΟΣ')
    ->setFirstName('ΓΕΩΡΓΙΟΣ')
    ->setFatherName('ΝΙΚΟΛΑΟΣ')
    ->setMotherName('ΜΑΡΙΑ')
    ->setSex(Sex::MALE)
    ->setBirthDate('08/09/2000')
    ->setNationality('048')
    ->setIdType('ΔΑΤ')
    ->setIdNumber('ΑΒ123456')
    ->setMaritalStatus(MaritalStatus::SINGLE)
    ->setNumberOfChildren(0)
    ->setAfm('123456789')
    ->setAmka('08090012345')
    ->setEducationLevel('1')
    // Practical training
    ->setPlacementDate('15/09/2025')
    ->setPlacementTime('09:00')
    ->setScheduleDescription('ΔΕΥΤΕΡΑ - ΠΑΡΑΣΚΕΥΗ 09:00 - 17:00')
    ->setWeeklyHours('40,0')                       // free text
    ->setScheduleAttached(false)
    ->setReplacement(false)
    ->setSpecialtyCode('212208')
    ->setFixedTermPeriod('15/09/2025', '30/11/2025') // f_orismenou_apo / f_orismenou_ews
    // Theoretical training provider
    ->setTheoryProviderAfm('000000001')
    ->setTheoryProviderBranch(0)
    ->setLegalRepresentativeAfm('078776545')
    ->withDefaults(); // send every remaining optional field as an empty string

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

All fields are sent

ERGANI expects every E3.3 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->sendPracticalTraining($declaration);

Helpers ​

php
// Branch workforce counts (f_mpa_men / f_mpa_women / f_mpa_minors)
$declaration->setBranchWorkforce(12, 8);         // minors default to 0

// Practical training period (f_orismenou_apo / f_orismenou_ews)
$declaration->setFixedTermPeriod('15/09/2025', '30/11/2025');

// Theoretical training provider (EOPPEP code, category, AFM, branch, Kallikratis)
$declaration
    ->setTheoryEopepCode('1234567')
    ->setTheoryProviderCategory('001')
    ->setTheoryProviderAfm('000000001')
    ->setTheoryProviderBranch(0)
    ->setTheoryProviderMunicipalityCode('91860101');

Weekly hours are free text

In E3.3, f_week_hours is a free-text field (max 200 characters), so setWeeklyHours() accepts int|string and sends the value as-is (e.g. '40,0'). The E3.2 form uses a Greek decimal instead.

Corrections (WebE33C) ​

php
use OxygenSuite\OxygenErgani\Http\Documents\Training\PracticalTrainingCorrection;

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

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

// or
$responses = $ergani->sendPracticalTrainingCorrection($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).
setInvitationCode()f_programma_voucherstringNoInvitation (call) code (3 digits).
setEmployerOrganization()f_mer_organizationstringNoEmployer organization
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).
setBranchMenCount()f_mpa_menint|stringYesNumber of men employed at the branch.
setBranchWomenCount()f_mpa_womenint|stringYesNumber of women employed at the branch.
setBranchMinorsCount()f_mpa_minorsint|stringYesNumber of minors employed at the branch.
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 (see ParameterLookup::EDUCATION_LEVEL).
setVocationalTrainingSubject()f_mea_practical_educationstringNoVocational training subject code (3 digits).
setVoucherProgram()f_mea_voucherstring|boolNoWhether this is a voucher program.
setKayasCode()f_mea_kayasstringNoK.A.Y.A.S. code.
setPlacementDate()f_date_proslipsisDateTimeInterface|stringYesFirst day of practical training at the business (DD/MM/YYYY).
setPlacementTime()f_date_time_proslipsisstringNoStart time on the first day (HH:MM).
setScheduleDescription()f_orariostringNoWorking / training days and hours as free text (max 200 characters).
setWeeklyHours()f_week_hoursint|stringNoWeekly practical training hours as free text (e.g. "40,0").
setBreakDescription()f_orario_dialeimastringNoBreak hours as free text (max 200 characters).
setScheduleAttached()f_wres_externalstring|boolNoWhether the training days and hours are given in an attached file.
setReplacement()f_replace_programastring|boolNoWhether the beneficiary replaces another program beneficiary.
setSpecialtyCode()f_eidikothtastringYesSpecialty code (up to 6 digits, see ParameterLookup::SPECIALTY).
setStartDate()f_orismenou_apoDateTimeInterface|stringYesPractical training period start date (DD/MM/YYYY).
setEndDate()f_orismenou_ewsDateTimeInterface|stringYesPractical training period end date (DD/MM/YYYY).
setComments()f_commentsstringNoComments
setTheoryEopepCode()f_theory_eopep_codestringNoEOPPEP code of the theoretical training provider.
setTheoryProviderCategory()f_theory_edu_agency_categorystringNoCategory code of the theoretical training provider.
setTheoryProviderAfm()f_theory_mer_afmstringYesAFM of the theoretical training provider.
setTheoryProviderBranch()f_theory_mpa_aaint|stringYesBranch number of the theoretical training provider (0 for HQ).
setTheoryProviderMunicipalityCode()f_theory_mpa_kallikratisstringNoKallikratis code of the theoretical training provider's branch (8 digits).
setLegalRepresentativeAfm()f_mek_afmstringYesAFM of the responsible provider / legal representative.
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 PracticalTraining())->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 PracticalTraining())->pdf(
    $response[0]->protocol,
    $response[0]->submissionDate
);

file_put_contents('practical-training.pdf', base64_decode($pdfBase64));

Testing with Factories ​

php
use OxygenSuite\OxygenErgani\Models\Training\PracticalTrainingDeclaration;

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

$declaration = PracticalTrainingDeclaration::factory()
    ->forBranch(1)
    ->withTheoryProvider('000000001', eopepCode: '1234567', branch: 0)
    ->asCorrection('ΑΚ123', '01/10/2026')
    ->make();

See Also ​

Released under the MIT License.