Tier OneERP
Integration Guide

Integrate your platform
with Tier One ERP.

Automatically sync transactions, products, customers, and inventory between your platform and Tier One ERP. Push sales into your general ledger, keep stock levels in sync, and let your back office run itself.

01Setup

Three steps to go live.

No complex middleware. No XML mapping files. Connect your platform to your Tier One ERP tenant in minutes using standard REST APIs and API keys.

1
Register for a Tier One ERP account
Head to /register and create your workspace. The free trial includes full API access with no credit card required.
2
Generate an API key
From your dashboard, navigate to Settings → API Keys. Click "Create Key", give it a name like "Production Integration", and copy the key. It is only shown once.
3
Configure your platform
In your integration settings, set the destination URL to your Tier One API base URL and paste the API key. Map your data fields and enable the sync.
02Data Flow

Every transaction, every endpoint.

Your events map directly to Tier One API endpoints. Sales become POS transactions, catalog updates become product syncs, and inventory adjustments flow both ways.

Platform sale
→
POST /api/v1/sales/pos
POS transaction
Product catalog sync
→
GET/POST /api/v1/products
Product CRUD
Customer sync
→
GET/POST /api/v1/customers
Customer CRUD
Inventory updates
→
GET /api/v1/stock
Stock levels
Stock adjustments
→
POST /api/v1/stock/adjust
Adjust quantities
Order creation
→
POST /api/v1/sales/orders
Sales orders
03Reference

Code examples you can copy.

Every request uses your API key in the X-API-Key header. All endpoints are versioned under /api/v1.

Authenticate with API Key
curl
curl -X GET https://www.tieroneerp.com/api/v1/customers \
  -H "X-API-Key: sk_live_a1b2c3d4e5f6" \
  -H "X-Tenant-ID: your-tenant-id" \
  -H "Content-Type: application/json"

# 200 OK
{
  "data": [
    {
      "id": "c7f3a2b1-...",
      "name": "Acme Corp",
      "email": "orders@acme.com",
      "status": "active"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalCount": 142
  }
}
Send a POS Transaction
curl
curl -X POST https://www.tieroneerp.com/api/v1/sales/pos \
  -H "X-API-Key: sk_live_a1b2c3d4e5f6" \
  -H "X-Tenant-ID: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "c7f3a2b1-...",
    "items": [
      {
        "productId": "p1a2b3c4-...",
        "quantity": 2,
        "unitPrice": 29.99
      }
    ],
    "paymentMethod": "card",
    "reference": "ECE-TXN-00412"
  }'

# 201 Created
{
  "id": "txn_x9y8z7...",
  "total": 59.98,
  "status": "completed"
}
Sync a Product
javascript
const response = await fetch(
  'https://www.tieroneerp.com/api/v1/products',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'sk_live_a1b2c3d4e5f6',
      'X-Tenant-ID': 'your-tenant-id',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      sku: 'ECE-WIDGET-001',
      name: 'Premium Widget',
      description: 'High-quality widget',
      unitPrice: 29.99,
      category: 'Widgets',
      trackInventory: true,
      reorderPoint: 25,
    }),
  }
);

const product = await response.json();
console.log('Created product:', product.id);
Subscribe to Webhooks
curl
curl -X POST https://www.tieroneerp.com/api/v1/webhooks \
  -H "X-API-Key: sk_live_a1b2c3d4e5f6" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/hooks/tierone",
    "events": [
      "inventory.low_stock",
      "order.created"
    ],
    "secret": "whsec_your_signing_secret"
  }'

# Tier One will POST to your URL:
{
  "id": "evt_a1b2c3d4",
  "type": "inventory.low_stock",
  "timestamp": "2026-08-01T14:30:00Z",
  "data": {
    "productId": "p1a2b3c4-...",
    "sku": "ECE-WIDGET-001",
    "currentStock": 3,
    "reorderPoint": 25
  }
}
04Webhooks

Events pushed to you.

Subscribe to any combination of events. Tier One signs every payload with HMAC-SHA256 so you can verify authenticity. Failed deliveries are retried with exponential backoff across three attempts over one hour.

inventory.stock_updatedStock level changed for a product in any warehouse
inventory.low_stockStock fell below the configured reorder point
order.createdA new sales order was placed
order.updatedOrder status or line items were modified
product.createdA new product was added to the catalog
product.updatedProduct details, price, or category changed
payment.receivedA payment was successfully processed and recorded
05AI Setup

Let AI build your integration.

Point your favourite AI coding assistant at our OpenAPI spec and let it scaffold the integration for you. Claude, ChatGPT, and Copilot all work.

OpenAPI Spec
https://www.tieroneerp.com/swagger/v1/swagger.json

The full machine-readable API specification. Feed it directly to any AI tool.

MCP Server for Claude

If you use Claude with MCP (Model Context Protocol), you can connect the Tier One ERP MCP server to give Claude direct access to the API schema, endpoints, and sample payloads during your conversation.

Example AI Prompt
"I need to integrate my e-commerce platform with
Tier One ERP. Here is the OpenAPI spec:
https://www.tieroneerp.com/swagger/v1/swagger.json

Build me a Node.js service that:
1. Listens for sale webhooks from my platform
2. Creates a POS transaction in Tier One via
   POST /api/v1/sales/pos
3. Syncs the product catalog nightly via
   GET/POST /api/v1/products
4. Subscribes to inventory.low_stock webhooks
   from Tier One and alerts our Slack channel"
Get started

Ready to connect?

Spin up your workspace in seconds. Full API access is included in every plan, including the free trial. No credit card required.

Start Free Trial View Full API Docs