API Docs

Returns API capabilities, available features, tenant list with per-tenant links, and a complete list of all API endpoints with methods, paths, auth requirements, and descriptions. This is the primary entry point for AI agents.

Health check endpoint. Returns API status and version.

List all available tenants (merchants/brands).

Public tenant profile — contact info, billing details, bank accounts.

Response:

{
  "code": "myshop",
  "name": "My Shop",
  "url": "https://myshop.com",
  "email": "[email protected]",
  "phone": "+420 123 456 789",
  "billing": {
    "company": "My Company s.r.o.",
    "street": "Hlavní 123",
    "city": "Praha",
    "zip": "110 00",
    "country": "Česká republika",
    "ic": "12345678",
    "dic": "CZ12345678"
  },
  "bank_accounts": [
    {
      "account_name": "My Company s.r.o.",
      "bank_name": "Fio banka",
      "currency": "CZK",
      "account_number": "2600123456/2010",
      "iban": "",
      "swift": "",
      "note": "Hlavní účet"
    },
    {
      "account_name": "My Company s.r.o.",
      "bank_name": "Raiffeisenbank",
      "currency": "EUR",
      "account_number": "",
      "iban": "CZ6555000000001234567890",
      "swift": "RZBCCZPP",
      "note": ""
    }
  ]
}

List all products. Supports filtering and pagination.

Query params: category, limit, offset, include

Get single product by SKU or ID.

Include: ?include=provenance,documents,media

List product categories with hierarchy.

List material sources with origin and lifecycle information.

List authors/creators with profiles and works.

Get author detail by slug.

List certificates and documents.

Verify product authenticity using coin code and hash.

Query params: code, hash

Complete wholesale catalog with categories and products (public, no auth).

Paginated flat product list with stock quantities. Requires Bearer token.

Query params: page, limit (max 100), search, stock_status (in_stock|low_stock|out_of_stock), sort (name|stock_qty|price|updated), stock_qty_min, stock_qty_max

Numeric values (attributes, weight) are formatted without trailing zeros: 1.0000 → 1, 2.5000 → 2.5

Response:

