Connecting to Profrakt

Connecting to Profrakt

Profrakt is a Norwegian carrier aggregator. One Profrakt agreement gives you Bring, PostNord, Helthjem, UPS, Porterbuddy and Instabox behind a single connection. Packiyo pulls in your agreements, turns each product into a shipping method, and books labels for you.

Before you connect, a few things are worth knowing up front:

🚨 Heads up
  • Labels can’t be voided. Profrakt has no way to cancel a consignment, so everything you book is permanent.
  • Returns aren’t supported yet.
  • International shipping is limited right now (details below).

What you’ll need

  • Your Profrakt API Key
  • Your Managership ID (this is your sender address in Profrakt)

Not sure which Managership ID to use? Your Profrakt account lists the sender addresses available on your key.


Connecting Profrakt

  1. Go to Shipping Carriers.
  2. Click Add Carrier.
  3. Select Profrakt.
  4. Enter your API Key and Managership ID.
  5. Tick Sandbox environment only if you’re using a stage (test) key.
  6. Save.

⚠️ These three fields are locked after setup.
Your agreements are tied to your key, sender and environment. Change any of them and every shipping method already saved in Packiyo stops working. If you need a different sender, create a
new connection instead of editing the old one.

💡 Test on stage first. Since you can’t void anything on production, run your test shipments on a stage key.


What Profrakt supports

FeatureSupported?
Dynamic servicesâś…
Label generationâś…
Tracking numbersâś…
Tracking URLs✅ (not for Profrakt’s own utility products)
Multi-parcel shipmentsâś…
Rate shoppingâś…
Pickup pointsâś…
International shipping⚠️ UPS only, currently blocked (see below)
Voiding labels❌
Returns (entity or label)❌

Shipping methods

Packiyo pulls your agreements straight from Profrakt. Each agreement has one carrier and a list of products. Each product becomes one shipping method in Packiyo, and the agreement’s carrier becomes the shipping carrier.

A typical key returns around 28 products across Bring, PostNord and Profrakt’s own utility carrier.

Your agreement list refreshes every hour. If you’ve just added a product in Profrakt, give it up to an hour to show up.

📝 You’ll see Profrakt’s return products (like bring2_return_pickup_point) listed as normal shipping methods. They aren’t wired to Packiyo returns, so don’t use them for that.


Labels and tracking

When you ship, Packiyo books a consignment with Profrakt and brings back the label, tracking number and tracking link.

  • Labels always come back as PDF.
  • Every package gets its own tracking number.
  • Profrakt’s own utility products don’t return a tracking link, so that field will be blank.
  • Profrakt doesn’t send back a shipping cost at booking, so no cost is stored on the shipment.
  • Label downloads can take a few seconds. Bring is usually about 1.5 seconds, PostNord 6–9 seconds, and it’s per consignment. Totally normal.

Multi-parcel shipments

You can send several packages in one shipment. How they’re booked depends on the product’s package limit:

Product limitWhat happens
No limit or a high cap (e.g. 99)One consignment holds all your packages
Cap of 67 packages become 2 consignments (6 + 1)
Cap of 1Every parcel is its own consignment (mailbox parcels, lockers)

When a shipment splits, each consignment gets its own tracking number and label.

🚨 If a split shipment fails partway, the bookings that already went through can’t be cancelled. Say you’re shipping 4 consignments and the third fails: the first two exist at Profrakt for good. We log their IDs so you can sort them out with Profrakt directly.


Pickup points

Pickup points work for products that accept them. Packiyo searches near the delivery address and sorts the results by distance, closest first. If nothing is chosen, it falls back to the first one.

Only a few products accept a pickup point. On a typical key that’s:

  • bring2_parcel_pickup_point (optional)
  • postnord_19_box (optional)
  • postnord_19_collect (required)

Two guardrails keep your bookings from failing:

  • If a product doesn’t accept a pickup point, we won’t send one, even if the order had one selected before you switched methods.
  • Pickup points belong to a single carrier. If an order has a Bring locker but you ship with PostNord, the pickup point gets dropped rather than booked.

Rate shopping

Packiyo can quote every Profrakt method in one go.

  • Rates are the net cost including surcharges, excluding VAT.
  • Currency is NOK.
  • Delivery estimates are in working days.
  • A method only shows up if Profrakt can price every consignment the shipment would need.
  • Per-package rates only appear when a shipment splits into multiple consignments. A single consignment has one price for the whole thing.

International shipping

  • Only UPS agreements can ship across borders. Bring and PostNord are Norway-only, confirmed by Profrakt.
  • Some PostNord products don’t carry a “domestic only” rule, but they still can’t ship abroad. Don’t read a missing rule as permission.
  • “Domestic” is based on your sender. You’ll need a Norwegian managership, or domestic-only products will reject the booking.
  • Cross-border bookings are currently blocked for all carriers. Profrakt requires two customs fields (export reason and Incoterms) that their API rejects even when filled in. We have this open with Profrakt and will update this article when it’s resolved.
  • Profrakt doesn’t take customs line items, so HS tariff numbers and origin country per item aren’t forwarded.

If you ship internationally and don’t have a UPS agreement, Profrakt isn’t the right connection for those orders yet.


Voiding and returns

Voiding: Profrakt has no cancel endpoint. If you void a shipment in Packiyo, we’ll show an error instead of pretending it worked. Faking it would mark the shipment void while the label and tracking number are still live at Profrakt, and the parcel could still ship. If you need to pull a Profrakt parcel, do it physically, off the pallet.

Returns: Not supported yet. Profrakt’s return products exist, but Packiyo’s returns aren’t connected to them.


Troubleshooting


What you see
What’s going onWhat to do
Shipping method suddenly stopped workingThe key, sender or environment was changedCreate a new connection with the right details
New Profrakt product isn’t showingAgreements refresh hourlyWait up to an hour
“No service point found”Pickup point doesn’t belong to the carrier you’re shipping withPick a point from the right carrier or remove it
Domestic-only rejection on a Norway shipmentYour sender isn’t a Norwegian managershipUse a Norwegian managership
International booking failsKnown issue with required customs fieldsReach out to us for the latest status
Void failsProfrakt can’t cancel consignmentsPull the parcel physically

Still stuck?

Email support@packiyo.com with the order number and we’ll dig in. We’re happy to help.