- Home
- Skills
- E-commerce
- Packeta Checkout for SK/CZ E-shops
Works with the AI Agents you already use
Packeta Checkout for SK/CZ E-shops
This skill makes your agent build a Packeta checkout for Slovak and Czech e-shops that holds up in production.
$12
Packeta Checkout for SK/CZ E-shops
Example session with this skill installed
Add Packeta pickup points, Z-BOX and cash on delivery to the checkout of my SvelteKit 3 + Spring Boot 4 shop. We ship to Slovakia and Czechia, we sell wine, and some customers buy on a company (IČO, DIČ, IČ DPH).
- Read your context and instructions
- Compiled the packeta checkout
Summary
Your checkout now supports
Packeta pickup points + Z-BOX for SK and CZ,
cash on delivery, and
company purchases with validated IČO / DIČ / IČ DPH. The backend validates the chosen point with Packeta, recomputes shipping and COD itself, and creates the packet when an order is confirmed.
Before writing code I checked your project: Order entity with Flyway migrations, SvelteKit 3 checkout using a form action, EUR-only prices. You sell wine, so I asked about age verification first. Per your answer, carts with 18+ items are limited to
18+ capable Packeta points (livePickupPoint: true). Home delivery is hidden for those carts, because Packeta age verification doesn't work on home delivery.
Files added / changed
| File | What |
|---|---|
db/migration/V7__packeta_delivery.sql | delivery_method, packeta_point_id, packeta_carrier_id, packeta_carrier_point_id, point snapshot, packeta_packet_id VARCHAR(20), is_company, ico, dic, ic_dph |
web/src/lib/packeta/packeta-widget.ts | Lazy loader for widget v6, typed Point |
web/src/lib/packeta/PacketaPicker.svelte | Picker with hidden inputs, visible error when the API key is missing |
web/src/lib/company-ids.ts | IČO / DIČ / IČ DPH validators (instant feedback) |
web/src/routes/checkout/+page.svelte | Delivery method switch, picker, "Nakupujem na firmu" fields |
api/.../packeta/PacketaClient.java | Point validation (retried), createPacket (not retried), UTF-8 XML, XXE-safe parsing |
api/.../checkout/CheckoutService.java | Server-side point validation, shipping + COD recomputation, conditional rules |
api/.../company/CompanyIds.java | Same validators on the server |
api/.../packeta/PacketaClientTest.java | 5 tests with MockRestServiceServer |
Rules now enforced on the server
| Rule | Pickup | Home delivery |
|---|---|---|
| Point selected and validated with Packeta | required | — |
Street, city, ZIP (^\d{3} ?\d{2}$) | not required | required |
Phone normalised to 421… / 420… | recommended | required |
Client-supplied deliveryPrice | ignored, recomputed | ignored, recomputed |
A forged request with a made-up packetaPointId now returns
400 with "Vybrané výdajné miesto nie je dostupné, vyberte prosím iné." It doesn't create an order.
Decisions that are still yours
PACKETA_API_KEY(public) goes inweb/src/env.ts.PACKETA_API_PASSWORDstays server-only, in your secret store and never committed.- Sender indication (
eshop) from your Packeta client section.
If Packeta is unreachable during checkout: I set it to fail closed (the customer picks again). Switch to "accept + flag for manual check" if you prefer.
4.
CZ orders: your prices are EUR only. Either add CZK prices or enable currency conversion in the Packeta client section before you open CZ.
How to test
node web/scripts/test-company-ids.mts # validators
./mvnw test -Dtest=PacketaClientTest # client, no real Packeta calls
pnpm --dir web check # 0 errors
Then open the checkout with your real API key, pick a Z-BOX and inspect the returned Point in the console once. Field availability depends on point type.
Connects securely to your tools. The creator never sees your data.
About this skill
Selling to Slovakia or Czechia means Packeta: customers expect to pick a pickup point or Z-BOX on a map, pay cash on delivery and sometimes buy on a company with IČO / DIČ / IČ DPH. This skill makes your agent build a Packeta checkout for Slovak and Czech e-shops that holds up in production. It works on the server side too, so an order turns into a Packeta packet without rejections or lost money.
What your agent does with it
- Reads your project first. It fits into your existing order model, checkout form, pricing and auth instead of replacing them.
- Asks the decisions that change your data model: pickup vs home delivery, SK/CZ currencies, COD, age-restricted goods, B2B purchases.
- Adds the widget (Packeta widget v6, lazy-loaded, typed), with Z-BOX, weight filtering and 18+ capable points only when the cart needs it.
- Validates the chosen point on the server against Packeta's validation endpoint with the same constraints the widget used, and maps every realistic error (
PickupPointIsFull,NoCashOnDelivery,NoAgeVerification, …) to a human message. - Recomputes shipping and COD on the server. It never trusts a client-supplied price, rounds CZK COD to whole crowns and normalises phone numbers to
421…/420…. - Validates company IDs with real checksums (IČO mod-11, SK DIČ, IČ DPH) and can call EU VIES to prefill the company name and address.
- Creates the packet through the REST/XML API with the right field limits, the external-carrier variant and
adultContent. It also covers labels and the errors you'll actually hit. - Finishes with tests and a hand-off: the files it added, the decisions that are still yours (API key, sender, COD limits, age-verification policy) and how to test locally.
What's inside
| Asset | For | Verified with |
|---|---|---|
packeta-widget.ts | Any frontend: typed lazy loader, options, point mapping | TypeScript 6 strict, SvelteKit 3.1 |
PacketaPicker.svelte | Svelte 5 / SvelteKit 3 drop-in picker (bind:value, hidden form inputs) | svelte-check, 0 errors |
company-ids.ts | IČO / DIČ / IČ DPH validation, browser + Node | Bundled test script |
CompanyIds.java | Same rules for the backend | Java 25 |
PacketaClient.java + test | Spring Boot 4: point validation, createPacket, retries, XXE-safe XML parsing | 5 tests green on Boot 4.1.2 / Java 25 |
references/ | Widget v6 options + error codes, Packet API XML, company-ID rules + test numbers |
The widget helper doesn't depend on any framework, and the patterns carry over to React/Next.js, Vue/Nuxt, Laravel or .NET.
Traps it prevents
- API key vs API password. The widget gets the 16-character key. The password never leaves the server.
- Forged pickup points and prices. Anything the widget returns comes from the customer's browser, so the skill validates it on the server.
- Mangled Czech/Slovak names. Many HTTP clients (including Spring's
RestClient) send String bodies as ISO-8859-1, so "Ján Novák" arrives as "J?n Nov?k". The asset's tests caught this. - Packet IDs are 64-bit. They're stored as strings, never as a JS number or 32-bit int.
- 18+ delivery only works on Packeta's own pickup points in CZ/SK/HU/RO, not on home delivery or external carriers. The skill raises this as a legal decision for you and doesn't pick silently.
- External points use
carrierId+carrierPickupPointId, notid. - Retrying
createPacketcan create duplicate packets because the call isn't idempotent. The skill retries point validation but never packet creation.
Requirements
You need your own Packeta account (API key + API password). Packeta has no sandbox; you test with a dedicated sender, and packets cost nothing until they physically enter the network.
Independent skill. Not affiliated with or endorsed by Packeta / Zásilkovna s.r.o.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for E-commerce.
Ready-made assets cover SvelteKit 3 / Svelte 5, plain TypeScript and Spring Boot 4. Other stacks (React/Next.js, Vue, Laravel, .NET) get the same patterns, but your agent translates them. Packeta has no sandbox, so final testing uses your production account with a test sender. 18+ age verification works only on Packeta's own pickup points in CZ/SK/HU/RO. Courier delivery needs a carrier ID per destination country from your Packeta account. Widget geolocation requires HTTPS.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 13 days ago
- Accounts
Europa
Packeta account
- Software
Node.js 24+
- Optional
- Java 25Maven
You need the account's API key and API password. Node.js runs the bundled validator tests. Java and Maven are only for the Spring Boot assets.
Permissions
Allowed Hosts
Shell: runs the bundled tests (node, mvn). Files: reads your checkout/order code and writes the integration. Network: Packeta widget/validation/Packet API and optional EU VIES lookups, only from your own app. Env vars: PACKETA_API_KEY (public) and PACKETA_API_PASSWORD (server-only).