{
  "data": [
    {
      "id": 4217,
      "sku": "ABC",
      "name": "Product Name",
      "price": 29.0,
      "stock_status": "in_stock",
      "stock_qty": 50,
      "category_name": "Category",
      "image_url": "https://..."
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 646,
    "pages": 33
  }
}

Single product detail with attributes. Requires Bearer token.

Attribute definitions for the catalog.

Upload Pohoda XML export and import stock cards. Accepts multipart file upload or raw XML body. Windows-1250 encoding is converted automatically.

Auth: Authorization: Bearer {token}

File upload:

curl -X POST -H "Authorization: Bearer TOKEN" \
  -F "[email protected]" \
  "https://veruno.cz/api/v1/{tenant}/pohoda/import"

Raw XML body:

curl -X POST -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/xml" \
  --data-binary @Zasoby.xml \
  "https://veruno.cz/api/v1/{tenant}/pohoda/import"

Response:

{
  "success": true,
  "import": {
    "id": 1,
    "total": 1066,
    "inserted": 1063,
    "updated": 3,
    "skipped": 0,
    "errors": 0
  }
}

List imported stock cards with pagination and filters.

Auth: Authorization: Bearer {token}

Query params: search, storage, is_internet (0|1), archived (0|1|all, default: 0), page, per_page (max 200)

Response:

{
  "items": [
    {
      "id": 1,
      "pohoda_code": "ABC123",
      "name": "Product Name",
      "unit": "ks",
      "storage_code": "SKLAD01",
      "count": "150.000",
      "selling_price": "560.00",
      "is_internet": 1,
      "is_archived": 0
    }
  ],
  "total": 1063,
  "page": 1,
  "per_page": 50,
  "pages": 22
}

Single stock item detail including price levels.

Auth: Authorization: Bearer {token}

Toggle or set archived status. Archived items are excluded from diff comparison and hidden by default in stock list.

Auth: Authorization: Bearer {token}

Body (optional):

{"archived": true}

If body is empty, toggles the current state.

List import history with status and counters.

Auth: Authorization: Bearer {token}

Query params: limit (max 100, default: 20)

List all SKU mappings.

Auth: Authorization: Bearer {token}

Create a new mapping.

Auth: Authorization: Bearer {token}

Body:

{
  "pohoda_code": "ABC123",
  "shop_sku": "SKU-001",
  "shop_source": "bulk",
  "multiplier": 1.0,
  "note": "Optional note"
}

Update an existing mapping.

Auth: Authorization: Bearer {token}

Delete a mapping.

Auth: Authorization: Bearer {token}

Compare Pohoda stock with Bulk product catalog. Returns matched items (with and without differences), unmatched Pohoda items, and unmatched shop products. Archived items are excluded.

Auth: Authorization: Bearer {token}

Response:

{
  "matched": [
    {
      "pohoda_code": "ABC123",
      "bulk_sku": "SKU-001",
      "pohoda_name": "Product in Pohoda",
      "bulk_name": "Product in Shop",
      "diffs": [
        {"field": "stock", "pohoda": 150.0, "bulk": 120.0},
        {"field": "price", "pohoda": 560.0, "bulk": 590.0}
      ]
    }
  ],
  "unmatched_pohoda": [
    {"pohoda_code": "XYZ", "name": "Only in Pohoda", "count": "50.000"}
  ],
  "unmatched_bulk": [
    {"sku": "NEW-01", "name": "Only in Shop", "price": "299.00"}
  ]
}

Export selected orders as Pohoda XML (receivedOrder dataPack, Windows-1250 encoding). Download the XML file and import it into Stormware Pohoda.

Auth: Authorization: Bearer {token}

Query params: ids (comma-separated order IDs, max 500)

Prerequisites: Pohoda IČO must be configured in Objednávky → Nastavení → Export do Pohody.

Response: XML file (Content-Type: application/xml; charset=windows-1250)

curl -H "Authorization: Bearer TOKEN" \
  "https://veruno.cz/api/v1/{tenant}/pohoda/export-orders?ids=1,2,3" \
  -o orders.xml

Sync orders from WooCommerce. Called by WooCommerce Connector plugin or manually.

Auth: Authorization: Bearer {token}

Body:

{
  "shop_url": "https://your-shop.com",
  "orders": [
    {
      "id": 123,
      "order_number": "12345",
      "status": "processing",
      "customer_name": "Jan Novák",
      "customer_email": "[email protected]",
      ...
    }
  ]
}

List orders synced from WooCommerce.

Query params: status, per_page, page

Auth: Authorization: Bearer {token}

Get single order detail with items, addresses, and tracking info.

Order statuses: processing, on-hold, pending, shipped, completed, cancelled, refunded, failed, trash

List active shipping carriers with tracking URL patterns. No auth required.

Add tracking number to a single order.

Body:

{
  "carrier": "DPD",
  "tracking_number": "0123456789",
  "package_index": 1
}

Bulk import tracking numbers for multiple orders.

Body:

{
  "tracking": [
    {"order_number": "12345", "carrier": "DPD", "tracking_number": "0123456789"},
    {"order_number": "12346", "carrier": "GLS", "tracking_number": "9876543210"}
  ]
}

Remove tracking from order.

Public tracking lookup. No authentication required.

Query params: postcode (required) - shipping postal code for verification

Response:

{
  "order_number": "12345",
  "status": "shipped",
  "tracking": [
    {
      "carrier": "DPD",
      "tracking_number": "0123456789",
      "tracking_url": "https://...",
      "status": "delivered",
      "status_label": "Doručeno",
      "shipped_at": "2026-02-25"
    }
  ]
}

Get tracking status for all packages in an order. For AI agents to check delivery status and trigger notifications.

Auth: Authorization: Bearer {token}

Query params: refresh=1 - force status refresh from carrier API (rate limited)

Response:

{
  "order_number": "12345",
  "order_status": "completed",
  "all_delivered": true,
  "tracking_count": 1,
  "tracking": [
    {
      "id": 1,
      "carrier": "DPD",
      "tracking_number": "0123456789",
      "tracking_url": "https://...",
      "status": "delivered",
      "status_label": "Doručeno",
      "status_detail": "The parcel was delivered 24.02.2026, 08:35.",
      "status_checked_at": "2026-02-27T09:42:53Z",
      "shipped_at": "2026-02-26"
    }
  ],
  "refreshed": 1
}

Receive push tracking events from DPD. No tenant scope needed — tenant is identified by API key.

Auth: X-API-KEY: {dpd_push_api_key}

IP whitelist: Only DPD production (213.41.95.161) and pre-production (213.41.95.174) IPs are allowed.

Body: Array of parcel events:

[
  {
    "parcelNumber": "13825074964179",
    "event": {
      "statusId": "DEY",
      "eventDateTime": "2026-03-03T10:00:00Z",
      "country": "CZ",
      "city": "Praha"
    }
  }
]

Response:

{"ok": true, "processed": 1, "updated": 1}

Calculate shipping prices for a given country and order parameters. Returns available shipping methods with calculated prices, zone info, and delivery estimates.

Auth: None (public endpoint)

Body:

{
  "country_code": "CZ",
  "weight_kg": 8,
  "value": 2000,
  "volume_m3": 0.05,
  "items_count": 1
}

Parameters:

• country_code (required) — 2-letter ISO country code
• weight_kg — package weight (in tenant's weight unit)
• value — order value (for free-above-value rules)
• volume_m3 — package volume in cubic meters
• items_count — number of items (default: 1)

Response:

{
  "zone": {
    "id": 1,
    "name": "Domácí",
    "code": "domaci"
  },
  "delivery_days": {
    "min": 1,
    "max": 3,
    "season": false
  },
  "methods": [
    {
      "method_id": 1,
      "method_name": "DPD Private",
      "carrier_code": "DPD",
      "pricing_model": "weight",
      "price": 149.00,
      "is_free": false,
      "parcels": 1
    },
    {
      "method_id": 2,
      "method_name": "Osobní odběr",
      "carrier_code": "PICKUP",
      "pricing_model": "free",
      "price": 0,
      "is_free": true,
      "parcels": 1
    }
  ]
}

If the country is not in any zone, zone will be null and methods will be empty.

parcels indicates number of packages. When shipment weight exceeds the tier maximum, it is automatically split into multiple parcels (e.g. 50kg with 29kg tier limit → parcels: 2, price doubled).

List all active shipping methods with their pricing tiers.

Auth: None (public endpoint)

Response:

[
  {
    "id": 1,
    "name": "DPD Private",
    "carrier_code": "DPD",
    "carrier_name": "DPD",
    "zone": {"code": "domaci", "name": "Domácí"},
    "pricing_model": "weight",
    "is_active": true,
    "tiers": [
      {"threshold_from": 0, "threshold_to": 5000, "price": 99.00, "multiplier": 1.00},
      {"threshold_from": 5000, "threshold_to": 15000, "price": 149.00, "multiplier": 1.00},
      {"threshold_from": 15000, "threshold_to": null, "price": 249.00, "multiplier": 1.00}
    ]
  }
]

Attach a selected shipping method and price to an order. Logs the selection in shipping quotes.

Auth: Authorization: Bearer {token}

Body:

{
  "order_ref": "12345",
  "method_id": 1,
  "price": 149.00
}

Response:

{
  "success": true,
  "order_ref": "12345",
  "method_id": 1,
  "price": 149.00
}

Tenant info for mobile app onboarding. Returns tenant name, settings, product/order counts.

Register device for push notifications (Expo Push Service).

Body:

{
  "expo_push_token": "ExponentPushToken[xxxxxx]",
  "platform": "ios",
  "device_name": "iPhone 15",
  "notifications": {"new_order": true, "low_stock": true}
}

Unregister device (soft delete).

Update product stock. Supports two modes: set specific quantity or mark as always in stock (no quantity tracking). Logs change, triggers stock.updated webhook, and syncs to WooCommerce.

Mode 1 – Set quantity:

{
  "stock_quantity": 25,
  "reason": "inventory_count",
  "low_stock_threshold": 5
}

Mode 2 – Always in stock (no quantity tracking):

{
  "stock_status": "in_stock",
  "reason": "unlimited_stock"
}

Mode 2 sets stock_qty = NULL and stock_status = 'in_stock'. Product will always show as in stock without tracking inventory.

Bulk stock update (max 100 products per request, transactional). Sends single sync notification to WooCommerce.

Body:

{
  "updates": [
    {"product_id": 1, "stock_quantity": 50},
    {"product_id": 2, "stock_quantity": 0}
  ]
}

Import tracking numbers across all tenants in the group. The system automatically matches each order number to the correct tenant.

Auth: Authorization: Bearer {group_api_key} (separate from tenant API tokens)

Body:

{
  "tracking": [
    {"order_number": "300123", "carrier": "DPD", "tracking_number": "01234567890"},
    {"order_number": "600456", "carrier": "GLS", "tracking_number": "09876543210"}
  ]
}

Response:

{
  "success": true,
  "group": "my-group",
  "tracking_imported": 1,
  "skipped": 0,
  "errors": [
    {"order_number": "600456", "reason": "Order not found in any tenant"}
  ],
  "detail": [
    {"order_number": "300123", "tenant": "inmart", "status": "imported"},
    {"order_number": "600456", "tenant": null, "status": "error"}
  ]
}

Public API status — returns real-time health of all monitored endpoints, grouped by service. No authentication required.

Response:

{
  "status": "operational",
  "groups": [
    {
      "name": "Core",
      "status": "operational",
      "endpoints": [
        {
          "name": "Health",
          "url": "/api/v1/health",
          "status": "operational",
          "response_time_ms": 45
        }
      ]
    }
  ],
  "uptime_7d": [
    {"date": "2026-03-09", "status": "operational", "checks": 96, "failures": 0}
  ]
}

Import products from WooCommerce. Requires API token.

Export products from WooCommerce. Requires Bearer token.

Query params: page, per_page (max 200), status, include_variants

Export orders from WooCommerce. All statuses are exported (including custom). Requires Bearer token.

Query params: page, per_page, status (default: any), created_after, modified_after

Response includes: order details, items (with subtotal, total_tax, tax_rate for Pohoda), billing/shipping addresses (with ico/dic), fees/tips, customer note.

Import tracking numbers into WooCommerce orders. Sets custom order status "Odesláno" (wc-shipped).

Lightweight stock query for specific SKUs. Used by Veruno cron to update bulk stock after order sync — instead of full product pull. Requires Bearer token.

Query params: skus — comma-separated SKU list (max 200)

// Response
{
  "stock": {
    "SKU-001": { "stock_qty": 25, "stock_status": "instock", "manage_stock": true },
    "SKU-002": { "stock_qty": 0, "stock_status": "outofstock", "manage_stock": true },
    "UNKNOWN": null
  },
  "count": 3
}

Receive stock updates from Veruno and apply to WooCommerce products. Called automatically when stock is updated via Veruno API. Requires Bearer token.

Body:

{
  "type": "stock_updated",
  "products": [
    {"id": 1, "sku": "ABC", "stock_qty": 25, "wc_product_id": 456}
  ],
  "tenant": "inmart",
  "timestamp": "2026-03-01T14:30:00+01:00"
}

Products are matched by wc_product_id first, then by sku as fallback.

Health check - returns shop info and plugin version.

Check for plugin updates. Returns latest version info.

Full plugin information including changelog.