{
  "info": {
    "name": "Tracepos Public API (v1)",
    "_postman_id": "9b128fae-7832-4d2a-8ce4-e0b58e234567",
    "description": "Official, comprehensive Postman Collection for the Tracepos Public REST API v1. Supports dual-header authentication (X-Tracepos-Public-Key & X-Tracepos-Secret-Key) and covers all 19 public endpoints across catalog, inventory, pricing, CRM, sales, procurement, payments, expenses, and returns.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://app.tracepos.net/api/v1/public",
      "type": "string"
    },
    {
      "key": "publicKey",
      "value": "YOUR_PUBLIC_KEY",
      "type": "string"
    },
    {
      "key": "secretKey",
      "value": "YOUR_SECRET_KEY",
      "type": "string"
    },
    {
      "key": "product_xid",
      "value": "w8vBqGZ0",
      "type": "string"
    },
    {
      "key": "category_xid",
      "value": "cat_12345",
      "type": "string"
    },
    {
      "key": "brand_xid",
      "value": "brd_67890",
      "type": "string"
    },
    {
      "key": "warehouse_xid",
      "value": "wh_11223",
      "type": "string"
    },
    {
      "key": "customer_xid",
      "value": "usr_9x8a7b6c5d4e",
      "type": "string"
    },
    {
      "key": "supplier_xid",
      "value": "usr_7z6y5x4w3v2u",
      "type": "string"
    },
    {
      "key": "sale_xid",
      "value": "ord_9182ab3c4d5e",
      "type": "string"
    },
    {
      "key": "purchase_xid",
      "value": "purch_a1b2c3d4e5",
      "type": "string"
    },
    {
      "key": "payment_mode_xid",
      "value": "pm_cash_01",
      "type": "string"
    },
    {
      "key": "stock_adjustment_xid",
      "value": "adj_8912ef34",
      "type": "string"
    },
    {
      "key": "price_adjustment_xid",
      "value": "padj_99182ab3",
      "type": "string"
    },
    {
      "key": "expense_category_xid",
      "value": "expcat_123",
      "type": "string"
    },
    {
      "key": "expense_xid",
      "value": "exp_456",
      "type": "string"
    },
    {
      "key": "order_xid",
      "value": "ord_9182ab3c4d5e",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "1. Catalog & Outlets",
      "description": "Products, Categories, Brands, and Warehouses master data.",
      "item": [
        {
          "name": "List Products",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/products?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["products"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "List Products by Category",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/products?category_id={{category_xid}}&limit=20",
              "host": ["{{baseUrl}}"],
              "path": ["products"],
              "query": [
                { "key": "category_id", "value": "{{category_xid}}" },
                { "key": "limit", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "Get Single Product",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/{{product_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["products", "{{product_xid}}"]
            }
          }
        },
        {
          "name": "List Categories",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/categories",
              "host": ["{{baseUrl}}"],
              "path": ["categories"]
            }
          }
        },
        {
          "name": "Get Single Category",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/categories/{{category_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["categories", "{{category_xid}}"]
            }
          }
        },
        {
          "name": "List Brands",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/brands",
              "host": ["{{baseUrl}}"],
              "path": ["brands"]
            }
          }
        },
        {
          "name": "Get Single Brand",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/brands/{{brand_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["brands", "{{brand_xid}}"]
            }
          }
        },
        {
          "name": "List Warehouses",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/warehouses",
              "host": ["{{baseUrl}}"],
              "path": ["warehouses"]
            }
          }
        },
        {
          "name": "Get Single Warehouse",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/warehouses/{{warehouse_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["warehouses", "{{warehouse_xid}}"]
            }
          }
        }
      ]
    },
    {
      "name": "2. Inventory & Pricing",
      "description": "Stock adjustments and price update operations.",
      "item": [
        {
          "name": "List Stock Adjustments",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/stock-adjustments?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["stock-adjustments"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Stock Adjustment",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/stock-adjustments/{{stock_adjustment_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["stock-adjustments", "{{stock_adjustment_xid}}"]
            }
          }
        },
        {
          "name": "Record Stock Adjustment",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"product_id\": \"{{product_xid}}\",\n  \"quantity\": 2,\n  \"adjustment_type\": \"add\",\n  \"notes\": \"Physical inventory recount\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/stock-adjustments",
              "host": ["{{baseUrl}}"],
              "path": ["stock-adjustments"]
            }
          }
        },
        {
          "name": "List Price Adjustments",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/price-adjustments?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["price-adjustments"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Price Adjustment",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/price-adjustments/{{price_adjustment_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["price-adjustments", "{{price_adjustment_xid}}"]
            }
          }
        },
        {
          "name": "Update Product Price",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"product_id\": \"{{product_xid}}\",\n  \"new_sales_price\": 1500\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/price-adjustments",
              "host": ["{{baseUrl}}"],
              "path": ["price-adjustments"]
            }
          }
        }
      ]
    },
    {
      "name": "3. Parties & CRM",
      "description": "Customer profiles, credit limits, and Supplier accounts.",
      "item": [
        {
          "name": "List Customers",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["customers"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Customer",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/{{customer_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["customers", "{{customer_xid}}"]
            }
          }
        },
        {
          "name": "Create Customer",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Kafspeedway Logistics Ltd\",\n  \"phone\": \"+2348149876543\",\n  \"email\": \"procurement@kafspeedway.ng\",\n  \"opening_balance\": 15000.00,\n  \"opening_balance_type\": \"receive\",\n  \"credit_limit\": 200000.00\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/customers",
              "host": ["{{baseUrl}}"],
              "path": ["customers"]
            }
          }
        },
        {
          "name": "List Suppliers",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/suppliers?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["suppliers"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Supplier",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/suppliers/{{supplier_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["suppliers", "{{supplier_xid}}"]
            }
          }
        },
        {
          "name": "Create Supplier",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Nestle Nigeria Direct Distribution\",\n  \"phone\": \"+23412790000\",\n  \"email\": \"distribution@ng.nestle.com\",\n  \"opening_balance\": 0.00,\n  \"opening_balance_type\": \"pay\",\n  \"credit_period\": 30\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/suppliers",
              "host": ["{{baseUrl}}"],
              "path": ["suppliers"]
            }
          }
        }
      ]
    },
    {
      "name": "4. Sales & Transactions",
      "description": "Sales checkout, POS transactions, and customer order history.",
      "item": [
        {
          "name": "List Sales Orders",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales?dates=2026-09-01,2026-10-02&limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["sales"],
              "query": [
                { "key": "dates", "value": "2026-09-01,2026-10-02" },
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Sale Order",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales/{{sale_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["sales", "{{sale_xid}}"]
            }
          }
        },
        {
          "name": "Create Sale (POS Checkout)",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{customer_xid}}\",\n  \"order_date\": \"2026-10-02T10:30:00Z\",\n  \"notes\": \"External POS order reference 12345\",\n  \"shipping\": 0,\n  \"product_items\": [\n    {\n      \"product_id\": \"{{product_xid}}\",\n      \"quantity\": 2,\n      \"unit_price\": 1500,\n      \"discount\": 0\n    }\n  ],\n  \"all_payments\": [\n    {\n      \"payment_mode_id\": \"{{payment_mode_xid}}\",\n      \"amount\": 3000\n    }\n  ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/sales",
              "host": ["{{baseUrl}}"],
              "path": ["sales"]
            }
          }
        }
      ]
    },
    {
      "name": "5. Purchases & Procurement",
      "description": "Stock inward intake and supplier procurement invoices.",
      "item": [
        {
          "name": "List Purchases",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/purchases?dates=2026-09-01,2026-10-02&limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["purchases"],
              "query": [
                { "key": "dates", "value": "2026-09-01,2026-10-02" },
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Get Single Purchase Order",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/purchases/{{purchase_xid}}",
              "host": ["{{baseUrl}}"],
              "path": ["purchases", "{{purchase_xid}}"]
            }
          }
        },
        {
          "name": "Create Purchase (Stock Inward)",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{supplier_xid}}\",\n  \"order_date\": \"2026-10-02\",\n  \"invoice_number\": \"DANGOTE-INV-99382\",\n  \"product_items\": [\n    {\n      \"product_id\": \"{{product_xid}}\",\n      \"quantity\": 50,\n      \"unit_price\": 2200.00\n    }\n  ],\n  \"all_payments\": [\n    {\n      \"payment_mode_id\": \"{{payment_mode_xid}}\",\n      \"amount\": 110000.00\n    }\n  ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/purchases",
              "host": ["{{baseUrl}}"],
              "path": ["purchases"]
            }
          }
        }
      ]
    },
    {
      "name": "6. Payments & Settlements",
      "description": "Payment mode discovery, unpaid invoice matching, and ledger payment vouchers.",
      "item": [
        {
          "name": "List Payment Modes",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment-modes?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["payment-modes"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "List Payments",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["payments"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Discover Unpaid Invoices",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments/user-invoices?user_id={{customer_xid}}&payment_type=in",
              "host": ["{{baseUrl}}"],
              "path": ["payments", "user-invoices"],
              "query": [
                { "key": "user_id", "value": "{{customer_xid}}" },
                { "key": "payment_type", "value": "in" }
              ]
            }
          }
        },
        {
          "name": "List Customer & Supplier Directory",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments/customer-suppliers",
              "host": ["{{baseUrl}}"],
              "path": ["payments", "customer-suppliers"]
            }
          }
        },
        {
          "name": "Record Payment & Settle Invoices",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{customer_xid}}\",\n  \"amount\": 3000,\n  \"payment_type\": \"in\",\n  \"payment_mode_id\": \"{{payment_mode_xid}}\",\n  \"date\": \"2026-10-02\",\n  \"invoices\": [\n    {\n      \"order_id\": \"{{order_xid}}\",\n      \"amount\": 3000\n    }\n  ],\n  \"notes\": \"POS Settlement Ref: TXN-POS-893012\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/payments",
              "host": ["{{baseUrl}}"],
              "path": ["payments"]
            }
          }
        }
      ]
    },
    {
      "name": "7. Expense Management",
      "description": "Operational expenses, categories, and approved pay-offs.",
      "item": [
        {
          "name": "List Expense Categories",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/expense-categories",
              "host": ["{{baseUrl}}"],
              "path": ["expense-categories"]
            }
          }
        },
        {
          "name": "List Expenses",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/expenses?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["expenses"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Record Expense",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"expense_category_id\": \"{{expense_category_xid}}\",\n  \"amount\": 15000.00,\n  \"payment_mode_id\": \"{{payment_mode_xid}}\",\n  \"date\": \"2026-10-02\",\n  \"notes\": \"Generator diesel refill\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/expenses",
              "host": ["{{baseUrl}}"],
              "path": ["expenses"]
            }
          }
        },
        {
          "name": "Pay Off Due Expense",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"expense_id\": \"{{expense_xid}}\",\n  \"payment_mode_id\": \"{{payment_mode_xid}}\",\n  \"amount\": 15000.00,\n  \"date\": \"2026-10-02\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/expenses/{{expense_xid}}/payments",
              "host": ["{{baseUrl}}"],
              "path": ["expenses", "{{expense_xid}}", "payments"]
            }
          }
        }
      ]
    },
    {
      "name": "8. Returns & Reversals",
      "description": "Customer sales returns and supplier purchase returns.",
      "item": [
        {
          "name": "List Sales Returns",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales-returns?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["sales-returns"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Record Sales Return",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{customer_xid}}\",\n  \"order_date\": \"2026-10-02\",\n  \"invoice_number\": \"SAL-00451\",\n  \"notes\": \"Customer returned unopened carton\",\n  \"items\": [\n    {\n      \"product_id\": \"{{product_xid}}\",\n      \"quantity\": 1,\n      \"unit_price\": 2750.00\n    }\n  ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/sales-returns",
              "host": ["{{baseUrl}}"],
              "path": ["sales-returns"]
            }
          }
        },
        {
          "name": "List Purchase Returns",
          "request": {
            "method": "GET",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "url": {
              "raw": "{{baseUrl}}/purchase-returns?limit=20&page=1",
              "host": ["{{baseUrl}}"],
              "path": ["purchase-returns"],
              "query": [
                { "key": "limit", "value": "20" },
                { "key": "page", "value": "1" }
              ]
            }
          }
        },
        {
          "name": "Record Purchase Return",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Accept", "value": "application/json" },
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Tracepos-Public-Key", "value": "{{publicKey}}" },
              { "key": "X-Tracepos-Secret-Key", "value": "{{secretKey}}" }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{supplier_xid}}\",\n  \"order_date\": \"2026-10-02\",\n  \"items\": [\n    {\n      \"product_id\": \"{{product_xid}}\",\n      \"quantity\": 10,\n      \"unit_price\": 2500.00\n    }\n  ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/purchase-returns",
              "host": ["{{baseUrl}}"],
              "path": ["purchase-returns"]
            }
          }
        }
      ]
    }
  ]
}