Geliver

Create a shipment and request carrier offers (POST /shipments). Provide a sender address id plus either a saved recipient address id or an inline recipient address, and parcel dimensions/weight. Geliver returns the shipment with its computed offers (offers[].list). Buying a label is a separate step (Accept Offer). Numeric size/weight fields are sent as strings.

Get a shipment by id (GET /shipments/{shipmentID}). Returns the full shipment including its offers (offers.list), accepted offer, tracking number, label URLs, and current tracking status.

List shipments (GET /shipments). Page-based pagination via page + limit; the response envelope carries page/limit/totalRows/totalPages. Used for polling new/updated shipments.

Update a shipment's parcel dimensions/weight before a label is bought (PATCH /shipments/{shipmentID}). Numeric fields are sent as strings.

Cancel a shipment (DELETE /shipments/{shipmentID}).

Create a return shipment from an existing shipment (POST /shipments/{shipmentID}) with isReturn=true. Set willAccept=true to also purchase the return label immediately; otherwise offers are returned to accept later.

Get the carrier offers/rates computed for a shipment (GET /shipments/{shipmentID}). Offers live inside the shipment at offers.list, with offers.cheapest and offers.fastest highlighted; each offer has an id used to accept it. (Same endpoint as Get Shipment, framed as the rates step of the flow.)

List saved sender and recipient addresses (GET /addresses).

Get a saved address by id (GET /addresses/{addressID}).

Create a saved sender or recipient address (POST /addresses). Set isRecipientAddress to false for a sender address (zip required) or true for a recipient address (phone required).

Delete a saved address by id (DELETE /addresses/{addressID}).

List saved parcel (box) templates (GET /parceltemplates).

Create a reusable parcel (box) template (POST /parceltemplates) with fixed dimensions/weight.

Delete a parcel template by id (DELETE /parceltemplates/{templateID}).

List the carrier (provider) accounts connected to your Geliver organization (GET /provideraccounts). Safe identity / connectivity probe — verifies the token works.

Connect a carrier (provider) account to your Geliver organization (POST /provideraccounts). Body carries the carrier's providerCode and its credentials.

Disconnect a carrier account (DELETE /provideraccounts/{providerAccountID}).

Accept a shipping offer and purchase the label in one call (POST /transactions with offerID). Returns a Transaction whose shipment carries the tracking number and label URLs once the carrier responds.

One-step purchase: post shipment details directly to POST /transactions wrapped as { shipment: {...}, providerAccountID?, providerServiceCode? } to create the shipment and buy the label together. Returns a Transaction.

List label-purchase transactions (GET /transactions). Page-based pagination (page + limit). Useful for polling newly purchased labels.

List registered webhook subscriptions (GET /webhook). Geliver pushes tracking-update events to these URLs.

Register a webhook subscription (POST /webhook) so Geliver pushes tracking updates to your URL. Note: within Zervanor this connector's supported trigger is polling — see webhooks docs.

Delete a webhook subscription by id (DELETE /webhook/{webhookID}).

List cities for a country (GET /cities?countryCode=...). Used to fill cityCode when creating addresses.

List districts for a city (GET /districts?countryCode=...&cityCode=...). Used to fill districtID/districtName when creating addresses.

Get the account (organization) wallet balance (GET /organizations/{organizationID}/balance).

List the price list for the given query (GET /priceList). Query parameters describe the parcel/route to price.