Skip to content

Deliverect — Adapter Guide

Provider Info

Field Value
Slug deliverect
Auth Type api_key
Base URL https://api.deliverect.com (global)
API Docs https://developer.deliverect.com

Authentication

Authorization: Bearer {apiKey}

Input fields used

input.baseUrl    // "https://api.deliverect.com" (or custom)
input.apiKey     // Bearer token
input.config     // { channelLinkId: "...", accountId: "..." }

Key Concepts

  • Channel: Cata is a "channel" in Deliverect (like UberEats, GrabFood)
  • channelLinkId: The link between Deliverect and Cata — same across all outlets for a tenant
  • locationId: Deliverect's internal location ID (maps to one Cata outlet)

API Endpoints

Endpoint Method Use For
/v1/locations GET test_connection, list_remote_outlets
/v1/products GET sync_products
/v1/orders POST order_dispatch

Quirks & Constraints

  • Prices in cents (integer) — divide by 100 for Cata
  • Products have a complex nested structure (categories → subcategories → products → modifiers)
  • Deliverect pushes data TO Cata via webhooks (inbound model) — pull is secondary
  • channelLinkId is stored in outlet_providers.settings
  • Lightspeed pricing limitation: When Deliverect integrates with Lightspeed, pricing cannot be customized from Deliverect — must be changed in Lightspeed directly
  • Fee handling: Deliverect has its own separate fee structure in the order payload — different from Revel and Lightspeed
  • Bundle items: Items that exist only inside a bundle should NOT be required as standalone products in a menu section

Topic: test_connection

TODO — Verify Deliverect API key by calling GET /v1/account.

Topic: list_remote_outlets

TODO — Fetch GET /v1/locations and return location list.

Topic: sync_outlet

TODO — Transform Deliverect location → Cata outlet format.

Topic: sync_products

TODO — Transform Deliverect product catalog → Cata flat products.

Topic: order_dispatch

TODO — Transform Cata order → Deliverect order creation format.

Topic: order_status_update

TODO — Transform Deliverect order status webhook → Cata status.

Status Mapping (planned)

Deliverect Status Cata Status
1 (received) PENDING
2 (accepted) ACCEPTED
3 (preparing) PREPARING
4 (ready) READY
5 (completed) COMPLETED
-1 (cancelled) CANCELLED