AstroBaaS

Orders & fulfilment

Speedex Connector

Paid pluginsize Splanned, not built

Indicative price, not an offer: €14/mo; credential: Speedex API management

Generated from docs/plan/paid/speedex-connector/PLAN.md in the AstroBaaS repository. Nothing described below is implemented — it is the written plan for it.

A paid carrier plugin providing real-time Speedex shipping rates and labeling for Greece and Balkans, integrated into the carrier-integrations module.

The problem

Speedex is a primary carrier in Greece and Balkans; merchants need rates for regional coverage.

What it does

  • Register Speedex API credentials
  • Query rates for Speedex destinations
  • Generate shipping labels
  • Track shipments via Speedex API
  • Cache rates for 24h
  • Error handling: fallback to shipping-rules-engine
  • Audit all transactions

What it deliberately does NOT do

Each boundary carries its reason. A boundary without a reason gets crossed by the next person who reads this.

  • Speedex pickup scheduling — not included. Reason: requires carrier SLA.
  • Customs forms — not included. Reason: separate compliance feature.

Data model

Handled by carrier-integrations module; Speedex plugin adds CarrierAccount entry with carrierId=‘speedex’.

API

  • POST /api/carriers/speedex/accounts
  • POST /api/carriers/speedex/quote
  • POST /api/carriers/speedex/label

Every route added here must also appear in src/pages/openapi.json.ts — a test fails the build if it does not.

Admin

Via carrier-integrations admin UI; Speedex-specific account details.

The seam — why this is paid

Core owns: shipping interface. Paid owns: Speedex API, credential management.

Credential: Speedex API integration, Greek-specific logistics support

Dependencies

  • carrier-integrations (parent module)

Acceptance checks

Each of these must be able to fail. Before claiming this is done, break the code deliberately and watch each one go red.

  • Rate query for Greece/Balkans destination
  • Label generation works
  • Tracking supported

Risks

API stability; rate staleness; mitigation: same as other carriers.

Commercial context

Suggested price€14/mo; credential: Speedex API management
Rival anchorCustom development: €300-600; no Shopify app

The anchor is what the nearest equivalent charges on Shopify or Magento today. It is context for a pricing decision, not the decision.

Generated from the commerce plan. See docs/COMMERCE-PLAN.md for the full catalogue and ../../AI-GUIDE.md for how to work on this repository.