Skip to main content
Go to nevuto.com

Connect Geliver to Nevuto

Published May 20, 202610 min readUpdated 1 week ago

What is Geliver?

Geliver is a Turkish multi-carrier shipping aggregator focused on fast, trackable delivery for online stores. Through a single API you can ship via Aras Kargo, Yurtiçi Kargo, MNG, PTT, Sürat Kargo, HepsiJet, Kolay Gelsin and Paket Taksi. For Nevuto merchants selling in Türkiye, Geliver is one of the quickest ways to add reliable domestic shipping without negotiating with every courier individually.

How Nevuto handles Geliver

  • Nevuto connects to Geliver through its official shipping API using an API token you generate from your Geliver merchant panel.
  • When fulfilling an order, Geliver picks the cheapest offer from your selected carriers.
  • For each Nevuto order, a Geliver shipping label is generated with one click from the order screen — the label is print-ready as a PDF.
  • Tracking numbers are written back to the order automatically and the customer receives the tracking link in the shipment-confirmation email.
  • Shipping status updates (in transit / delivered) flow in automatically via Geliver's webhook — no manual intervention required.

1. Prerequisites

  • An active Geliver account. Sign up at geliver.io if you don't have one.
  • At least one sender address registered in your Geliver account. Add it from the Addresses section of the Geliver panel.
  • At least one carrier contract active in your Geliver account. Pick the carriers you want to use from the Geliver Marketplace.
  • Your store currency must be TRY. Geliver returns TRY-based prices; you cannot import rates from a store using another currency (the system will block it).

2. Geliver API token

  1. Sign in to the Geliver panel.
  2. Go to Account → API & Integrations.
  3. Generate a new API token (or use an existing one if you already have one).
  4. Copy the token — you'll paste it into Nevuto in the next step.

⚠️ Keep the token confidential. If you suspect it's been leaked, revoke it from the Geliver panel and generate a new one.

3. Connect Geliver in Nevuto

  1. In your Nevuto admin panel, go to Settings → Shipping → Shipping providers.
  2. Select Geliver from the list.
  3. Paste the token you copied from Geliver into the API key field.
  4. Turn on the Enable shipping method toggle.
  5. (Optional) Turn on Test mode to send test shipments to Geliver without buying real labels. Recommended before going live.
  6. Click Submit.

Once the API key is saved, a Settings card appears below where you configure Geliver-specific options.

4. Sender address

  • Auto-resolve (default): uses the "default sender" address from your Geliver account automatically.
  • Pick a specific address: select one of your registered Geliver addresses from the dropdown.

If your Geliver account has multiple sender addresses (e.g. main warehouse + second branch) and you want to ship from a specific one, set it here.

5. Preferred carriers

This step controls which carriers Geliver chooses between when fulfilling.

  1. Pick one or more carriers from the dropdown (Aras, Yurtiçi, MNG, PTT, Sürat, HepsiJet, Kolay Gelsin, Paket Taksi).
  2. Submit.

