Connect your PTT Kargo account. In the Shopify panel, Shipping > Add a carrier (or on the desktop, Settings > Cargo companies). Choose the test server or your live account. "Check" tests the connection.
CARRIER INTEGRATION / BETA / SHOPIFY AND DESKTOP
PTT Kargo Integration: Shipment Data Uploaded, Label Ready
PTT Kargo integration (beta): shipment data is uploaded with your PTT customer number; with a barcode range, the PTT barcode prints on your label.
FREE PLAN · NO CREDIT CARD · WINDOWS / MAC / LINUX / WEB
The PTT Kargo integration connects your own agreement with PTT Kargo to LabelInn. For every paid Shopify order the shipment is created at PTT Kargo automatically, the tracking number and the PTT Kargo barcode print on your shipping label, and the tracking number is written back to the order. You pay PTT Kargo for postage under your agreement, not LabelInn.
Beta. Checked against PTT's test server (a wrong login is refused correctly). Create, track and cancel are not yet proven with a real PTT account. We are proving it with the first stores that connect; if something fails, the order waits unshipped and the reason shows in the panel.
01 / ACCOUNT
What you need from PTT Kargo
A PTT customer number and web service password from your PTT regional directorate (after signing its confidentiality undertaking). Shipments are created under your own agreement and prices.
The connect form asks for:
- PTT customer number: From the PTT regional directorate you have the agreement with.
- PTT web service password
- Tracking password (if different) (optional)
02 / STEPS
What LabelInn does, step by step
Map your shipping methods. "Standard: PTT", "Express: another carrier", "Store pickup: do not ship". Pick a default carrier for every other method.
The order is paid, the shipment is created. LabelInn sends the order's address, phone and parcel details to PTT Kargo; the shipment is created in your own account.
The label prints with the barcode. The tracking number, the PTT Kargo barcode and the carrier name fill in on your shipping label, which prints on the thermal printer you choose or on an A4 sheet.
Tracking goes back to Shopify. Once you approve the new permission, the order is marked fulfilled with the tracking number; until then the number goes into the order note.
03 / DETAILS
Details of the PTT Kargo connection
Carrier servers refuse orders over small rules. These are the ones LabelInn already handles for PTT Kargo:
- The barcode depends on your contract. If your contract has a PTT barcode range, PTT returns its 13-digit barcode and it prints on the label; otherwise PTT labels the parcel at the counter.
- Phone format. PTT wants 10 digits without the leading 0; LabelInn formats the number for you.
- One parcel per shipment. The PTT connection does not create multi-piece shipments.
- No second shipment. PTT requires a unique file name per upload, so resending the same upload cannot create a second shipment.
- Cash on delivery is supported as PTT's extra service.
- Cancel: only data that a PTT counter has not accepted yet can be deleted.
| Feature | PTT Kargo |
|---|---|
| Cash on delivery | yes |
| Cancel | yes |
| Tracking | yes |
| Multi-piece | no |
| Barcode | PTT returns its barcode when your contract has a barcode range; otherwise PTT labels the parcel at the counter. |
| Status | Beta |
04 / LABEL
What is on the label
The label at the top of this page is drawn by the LabelInn Shopify app's 100 × 150 mm shipping template with a sample order: sender, recipient and address, shipping method, items, carrier name, tracking number and the Code 128 barcode the carrier scans. The number in the barcode is a sample; the real one is created once your PTT Kargo account is connected. The customer details are sample data.
You can change the template in the LabelInn designer, add your logo, and print on 4 × 6 in, A6 or an A4 sheet. Tracking number, cargo barcode and carrier are ready-made fields you can bind into your own design.
05 / CHANNELS
Where the PTT Kargo integration works
You set up the PTT Kargo connection once; whichever way an order comes in, it goes to the same account.
- Shopify: in the Shipping tab of the LabelInn Shopify app you map your shipping methods to carriers. Every paid order is shipped automatically and the tracking number goes back to Shopify. Shopify carrier integration →
- Desktop app: in the new version of LabelInn, Settings > Cargo companies connects, tests and sets the default for the same carrier accounts.
- Automations (coming): the same shipment step for every row from Excel, Google Sheets, a database or an API. In the automation editor the "Create a cargo shipment" step is still marked "coming soon".
06 / SECURITY
Your password and your IP address
- Passwords are stored encrypted and never shown again. Not in the panel, not in the app; to change one you enter a new one.
- Requests can leave from your own PC. If PTT Kargo whitelists an IP address for integrations, the carrier requests can be sent by your own computer with LabelInn open (new desktop version, Settings > Cargo). The carrier sees your own IP; no server IP to register.
- One order never ships twice. The key sent to the carrier is fixed per order; if a request is cut off, LabelInn first asks whether the shipment was created.
QUESTIONS / FAQ
Frequently asked questions
What do I need for the PTT Kargo integration?
An integration agreement with PTT Kargo and: PTT customer number, PTT web service password. A PTT customer number and web service password from your PTT regional directorate (after signing its confidentiality undertaking).
Does the PTT Kargo barcode label print automatically?
Yes. Once the shipment exists, the tracking number, the PTT Kargo barcode and the carrier name fill in on the label and it prints on the printer you choose. PTT returns its barcode when your contract has a barcode range; otherwise PTT labels the parcel at the counter.
How do I set up a Shopify PTT Kargo integration?
Install LabelInn from the Shopify App Store, add your PTT Kargo account in the Shipping tab, map your shipping methods and turn on "Create the shipment automatically for every paid order".
Is the PTT Kargo integration ready?
It is in beta. Checked against PTT's test server (a wrong login is refused correctly). Create, track and cancel are not yet proven with a real PTT account. You can connect it; if something fails, the order waits unshipped and the reason shows in the panel.
Who pays for postage?
You do, under your own PTT Kargo agreement. LabelInn creates the shipment in your account; it does not resell postage.
Can an order be shipped twice by mistake?
No. The key sent to the carrier is fixed per order. If a request is cut off, LabelInn first asks whether the shipment was created, and "Try again" reuses the same key.
Can I cancel a shipment?
Yes, you can cancel the shipment from LabelInn before PTT Kargo picks the parcel up.
KEEP GOING
Related
NEXT STEP / LABELINN
Create PTT Kargo shipments from your orders
Connect your own PTT Kargo agreement; paid orders are shipped and the label prints with the barcode. · Your own carrier agreement · Barcode on the label · Tracking back to Shopify