Οδηγός Γρήγορης Εκκίνησης

Στείλτε το πρώτο σας γεγονός προσέλευσης Κάρτας Εργασίας σε τρία requests. Αυτό διαρκεί 5–10 λεπτά στο δοκιμαστικό περιβάλλον.

Τι θα κάνετε

1. Αυθεντικοποιηθείτε και αποκτήστε access token.
2. Υποβάλετε ένα γεγονός προσέλευσης για έναν εργαζόμενο.
3. Επιβεβαιώστε ότι το Εργάνη το δέχτηκε.

1. Αυθεντικοποίηση

curl -s -X POST \
  "https://trialv2eservices.yeka.gr/WebservicesAPI/Api/Authentication" \
  -H "Content-Type: application/json" \
  -d '{
    "Username": "myusername",
    "Password": "mypassword",
    "Usertype": "02"
  }'

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "accessTokenExpired": 10800,
  "refreshToken": "pnFB5Vdno3pd/YgkzBjDdn+Vxe29b5I+eTLSWD8cbWk=",
  "refreshTokenExpired": "2024-05-11T09:43:37.5388855+03:00"
}

Αντιγράψτε το accessToken — θα το χρησιμοποιήσετε στο βήμα 2.

2. Υποβολή γεγονότος προσέλευσης

Αυτή είναι μια πραγματική υποβολή WRKCardSE για έναν εργαζόμενο, με προσέλευση στις 08:58 στις 2024-05-04.

cURL

curl -s -X POST \
  "https://trialv2eservices.yeka.gr/WebservicesAPI/Api/Documents/WRKCardSE" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "Cards": {
      "Card": [
        {
          "f_afm_ergodoti": "094187530",
          "f_aa": "0",
          "f_comments": "Quickstart test submission",
          "Details": {
            "CardDetails": [
              {
                "f_afm": "028233026",
                "f_eponymo": "ΚΑΠΟΙΟΣ",
                "f_onoma": "ΛΑΜΠΡΟΣ",
                "f_type": "0",
                "f_reference_date": "2024-05-04",
                "f_date": "2024-05-04T08:58:00+03:00",
                "f_aitiologia": null
              }
            ]
          }
        }
      ]
    }
  }'

Node.js

const accessToken = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';

const response = await fetch(
  'https://trialv2eservices.yeka.gr/WebservicesAPI/Api/Documents/WRKCardSE',
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      Cards: {
        Card: [
          {
            f_afm_ergodoti: '094187530',
            f_aa: '0',
            f_comments: 'Quickstart test submission',
            Details: {
              CardDetails: [
                {
                  f_afm: '028233026',
                  f_eponymo: 'ΚΑΠΟΙΟΣ',
                  f_onoma: 'ΛΑΜΠΡΟΣ',
                  f_type: '0',
                  f_reference_date: '2024-05-04',
                  f_date: '2024-05-04T08:58:00+03:00',
                  f_aitiologia: null,
                },
              ],
            },
          },
        ],
      },
    }),
  },
);

const result = await response.json();
console.log(result);

PHP

<?php

$accessToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";

$payload = [
    "Cards" => [
        "Card" => [
            [
                "f_afm_ergodoti" => "094187530",
                "f_aa" => "0",
                "f_comments" => "Quickstart test submission",
                "Details" => [
                    "CardDetails" => [
                        [
                            "f_afm" => "028233026",
                            "f_eponymo" => "ΚΑΠΟΙΟΣ",
                            "f_onoma" => "ΛΑΜΠΡΟΣ",
                            "f_type" => "0",
                            "f_reference_date" => "2024-05-04",
                            "f_date" => "2024-05-04T08:58:00+03:00",
                            "f_aitiologia" => null,
                        ],
                    ],
                ],
            ],
        ],
    ],
];

$ch = curl_init("https://trialv2eservices.yeka.gr/WebservicesAPI/Api/Documents/WRKCardSE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $accessToken",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Δεν είστε σίγουροι τι σημαίνουν αυτά τα πεδία; Δείτε το Γλωσσάρι.

3. Επιβεβαίωση αποδοχής από τον Εργάνη

Επιτυχία

[
  {
    "id": "92",
    "protocol": "ΕΥΣ92",
    "submitDate": "04/05/2024 08:58"
  }
]

Ολοκληρώθηκε — μια τιμή protocol σημαίνει ότι το γεγονός καταγράφηκε. Αποθηκεύστε την.

Αποτυχία

{
  "message": "Για το Παράρτημα: 0\\nΤο ΑΦΜ δεν αντιστοιχεί στον συνδεδεμένο εργοδότη."
}

Αυτό το συγκεκριμένο μήνυμα σημαίνει ότι το f_afm_ergodoti δεν ταιριάζει με τον εργοδότη που είναι συνδεδεμένος με τα διαπιστευτήριά σας. Χρησιμοποιήστε το ΑΦΜ δοκιμαστικού εργοδότη του δοκιμαστικού περιβάλλοντος, ή το ΑΦΜ του πραγματικού εργοδότη σας αν δοκιμάζετε με τον πραγματικό λογαριασμό σας. Για άλλα μηνύματα σφαλμάτων, δείτε Διαχείριση Σφαλμάτων.

Τι ακολουθεί

• Βασικές Έννοιες — κατανοήστε προσέλευση/αποχώρηση, ημερομηνίες αναφοράς, και το παράθυρο εμπρόθεσμης υποβολής πριν φτιάξετε περισσότερες ροές εργασίας.
• Ροές Εργασίας — αποχώρηση, διορθώσεις, εκπρόθεσμες υποβολές, μαζικές αποστολές.
• Αυθεντικοποίηση — στρατηγική ανανέωσης token για παραγωγική χρήση.