Kurirko
| 开发者 | expresskurirko |
|---|---|
| 更新时间 | 2026年9月17日 03:01 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 |
| 版权网址: | 版权信息 |
详情介绍:
Kurirko is software for online stores — it is not a courier service and does not carry, collect or deliver anything. It connects your WooCommerce store to Pošta Srbije / Post Express using your own contract and credentials. From an order you create a shipment in one click, print the official address label ("adresnica") and the acceptance book ("prijemna knjiga"), and automatically validate the customer's address — without retyping anything into a separate courier portal. The premium build then follows every parcel after handover: tracking, the delivery-status column, automatic completion and the customer e-mails.
The plugin's interface is fully localized to Serbian (Latin and Cyrillic). Na srpskom: Kurirko je WooCommerce dodatak za kurirsku službu Post Express (Pošta Srbije), za slanje pošiljaka, adresnicu i proveru adrese iz porudžbine, a u premium verziji i praćenje dostave; podrška za druge kurirske službe je u pripremi.
Independent plugin. Kurirko is an independent WooCommerce extension. It is NOT a courier, NOT a delivery company and NOT a shipping broker, and it is NOT affiliated with, endorsed by, certified by or a product of any courier company — including any company with a similar name. Kurirko is NOT an official product of JP "Pošta Srbije"; "Pošta Srbije" and "Post Express" are trademarks of their respective owners. Kurirko talks to the courier only through your own business contract and API credentials.
Which couriers are supported?
Today Kurirko ships with Pošta Srbije (Post Express) — fully implemented and tested end-to-end against Pošta's official WSP WebApi, through the standard B2B onboarding flow under the merchant's own contract. Kurirko is not certified, endorsed or approved by Pošta; as part of that onboarding Pošta reviews and approves the address label your store prints. Kurirko is built on a courier-agnostic core and further Serbian couriers are in preparation; each one is announced when it has been proven end-to-end, not when work on it starts. When a new courier is added it plugs into the same order workflow you already use.
Do I need a contract?
Yes. Kurirko uses your contract with Pošta and your access to the WSP WebApi service (credentials are requested from Pošta at b2b@posta.rs). Step 1 of the onboarding guide walks you through it. Until you enter credentials the plugin waits quietly — nothing breaks and no data is sent.
Premium
The free build covers the whole sending flow — creating the shipment, address validation, the label and the acceptance book. The premium build adds the volume tools a busy store needs and everything AFTER the parcel is handed over: auto-send when an order reaches "processing", the "Slanje danas" batch screen that reviews and creates every ready shipment at once (with 4-per-A4 bulk labels or A6 for a thermal printer), several boxes on one order, optional courier services per shipment, parcel tracking with the courier's delivery status in the orders list and automatic completion of delivered orders, the customer e-mails (tracking number, "your parcel is waiting"), "Spasilac paketa" reminders that chase a COD parcel waiting at the post office before it turns into a return, and a COD ledger that tracks what the courier still owes you. Details: https://kurirko.com
Documentation and troubleshooting: https://kurirko.com/pomoc
安装:
- Install the plugin from your WordPress admin (Plugins → Add New → search for "Kurirko") or upload the ZIP.
- Activate it — an active WooCommerce (9.0+) is required.
- Open Kurirko → Settings and enter your WSP credentials — if you do not have them yet, step 1 of the onboarding guide walks you through requesting them — plus your sender details and the bank account used for cash on delivery.
- In WooCommerce → Settings → Shipping, add the "Kurirko (Pošta Srbije)" method to your Serbia zone.
- On the Diagnostics page click Test connection, then create a test shipment on the TEST environment; once Pošta approves it, switch the environment to "Production".
屏幕截图:
常见问题:
Do I need a contract with Pošta?
Yes. Kurirko uses YOUR contract and WSP WebApi credentials. If you do not have them yet, contact Pošta (b2b@posta.rs); until then the plugin runs in a safe waiting mode.
Does Kurirko charge for shipments?
No. Shipments are billed under your own contract with Pošta. Kurirko does not process any shipping payments and is not a payment intermediary.
Does it work with the block-based checkout?
Yes — with both the classic and the Cart/Checkout Blocks checkout, and with HPOS order storage.
Does it support parcel lockers (paketomati)?
Not yet. Pošta's WebApi does carry parcel-locker delivery, but Kurirko does not yet offer your customer a way to choose a locker at checkout, so nothing is sent that way. It is on the list.
In which language is the plugin?
The admin interface is in Serbian and can be switched between Latin and Cyrillic script. This readme is in English per WordPress.org convention.
What is free and what is premium?
The plugin's settings screen shows this same comparison, drawn from the one list the features are registered in — so what you read here is what the build actually ships. Free — the whole sending flow:
- Sending a shipment from an order, in one click — the outcome appears on the screen by itself.
- Checking and correcting the customer's address.
- The cash-on-delivery amount filled in from the order's payment method.
- The courier's own address directory, the parcel contents and the weight.
- Cancelling a shipment (storno).
- The address label (PDF) for a single order.
- The acceptance book, for one order or for several picked in the orders list.
- Diagnostics and the copyable support report.
- The "Slanje danas" batch screen — review every ready order, then send them all at once.
- Auto-send when an order reaches "processing".
- Several boxes on one order, each with its own label and tracking number.
- Optional courier services per shipment (SMS on delivery, return receipt).
- Bulk label printing, four per A4 sheet.
- The A6 label format for thermal printers.
- Parcel tracking — hourly status checks and a manual refresh on the order.
- The courier's delivery status in the orders-list column.
- Automatic completion of an order the courier reports as delivered.
- "Spasilac paketa" reminders for a parcel waiting uncollected at the post office.
- The e-mail that gives the customer the tracking number.
- The "your parcel is waiting" e-mail to the customer.
- The COD ledger — payouts by dispatch day, with CSV export.
- Support response within one business day.
- Further couriers as they arrive (in preparation).
Does the shipping price at checkout come from the courier?
No. The "Kurirko" shipping method is a flat rate you set yourself in WooCommerce → Settings → Shipping (cost, and an optional free-over threshold). The postage the courier actually charges is fetched when the shipment is created and printed in the acceptance book — it is separate from what the customer paid.
The courier does not recognise a customer's address. What now?
Open the order and use the Kurirko box. It offers ranked corrections you apply with one click, and a picker that completes the settlement and the street out of the courier's own directory — an address chosen there travels with the courier's codes instead of free text. The house number stays as the customer entered it. Then send again; the address is re-validated on submission, so a flagged order is never a dead end.
My shipments stay in the queue and never go out.
Kurirko sends in the background, so this is almost always WordPress scheduled tasks (WP-Cron) not running on the site — a low-traffic site is the usual case. Kurirko notices and shows an admin notice with a "process now" button that drains the queue immediately. The permanent fix is a real system cron, which any host can enable. You can check the queue on the Diagnostics page.
What customer data is sent, and where?
The recipient's name, address and phone number go ONLY to Pošta's API, under YOUR own contract — that is what a courier needs to deliver the parcel. Nothing goes anywhere else: the plugin author receives no customer data, no order data and no store data. See the "External services" section below for the full list.
更新日志:
0.3.7
- Fixed: a shop whose registered name runs past 35 characters could not create a shipment at all — the courier's database refuses an over-long name outright, and reported it as a column nobody outside that database has heard of. Names now go out cut to the length it accepts.
- New: a print that answers with nothing can now say where it stopped. With extended logging switched on (Kurirko → Dijagnostika), printing leaves a trail in WooCommerce → Status → Logs — entered, selection, document made and its size, bytes sent — so a blank page stops being a dead end.
- New: upload your courier's own logotype — as a PDF, a PNG or a JPG — and it prints on the adresnica exactly where the courier's own samples print it; the receipt book has a field of its own, because the samples carry a different mark there. Couriers send you these files when they approve your paperwork. Without one, the courier's name is printed in letters, which is equally valid paperwork, and a file that cannot be read costs you nothing but the picture. The file stays yours: no courier logotype ships with the plugin.
- Changed: the adresnica and the receipt book are laid out to match the samples the courier sends merchants for approval. On the adresnica: the logotype replaces the printed service name, the phone numbers and the web address sit centred above the address boxes, the shipment number runs upright to the left of the barcode, the address boxes are rounded and captioned on their own outline instead of wearing black bars, the recipient block is one even block of type, the contact person and the phone number stand in two columns, and there is an empty box at the foot for whatever the counter writes by hand. On the receipt book: the title is centred over the table, the sender block and the timestamps move to where the sample puts them, all thirteen columns are re-measured, the table head loses its grey fill, the totals are one line — pieces and postage — and each signature caption sits above the rule it is signed on.
- Fixed: the receipt book no longer truncates a long address. Rows now take three lines and the type shrinks before anything is cut, so an address that wrapped no longer pushed its PAK out of sight.
- Fixed: the postcode field was narrower than the five digits it holds, so the last one sat out of sight and a correct value looked wrong.
- Fixed: 0.3.4 could not run on PHP 8.1 at all. One line of it was written in a form the oldest supported PHP refuses outright, and a file PHP refuses to read takes the whole site with it — shop and admin both — from the moment the plugin is active. If 0.3.4 reached you, this release is the fix; nothing was wrong with your data or your settings.
- Fixed: an address chosen from the courier's directory now ships. It travelled with the customer's postcode alongside the courier's own codes, which the courier refuses outright — so every order fixed through the picker failed, over and over, with a message the merchant could do nothing about.
- New: settlements sharing a name are told apart in the picker. Serbia has four SUBOTICA and the directory spells them all the same way; each row now says whether the street on the order exists there, so the choice is no longer one in four.
- Fixed: a print that fails now says so. Where a document could not be produced, the screen came back completely blank — no PDF, no reason, nothing in the log — so nobody could tell a broken plugin from a broken host; it now answers with a sentence and a support code, and writes the cause down.
- New: the Premium screen is now in Serbian, with the plan, the price and the full feature list on one page instead of the payment provider's English one; buying is unchanged.
- Fixed: cancelling a shipment now always stops tracking it, so a customer can no longer be reminded to collect a parcel the shop is recalling.
- Fixed: where a courier never confirmed a cancellation, the order now offers a way to record that it was settled by phone — previously only couriers with no cancellation of their own did.
- New: the free build now lets you choose which optional courier services ride on every shipment (SMS on delivery, return receipt) instead of always sending SMS; offering them per shipment stays premium.
- Fixed: with "hand parcels in at a post office" selected, the manifest no longer carries a pickup place — exactly the shape the courier asks for from stores without courier pickup.
- New: choose how parcels reach the courier — a courier collecting at your address, or you handing them in at a post office. Stores whose contract has no courier pickup were refused with "PREUZ" and had no way out; the new setting on the courier tab is that way out.
- Improved: the "what does this mean" link on that refusal now opens a dedicated help entry instead of address advice, since the address is not the problem.
- Improved: the order box and the daily batch screen say "handover day" rather than "pickup day", so the wording holds for both modes.
- Fixed: the courier settings form no longer accepts a value its drop-downs never offered.
- Fixed: a cancelled shipment can be sent again — the new send gets a fresh number and a fresh label instead of waiting in the queue forever.
- Fixed: an order whose background job got stuck no longer hides its actions; it reports the state and offers a way out.
- Fixed: hourly tracking no longer refreshes a shipment you cancelled — a storno stays a storno on the order screen.
- Fixed: the address check no longer blames the wrong field when the courier rejects a recipient detail.
- New: the order now distinguishes "cancelled in the store" from "confirmed by the courier", and asks for your confirmation where the courier offers no cancel API.
- New: auto-send (premium) never re-sends an order after a storno on its own; a second parcel is always a human decision.
- Improved: the licensing screens now speak Serbian.
- New packaging — the free build keeps the whole sending flow (create, validate, print, cancel, diagnostics); everything after the parcel is handed over is now part of the premium tier: parcel tracking, the delivery-status column, automatic order completion, "Spasilac paketa" and the customer e-mails.
- Review before you send — the batch screen now opens a review step first: correct an address, a phone number or the cash-on-delivery amount row by row, watch each shipment's outcome as it lands, and retry only the rows that failed (premium).
- The outcome finds you — the Kurirko box on an order shows how a send ended by itself; no more reloading the page to find out.
- Optional courier services per shipment — SMS on delivery and return receipt, set per courier as always on, offered in the review step, or off; charged on the first box only (premium).
- Several boxes on one order — each box gets its own label and its own tracking number, cash on delivery and declared value ride on the first, and a cancellation cancels the whole order (premium).
- A6 labels for thermal printers — the same address label with a page to itself instead of a quarter of a sheet (premium).
- Book of COD payouts — what the courier owes you, grouped by dispatch day, marked paid a day at a time, with an export to CSV (premium).
- New: a default shipment contents setting, used when an order's own items cannot name themselves.
- New: a free/premium comparison on the settings screen, built from the same list the features are registered in — it can name nothing the build does not ship.
- Improved: every Kurirko order note now opens with one symbol for its kind of event, so a long order history can be scanned instead of read.
- Improved: Kurirko's own buttons wear WordPress' icons instead of typographic stand-ins.
- Improved: the shipment-status feed both screens poll answers for the whole set in one query instead of three per order — a batch of 200 costs 17 queries, not 603.
- Improved: the rescue counter adds up the postage a rescued parcel saved, not the whole cash-on-delivery amount it carried.
- Address picker — when the courier does not recognise an address, pick the settlement and the street from the courier's own directory. The choice travels as the courier's codes, so two places with the same name resolve to the one you actually picked.
- "I already have a tracking number" — record a parcel you handed over at the counter. Tracking starts and the customer is notified; no label is printed, because the courier already has one.
- What this courier supports — each courier's card now lists what it can and cannot do, and says what an absence means for you in plain words.
- Wording — the plugin and the customer's email now say "broj pošiljke" everywhere instead of one courier's own term for it.
- Fix: a cancelled parcel could still chase the customer with a "collect your parcel" reminder, and the reminder guard it left behind silenced the next shipment's reminder.
- Fix: a tracking number typed in by hand kept blocking the address label of a LATER, real shipment on the same order.
- Fix: the shipment email to the customer could name the wrong courier and link the wrong tracking page.
- Fix: a company buying as a company was reduced to its contact person on the label; the company name and tax number now travel where the courier accepts them.
- Fix: sending or refreshing tracking could block the screen for up to twenty seconds when the courier went quiet. Waiting now happens only in background jobs.
- Under the hood: the core no longer knows which courier it is talking to. That is what lets further couriers be added without touching how your orders work.
- Onboarding: five-step guide with collapsible panel, real error messages from the courier, payment-gateway checkboxes, field validation hints.
- Initial release: send a shipment, address label and acceptance book (PDF), tracking, address validation, diagnostics, Latin/Cyrillic interface. Pošta Srbije (Post Express) courier; HPOS and Cart/Checkout Blocks compatible.