Create sale

Creates a new record.

POSThttps://api.tracksales.co/v1/sales

Required scope: sales:create

Request URL: https://api.tracksales.co/v1/sales

Body Params

locationIdstringrequired

Branch location UUID

customerIdstring

Customer UUID (optional for walk-in sales)

itemsarrayrequired

Line items with itemId, quantity, unitPrice, optional taxPercent

paymentsarrayrequired

Payments with paymentType and amount

salesChannelstring

Sale channel: online or in_store. Defaults to in_store. Use online for storefront orders that will be fulfilled.

externalReferencestring

Caller reference, such as the Esmanda order number

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Sales was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/v1/sales' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"locationId":"660e8400-e29b-41d4-a716-446655440001","customerId":"660e8400-e29b-41d4-a716-446655440010","items":[{"itemId":"550e8400-e29b-41d4-a716-446655440000","quantity":2,"unitPrice":5000,"taxPercent":16}],"payments":[{"paymentType":"M-Pesa","amount":11600,"reference":"ESM-1042"}],"salesChannel":"online","externalReference":"ESM-1042"}'

{
    "success": true,
    "data": {
        "id": "880e8400-e29b-41d4-a716-446655440099",
        "uuid": "880e8400-e29b-41d4-a716-446655440099",
        "reference": "SR-00042",
        "type": "sale",
        "status": "paid",
        "customerId": "660e8400-e29b-41d4-a716-446655440010",
        "locationId": "660e8400-e29b-41d4-a716-446655440001",
        "total": 11600
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Sales not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}