qapla-api
NewIntegrate with or answer questions about the Qapla' shipping & tracking REST API (public v1.3). Use this when working with Qapla' to push shipments or raw orders, generate and confirm carrier labels, track parcels, get real-time multi-carrier quotes, look up pickup points (PUDO), verify addresses, list couriers and channels, or receive outbound tracking-event webhooks. Covers authentication (per-channel API Key), the response envelope, rate limiting, the sandbox flag, and the full endpoint catalog with request/response examples. Also covers the newer **v2** generation (Bearer/JWT auth, RESTful resources, async jobs) for its stable core — parcels, sandbox, auth, jobs.
Summary
3, covering authentication, rate limiting, and all endpoints for pushing shipments, generating labels, tracking parcels, getting quotes, and more.
- It provides reference documentation, example payloads, and a client script to accelerate development.
Overview
Qapla' Public API (v1.3)
This skill teaches you to integrate with the public REST API of Qapla', a SaaS platform for e-commerce logistics (multi-carrier shipping, real-time tracking, label printing, transactional notifications).
How to use this skill
- Read `references/overview.md` first — it is the canonical orientation:
core facts (base URL, auth, response envelope, rate limit, sandbox, versions), the domain model, and the "which endpoint do I need?" decision rule.
- Then read
references/conventions.mdandreferences/authentication.md—
they apply to every call.
- Pick the endpoint from
references/endpoints.md(full catalog) or the
per-endpoint deep-dives (references/pushshipment.md, pushorder.md, createlabel.md, getquotes.md, getpudos.md, trackingbytimeframe.md — the pull alternative to webhooks — and apivirtual.md — the virtual courier). To receive event callbacks instead of calling an endpoint, see references/webhooks.md (Pillar 2). To interpret tracking statuses, see references/statuses.md (branch on the canonical id, never the label). For the version policy (which version to call, v1.2-only endpoints, the separate v2 generation), see references/versioning.md; to upgrade a legacy integration, see references/migration.md.
- Use the runnable example payloads in
references/examples/as a starting
point, and the dependency-free reference client in scripts/qapla_client.py when writing code.
- For the v2 API (a separate, RESTful generation with Bearer/JWT auth — the
direction the platform is heading), start at references/v2/overview.md, then references/v2/authentication.md and the resource deep-dives (references/v2/parcels.md, references/v2/sandbox.md, references/v2/endpoints.md). Most integrations still target v1.3 today; use v2 when you need a resource it exposes (e.g. parcels) or its model.
The same knowledge powers the cross-agent entrypoints in this repo
(
AGENTS.md,.cursor/rules/qapla-api.mdc); all of them point back to
references/overview.mdso there is a single source of truth.
Source of truth: the live docs at <https://api.qapla.dev/1.3/>. This skill
mirrors them so you can work offline; if anything drifts, trust the live docs.
Install & Usage
mkdir -p .claude/skillsAdd the configuration to .claude/skills/qapla-api.md
/qapla-apiUse Cases
Usage Examples
/qapla-api How do I push a shipment and get a label?
/qapla-api Get quotes for a 2kg parcel from Paris to Lyon.
/qapla-api Track package with tracking number '1Z999AA10123456784'.
Security Audits
Frequently Asked Questions
What is qapla-api?
This skill enables you to integrate with the Qapla' shipping and tracking REST API v1.3, covering authentication, rate limiting, and all endpoints for pushing shipments, generating labels, tracking parcels, getting quotes, and more. It provides reference documentation, example payloads, and a client script to accelerate development.
How to install qapla-api?
To install qapla-api: create the skills directory (mkdir -p .claude/skills), then add the config to .claude/skills/qapla-api.md. Finally, /qapla-api in Claude Code.
What is qapla-api best for?
qapla-api is a other categorized under General. It is designed for: api. Created by Qapla.
What can I use qapla-api for?
qapla-api is useful for: Push a shipment to Qapla' and generate a carrier label for an order.; Retrieve real-time multi-carrier shipping quotes for a parcel with dimensions and weight.; Track a parcel by its tracking number and get the latest status.; Look up nearby pickup points (PUDO) for a given address.; Verify and correct a shipping address before creating a label.; Receive outbound tracking-event webhooks by configuring a callback URL..