Push sale to eTIMS

Fiscalises an invoice or credit note sale with KRA.

POSThttps://api.tracksales.co/api/v1/etims/sales/{saleUuid}/push

Required scope: etims:create

Path Params

saleUuidstringrequired

Sale / invoice UUID

Body Params

location_idinteger

Branch location ID

credit_noteboolean

Set true for credit notes

original_sale_idinteger

Original invoice ID for credit notes

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Sale was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/api/v1/etims/sales/{saleUuid}/push' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"location_id":1}'

{
    "success": true,
    "data": {
        "success": true,
        "cu_invoice_num": "KRACU123456"
    }
}

{
    "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": "Sale not found"
}

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