|

Openship order routing

Shop, channel, product-match, order, and fulfillment coordination from source you control.

Source · Getting started

Openship connects the places where orders originate with the places that fulfill them. A shop is an order source. A channel is a fulfillment destination. Links connect shops to channels, and matches map a shop item to a channel item before an order is placed downstream.

The repository contains shop-to-channel routing and Shopify/Openfront adapters. A configured shop/channel, provider name, model, or synthetic endpoint response does not prove an external purchase, webhook, retry, cancellation, or tracking flow. Current credential fields, configurable execution destinations, and non-durable callback paths require hardening before production credentials or orders.

Architecture and data

Openship uses the same Next.js, Keystone, GraphQL, Prisma and PostgreSQL application base as Openfront. Its active graph is smaller and routing-specific: users/roles/API keys, shop and channel platforms, shops and channels, orders/line/cart items, shop/channel items, matches, links and tracking details. Ownership is directly User-scoped; there is no organization or workspace tenant graph.

Provider-specific behavior belongs behind shop and channel platform handlers. Openship stores its routing and match state; connected commerce or fulfillment platforms remain authoritative for their own products, orders and tracking records.

Main workflow

  1. Configure a shop platform and shop with scoped credentials.
  2. Configure a channel platform and fulfillment channel.
  3. Link the shop to the channel.
  4. Search both product catalogs and create a match.
  5. Import or select a shop order.
  6. Convert matched lines into channel purchases.
  7. record tracking, cancellation, fulfillment or error state from the channel boundary.

Idempotency, signature verification, credential isolation, retries and reconciliation need to be proved for each adapter.

Openfront relationship

Openfront products can be shop sources for Openship, but Openship is not the Openfront storefront or payment system. It coordinates order routing across independently operated systems.

On this page