Behaviour:

  • When fulfilling, Geliver picks the cheapest offer from your selected carriers.
  • If you don't pick any, Geliver uses its own default "cheapest" recommendation.
  • If none of the selected carriers serve that route, it falls back to cheapest automatically (your order won't be blocked).

💡 Tip: Only pick carriers you have a contract with and that are active in your Geliver account. Carriers that aren't active in your account won't appear in the price reference table.

6. Carrier price reference

After you save preferred carriers, a price reference table opens below.

What it shows:

  • Geliver's published desi-based prices for your selected carriers.
  • For fixed desi values (1, 2, 3, 5, 10, 15, 20, 30), each carrier's TRY price including VAT.
  • "—" means that carrier doesn't return a price for that desi (usually because it's not active in your account or doesn't accept that weight).

How to use it:

  1. Review the table — which carrier is cheapest at which desi tier?
  2. Use these prices as a reference when building your own shipping rates. Add a markup to set the price your customers will pay.
  3. Tick the checkbox at the end of each row → on submit, shipping rate rules are auto-created:
    • min_desi → max_desi: tiered rates from the desi values you ticked (e.g. ticking 1, 5, 10 creates 0–1, 1–5, 5–10 desi tiers).
    • Price: the highest price among the selected carriers for that row (worst-case so you don't take a loss).
    • Name: the carrier with the max price + desi tier (e.g. "Aras Kargo — up to 5 desi").
    • Rules are added to the first zone of your store's default shipping profile.
  4. You can later edit these rules manually in Settings → Shipping → Rates (e.g. to add markup).

⚠️ This feature only works if your store currency is TRY. Stores in USD/EUR etc. see a warning and the checkboxes are disabled.

7. Shipping packages

To ship through Geliver, parcel dimensions (length × width × height + weight) are required. They're resolved in this priority order:

  1. Variant LWH — entered directly on the product variant.
  2. ShippingPackage reference — if the variant is linked to a package template, its dimensions.
  3. Store default package — the package marked "Default" in Settings → Shipping → Packages.
  4. Last resort: 20×20×20 cm fallback.

Steps:

  1. Go to Settings → Shipping → Packages.
  2. Add package → name, type (Box/Envelope/Soft pack), L/W/H/unit, weight.
  3. A "Standard package" was auto-created when your shop was set up; you just need to update its dimensions.
  4. Set as default → mark one package as the store-wide fallback.

💡 If you sell a wide range of products: define a few different package templates (Small box, Medium box, Large box) and assign them to your variants.

8. Variant LWH

For the most accurate price, we recommend entering real dimensions on every variant:

  1. Products → edit product → Variants tab.
  2. Fill in Length / Width / Height / Weight on each row.
  3. Pick cm or in as the unit.

If no variant dimensions are set, it falls back to ShippingPackage, then the store default, then 20×20×20 cm.

9. Fulfilment flow

Once a customer pays, the order shows up in your admin with a "Mark as shipped" button, ready to ship.

  1. Open the order detail page.
  2. Click the Mark as shipped button.
  3. In the modal that opens, pick Geliver as the provider and click Submit.
    • For the rare case where you need to ship outside Geliver, you can pick Manual and enter the tracking number by hand — that option doesn't create a Geliver shipment.
  4. Within a few seconds, the order row shows the tracking number, tracking link, and a "Print label" button. The label fee is deducted from your Geliver balance at the same time.
  5. Click Print label to open the waybill PDF, print it, and stick it on the parcel.
  6. Hand the parcel to the carrier you picked — everything else is tracked automatically. You'll see a "Shipping status is updated automatically by the carrier" notice on the order detail page.

💡 Your customer can track the shipment via the tracking link from their own order page, and they'll get an email notification each time the status changes.

10. Status lifecycle

After an order is shipped, status updates arrive automatically:

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Label printed, courier hasn't picked up yet
    │
    ▼   Courier scans the parcel
[shipping_status: SHIPPED]         ← Webhook fires, "Shipped" email to customer
    │
    ▼   Delivered to customer
[shipping_status: DELIVERED]       ← Webhook, "Delivered" email to customer

How it works:

  1. When you save the Geliver integration, Nevuto automatically registers a webhook on your Geliver account.
  2. When the carrier scans the parcel, Geliver notifies Nevuto.
  3. Nevuto receives it, finds the order by tracking number, and updates the status.
  4. SHIPPED → OrderShippedEvent → inventory decremented, customer email sent.
  5. DELIVERED → OrderDeliveredEvent → delivery email sent to customer.

No manual intervention required. Don't change the order status yourself — the webhook will overwrite it.

11. SMS notifications

  • Nevuto sends notifications by email (Order shipped / Order delivered).
  • Nevuto does not send SMS.
  • Geliver or the underlying carrier sends SMS to the customer (standard behaviour in TR — couriers automatically text the recipient's phone).
  • Check the Geliver panel for SMS notification settings if available.

12. Test mode

Always test before going live:

  1. In Geliver settings, turn on Test mode and save.
  2. Place a real order on the storefront (in TRY, a small amount — a 1 ₺ product).
  3. Complete the payment (Stripe test card or another test gateway).
  4. In admin: Mark as shipped → pick Geliver → Submit.
  5. Result:
    • It appears as a test shipment in your Geliver panel.
    • No real label is purchased.
    • A tracking number is returned, but there's no real courier.
  6. Once you've verified the flow, turn Test mode off and go live.

13. Common issues

"Geliver API key missing" error You saved an empty API key. Re-enter the token under Settings → Shipping → Geliver → API key.

"City not found / district not found" Geliver error The customer's address province/district doesn't match Geliver's expected format. Nevuto maps automatically (province_code → il, city → ilçe), but some edge cases fail. Verify the customer's address — especially "ilçe" should be clear (use the full name, not an abbreviation).

Price reference table comes back empty

  • No checkboxes selected: add at least one carrier to preferred carriers and save.
  • "—" everywhere: the carriers you picked aren't active in your Geliver account. Check the contract/activation status in the Geliver panel.
  • Currency warning: your store isn't in TRY. Prices are still shown but checkboxes are disabled — you can't import.

Orders go to Geliver automatically (without clicking Mark as shipped) This was fixed on 2026-05-20. If it still happens, the PHP queue worker may not have been restarted. Restart the workers.

Tracking URL not arriving / shows "—" Geliver's trackingUrl field can be empty until the courier picks up the parcel. As a fallback, Nevuto uses https://app.geliver.io/tracking/{shipmentId} — this link routes to the Geliver panel.

Webhook not arriving / status not updating

  • Check that the webhook is registered in your Geliver account (Geliver panel → API → Webhooks).
  • In Nevuto admin, go to Geliver settings and click Submit again — the webhook will be re-registered automatically.

14. Next steps

  • Monitor production orders the first week — cross-check consistency between the Geliver panel and Nevuto.
  • Add markup to your shipping rates — rates imported from the reference table are cost prices; update them to the amount you want to charge customers.
  • During peak/holiday seasons keep the Geliver panel open — track delays/returns from there as well.

Need help?

For issues with the Geliver API or the Nevuto integration:

Related articles