ePodací Hárok
ePodací Hárok is Slovenská Pošta’s official system for submitting shipments electronically and generating address labels. The plugin integrates directly with the ePodací Hárok REST API, letting you create and register shipments without leaving WooCommerce.
What You Can Do
- Generate an address label PDF for any WooCommerce order.
- Submit shipments to Slovenská Pošta individually (from the order edit page) or in bulk (from the orders list).
- Configure parcel type, class, payment method, and additional services per order or as store-wide defaults.
- Automatically detect Cash on Delivery orders and pre-fill the COD amount.
- Automatically populate the parcel tracking number after shipment creation.
- Log all API requests and responses for debugging.
Prerequisites
- An active ePodací Hárok account with Slovenská Pošta — credentials (User ID and API Key) are obtained directly from Slovenská Pošta, separately from the plugin license.
- An active plugin license.
In This Section
- Setup & Configuration — API credentials, sender information, and all default settings.
- Single Order — Creating, registering, and downloading a label for one order.
- Bulk Label Generation — Processing multiple orders at once from the orders list.
- Parcel Options Reference — All parcel categories, classes, payment types, and services.
Setup & Configuration
ePodací Hárok Setup & Configuration
All ePodací Hárok settings are in WP-Admin > Slovenská Pošta > ePodací Hárok.
API Credentials
These credentials are provided by Slovenská Pošta when you register for ePodací Hárok access.
| Field | Description |
|---|---|
| User ID | Your ePodací Hárok user identifier (also referred to as userId by the API). |
| API Key | The secret API key used to authenticate requests. Stored as a password field. |
Both fields are required. Shipment creation will fail if either is missing or incorrect.
Sender Information
The sender details are printed on every generated label. Fill in your business information.
| Field | Notes |
|---|---|
| Contact Name | Name of the responsible contact person. |
| Organization / Company | Your company or shop name. |
| Street address | Street name only (no house number). |
| City | City name. |
| ZIP / Postal code | Postal code. Required for validation. |
| Country code | Two-letter ISO code. Defaults to SK. |
| Phone number | Optional. |
| Email address | Defaults to the WordPress admin email if left blank. |
Shipment Defaults
These values pre-fill the ePH form on each order. They can always be overridden per order before creating the shipment.
| Setting | Options | Default |
|---|---|---|
| Parcel Category | See Parcel Options | Parcel (b) |
| Parcel Class | 1st Class (c1), 2nd Class (c2) | 2nd Class (c2) |
| Payment Type | See Parcel Options | Invoice (fa) |
| Reception Method | Na pošte — Drop off at post office (post); Kuriér — Courier pickup (courier) | Drop off at post office |
| Default Services | See Parcel Options | None |
Cash on Delivery
| Setting | Description |
|---|---|
| COD Payment Methods | Select one or more WooCommerce payment methods that should trigger automatic COD detection. When an order uses a listed payment method, the ePH form pre-fills the COD amount with the order total. |
| COD IBAN | The IBAN account number for COD transfers. Shown in the order metabox when COD is active and printed on the label. |
| Bulk Existing ePH Action | Controls what the bulk generator does when an order already has an existing ePH: Create and register a new ePH (overwrites the existing one) or Skip order. Default: overwrite. |
Insurance
| Setting | Description |
|---|---|
| Auto-Insurance | When enabled, the insurance amount field on the ePH order form is automatically pre-filled with the WooCommerce order total. The value can be changed before creating the shipment. Disabled by default. |
Tracking Integration
| Setting | Description |
|---|---|
| Auto-Apply Tracking Number | When enabled (default), the parcel barcode returned by the ePH API is automatically copied into the plugin’s tracking number field after shipment creation. This triggers background tracking sync without any manual steps. |
Logging
| Setting | Description |
|---|---|
| Enable API Call Logging | Records every ePH API request and response. Useful for diagnosing connection or validation issues. The log is capped at 500 entries (oldest are pruned automatically) and is visible at the bottom of the ePodací Hárok settings tab. Disabled by default — enable only while debugging and turn off afterwards. |
Single Order
Each WooCommerce order has a dedicated ePodací Hárok metabox in the order edit sidebar. You can use it to create a shipment, download the label, and reset or regenerate the ePH without leaving the order screen.
The ePH metabox is available on all WooCommerce orders, not only those using Slovenská Pošta shipping methods.
The ePH Metabox
Location: Order edit page → sidebar → Slovenská Pošta – ePodací Hárok box.
Before Creating a Shipment
When no ePH has been created yet, the metabox shows an edit form with the following fields:
| Field | Description |
|---|---|
| Weight | Total shipment weight in kilograms. Auto-calculated from order product weights and the packaging weight setting. |
| Parcel Category | Type of shipment. Defaults to the store-wide setting. See Parcel Options. |
| Parcel Class | Delivery class (1st or 2nd). Defaults to the store-wide setting. |
| Payment Type | How postage is paid. Defaults to the store-wide setting. See Parcel Options. |
| Services | Optional add-on services (e.g. Fragile, Advice of Delivery). See Parcel Options. |
| COD Amount | Cash on Delivery amount in EUR. Only relevant if COD is applicable. |
| Insurance Amount | Declared value for insurance in EUR. |
| Note | Free-text note on the shipment. Defaults to the WooCommerce order number. |
Auto-Detection
When the metabox form loads, several fields are pre-filled automatically based on order data:
Cash on Delivery: If the order’s WooCommerce payment method is listed in the COD Payment Methods setting, the COD amount is pre-filled with the order total. You can adjust the amount before creating the shipment.
Non-Stackable packaging:
If any product in the order has dimensions that trigger non-standard packaging detection, the Non-Stackable (nsk) service is automatically checked. This reflects what would be sent to the API.
Pickup-point delivery service:
For orders shipping via Balík na Poštu or BalikoBOX, the Delivery to Post Office / BalikoBOX / PoštaPOINT (pr) service is automatically checked and locked — it cannot be unchecked for these shipping methods.
Creating a Shipment
Click Create and Register Shipment. The plugin performs the following steps in a single action:
- Creates a new ePodací Hárok sheet via the API.
- Adds the parcel to the sheet with all configured details.
- Generates the address label PDF.
- Registers the sheet (submits it to Slovenská Pošta).
- Downloads and stores the label PDF locally under
/wp-content/uploads/wcsp-eph-labels/.
If Auto-Apply Tracking Number is enabled, the parcel barcode is also written to the order’s tracking number field at this point.
After Registration
Once a shipment is created and registered, the form is replaced by a summary view showing:
- Parcel number — the barcode assigned by Slovenská Pošta.
- A read-only summary of the submitted fields (weight, category, class, payment type, services, COD, insurance).
- A Registered badge when the sheet has been successfully submitted.
- A Download Label button — downloads the locally stored label PDF.
- A Regenerate ePH button — clears all ePH data for this order and reopens the edit form, allowing you to start over. This does not cancel the previously registered shipment with Slovenská Pošta.
Order List Column
When ePH data exists on an order, a summary badge is shown in the orders list:
- Parcel category label and weight.
- COD amount (if greater than zero).
- Insurance amount (if greater than zero).
- An Edit link that opens a quick-edit modal for category, weight, COD, and insurance.
- A Download ePH link if a label PDF is available.
Bulk Label Generation
You can create and register ePH shipments for multiple orders in one operation directly from the WooCommerce orders list.
Starting a Bulk Generation
- Go to WP-Admin > WooCommerce > Orders.
- Select the orders you want to process using the row checkboxes.
- Open the Bulk actions dropdown and choose Generate ePH Labels.
- Click Apply.
A settings dialog opens before any processing begins.
Bulk Settings Dialog
The dialog lets you set shared shipment parameters that apply to all selected orders. Individual order details (recipient address, weight, COD) are still taken from each order’s own data.
| Setting | Description |
|---|---|
| Parcel Category | Shipment type for all processed orders. See Parcel Options. |
| Parcel Class | Delivery class (1st or 2nd). |
| Payment Type | Postage payment method. See Parcel Options. |
| Services | Add-on services to apply to all shipments. See Parcel Options. |
| Note | Free-text note on all shipments. |
Confirm the settings to start processing. Each order is processed sequentially.
Handling Orders That Already Have an ePH
If a selected order already has an existing ePH record, the behavior is controlled by the Bulk Existing ePH Action setting in ePodací Hárok settings:
| Option | Behavior |
|---|---|
| Create and register a new ePH (default) | Clears the existing ePH data and creates a new shipment. |
| Skip order | Leaves existing ePH data unchanged and skips to the next order. |
Results
After processing, a results summary is displayed:
- Successful: Orders that were created and registered, each with a Download Label link for the generated PDF.
- Skipped: Orders that were skipped because they already had an ePH and the action was set to skip.
- Errors: Orders where creation or registration failed, with error details from the API.
Labels from successful orders can be downloaded individually from the results summary, or later from each order’s ePH metabox or the order list column.
Parcel Options Reference
Parcel Categories
The parcel category defines the product type registered with Slovenská Pošta. Select the category that matches the actual shipment.
| Code | Name |
|---|---|
b | Parcel (default) |
r | Registered Letter |
pl | Insured Letter |
uz | Official Mail |
ek | Express Courier |
ems | EMS Shipment |
epg | EPG Business Parcel |
zb | Parcel for Contract Customers |
zbc | Parcel for Contract Customers — Consignment |
lt | Small Parcel |
epo1 | Easy Expres 1 |
epo10 | Easy Expres 10 |
pz | Prime Shipment |
olz | Letter |
Not all categories are available to all Slovenská Pošta contract types. Check your ePodací Hárok agreement to confirm which categories apply to your account.
Parcel Classes
| Code | Name |
|---|---|
c2 | 2nd Class (default) |
c1 | 1st Class |
Payment Types
The payment type specifies how postage is settled with Slovenská Pošta.
| Code | Name |
|---|---|
fa | Invoice (default) |
up | Postage Credit |
vsz | Franking Machine |
pz | Postage Stamps |
pr | Paid by Bank Transfer |
h | Paid in Cash |
vps | Postal Service Item |
ol | Online |
Services
Additional services that can be added to a shipment. Services are configured per order or set as store-wide defaults in ePodací Hárok settings.
| Code | Name | Notes |
|---|---|---|
pr | Delivery to Post Office / BalikoBOX / PoštaPOINT | Auto-enforced for orders using Balík na Poštu or BalikoBOX shipping methods. Cannot be unchecked on those orders. |
nsk | Non-Stackable | Auto-detected when product dimensions trigger non-standard packaging. |
d | Advice of Delivery | |
doh | Deliver by 10:00 | |
f | Fragile | |
iod | Delivery Information | |
ndo | Do Not Forward | |
neu | Do Not Store | |
nev | Do Not Return | |
od | Repeated Delivery | |
sv | Authorization Excluded | |
svd | Return Confirmed Documentation | |
vr | Addressee Only | |
vt | Goods Exchange |
Service availability depends on the selected parcel category and your Slovenská Pošta contract.