艾尔伽尼 Rust SDK

ergani 是一个 Rust SDK，用于与 艾尔伽尼 的 API 交互。

贡献者

艾尔伽尼 Rust SDK 是由 LOGIC (https://withlogic.co/) 开发的相关 艾尔伽尼 Python SDK 的 Rust 版本。

要求

Rust 1.76.0 或更高版本

安装

您可以在 crates.io 上找到 ergani 包，并通过您喜欢的包管理器进行安装。

cargo install ergani

使用方法

创建客户端

要创建新的艾尔伽尼客户端，您需要设置艾尔伽尼用户名、密码，以及可选的艾尔伽尼 API 基础 URL，默认为 https://trialeservices.yeka.gr/WebServicesAPI/api。

let ergani_username = env::var("ERGANI_USERNAME") ?;
let ergani_password = env::var("ERGANI_PASSWORD") ?;
let ergani_base_url = env::var("ERGANI_BASE_URL")
.unwrap_or("https://trialeservices.yeka.gr/WebServicesAPI/api".to_string());

let client = ErganiClient::new(ergani_username, ergani_password, Some(ergani_base_url)).await?;

如果您打算为多个公司实体使用此包，则需要为每个实体创建带有相应凭据的单独客户端实例。

以下示例中将使用上述的 ergani_client。

工作卡

向艾尔伽尼提交工作卡记录，以申报员工的活动（到达，离开）。

async fn submit_work_card(company_work_cards: Vec<CompanyWorkCard>) -> Result<Vec<SubmissionResponse>>

示例

let work_card_movement_datetime =
    NaiveDateTime::parse_from_str("2024-03-20 10:00", "%Y-%m-%d %H:%M")
    .unwrap()
    .and_utc();

let work_card_submission_date = NaiveDate::parse_from_str("2022-05-04", "%Y-%m-%d").unwrap();

let work_card = vec![CompanyWorkCardBuilder::builder()
    .set_employer_tax_identification_number("123456789")
    .set_business_branch_number(0)
    .set_comments(Some("Σχόλια"))
    .set_card_details(vec![WorkCardBuilder::builder()
        .set_employee_tax_identification_number("123456789")
        .set_employee_last_name("Last")
        .set_employee_first_name("First")
        .set_work_card_movement_type(WorkCardMovementType::Arrival)
        .set_work_card_submission_date(work_card_submission_date)
        .set_work_card_movement_datetime(work_card_movement_datetime)
        .set_late_declaration_justification(Some(LateDeclarationJustificationType::PowerOutage))
        .build()?])
    .build()];

let response = ergani_client.submit_work_card(work_card).await?;

response.iter().for_each(|r| {
    println!("{:?}", r);
});

注意：您可以根据上面的示例同时为多个公司分支的多个员工提交工作卡。

加班

向艾尔伽尼提交加班记录，以申报员工的加班。

async fn submit_overtime(company_overtimes: Vec<CompanyOvertime>) -> Result<Vec<SubmissionResponse>>

示例

let start_time = "2024-03-01T12:00:00Z".parse::<DateTime<Utc>>().unwrap();
let end_time = "2024-03-01T20:00:00Z".parse::<DateTime<Utc>>().unwrap();
let related_protocol_date = NaiveDate::from_ymd_opt(2024, 3, 1).unwrap();

let company_overtimes = vec![CompanyOvertimeBuilder::builder()
    .set_business_branch_number(0)
    .set_sepe_service_code("10000")
    .set_business_primary_activity_code("1000")
    .set_business_branch_activity_code("1010")
    .set_kallikratis_municipal_code("10000000")
    .set_legal_representative_tax_identification_number("123456789")
    .set_employee_overtimes(vec![OvertimeBuilder::builder()
        .set_employee_tax_identification_number("123456789")
        .set_employee_social_security_number("00000000000")
        .set_employee_last_name("Last")
        .set_employee_first_name("First")
        .set_overtime_date(NaiveDate::from_ymd_opt(2024, 3, 1).unwrap())
        .set_overtime_start_time(start_time)
        .set_overtime_end_time(end_time)
        .set_overtime_cancellation(false)
        .set_employee_profession_code("1234")
        .set_overtime_justification(
            OvertimeJustificationType::AccidentPreventionOrDamageRestoration,
        )
        .set_weekly_workdays_number(WeeklyWorkDays::Five)
        .set_asee_approval(Some("ΑΣΕΕ"))
        .build()
        .unwrap()])
    .set_related_protocol_id(Some("Αρ. Πρωτ. Σχετ."))
    .set_related_protocol_date(Some(related_protocol_date))
    .set_employer_organization(Some("Εργοδότης"))
    .set_business_secondary_activity_code_1(Some("1011"))
    .set_business_secondary_activity_code_2(Some("1012"))
    .set_business_secondary_activity_code_3(Some("1013"))
    .set_business_secondary_activity_code_4(Some("1014"))
    .set_comments(Some("Σχόλια"))
    .build()];

let response = ergani_client.submit_overtime(company_overtimes).await?;

注意：您可以根据上面的示例同时为多个公司分支的多个员工提交加班记录。

每日日程

向艾尔伽尼提交每日日程，以申报无固定日程的员工（例如轮班工人）的日程。

async fn submit_daily_schedule(company_daily_schedules: Vec<CompanyDailySchedule>) -> Result<Vec<SubmissionResponse>>

示例

let start_time = "2024-03-01T12:00:00Z".parse::<DateTime<Utc>>().unwrap();
let end_time = "2024-03-01T20:00:00Z".parse::<DateTime<Utc>>().unwrap();
let related_protocol_date = NaiveDate::from_ymd_opt(2024, 3, 1).unwrap();

let company_daily_schedules = vec![CompanyDailyScheduleBuilder::builder()
    .set_business_branch_number(0)
    .set_start_date(NaiveDate::from_ymd_opt(2024, 3, 1).unwrap())
    .set_end_date(NaiveDate::from_ymd_opt(2024, 3, 2).unwrap())
    .set_employee_schedules(vec![EmployeeDailyScheduleBuilder::builder()
        .set_employee_tax_identification_number("123456789")
        .set_employee_last_name("Last")
        .set_employee_first_name("First")
        .set_schedule_date(NaiveDate::from_ymd_opt(2024, 3, 3).unwrap())
        .set_workday_details(vec![
            WorkDayDetailsBuilder::builder()
                .set_work_type(ScheduleWorkType::WorkFromHome)
                .set_start_time(start_time)
                .set_end_time(end_time)
                .build()?,
            WorkDayDetailsBuilder::builder()
                .set_work_type(ScheduleWorkType::WorkFromOffice)
                .set_start_time(start_time)
                .set_end_time(end_time)
                .build()?,
        ])
        .build()])
    .set_related_protocol_id(Some("1"))
    .set_related_protocol_date(Some(related_protocol_date))
    .set_comments(Some("Σχόλια"))
    .build()];

let response = ergani_client
    .submit_daily_schedule(company_daily_schedules)
    .await?;

每周日程

向艾尔伽尼提交每周日程，以申报有固定日程的员工的日程。

async fn submit_weekly_schedule(company_weekly_schedules: Vec<CompanyWeeklySchedule>) -> Result<Vec<SubmissionResponse>>

示例

    let start_time = "2024-03-01T12:00:00Z".parse::<DateTime<Utc>>().unwrap();
let end_time = "2024-03-01T20:00:00Z".parse::<DateTime<Utc>>().unwrap();
let related_protocol_date = NaiveDate::from_ymd_opt(2024, 3, 1).unwrap();
let schedule_date = NaiveDate::from_ymd_opt(2024, 3, 3).unwrap();

let company_weekly_schedules = vec![CompanyWeeklyScheduleBuilder::builder()
    .set_business_branch_number(0)
    .set_start_date(NaiveDate::from_ymd_opt(2024, 3, 1).unwrap())
    .set_end_date(NaiveDate::from_ymd_opt(2024, 3, 2).unwrap())
    .set_employee_schedules(vec![EmployeeWeeklyScheduleBuilder::builder()
        .set_employee_tax_identification_number("123456789")
        .set_employee_last_name("Last")
        .set_employee_first_name("First")
        .set_schedule_date(schedule_date)
        .set_workday_details(vec![
            WorkDayDetailsBuilder::builder()
                .set_work_type(ScheduleWorkType::WorkFromHome)
                .set_start_time(start_time)
                .set_end_time(end_time)
                .build()?,
            WorkDayDetailsBuilder::builder()
                .set_work_type(ScheduleWorkType::WorkFromOffice)
                .set_start_time(start_time)
                .set_end_time(end_time)
                .build()?,
        ])
        .build()])
    .set_related_protocol_id(Some("1"))
    .set_related_protocol_date(Some(related_protocol_date))
    .build()];

let response = ergani_client
    .submit_weekly_schedule(company_weekly_schedules)
    .await?;

注意：您可以根据上面的示例同时为多个公司分支的多个员工提交每周日程。

完整的参考文档可在 https://docs.rs/ergani/latest/ergani/ 查找。

术语表

术语表可能有助于您查看艾尔伽尼 API 的官方文档（https://eservices.yeka.gr/(S(ayldvlj35eukgvmzrr055oe5))/Announcements.aspx?id=257）。

工作卡

工作卡运动类型

工作卡正当性

加班

超时正当性

每日日程

每周日程

工作类型

许可证

本项目采用MIT 许可证