eTIMS API

Initialize your OSCU device and obtain the CMC key. Call once before submitting invoices.

Request

curl -X POST https://etims.pemystack.com/api/etims-init \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "cmcKey": "your-communication-key",
  "message": "Device initialized. CMC key saved."
}

Submit a sales invoice to KRA eTIMS. Returns the CU invoice number and QR code data.

Request

curl -X POST https://etims.pemystack.com/api/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceNo": "INV-001",
    "items": [
      {
        "name": "Nyama Choma",
        "quantity": 2,
        "unitPrice": 85000,
        "taxType": "A"
      },
      {
        "name": "Tusker Lager",
        "quantity": 3,
        "unitPrice": 25000,
        "taxType": "B"
      }
    ],
    "customerPin": "A123456789B",
    "customerName": "John Kamau",
    "paymentType": "04"
  }'

Response

{
  "success": true,
  "cuInvoiceNo": "CUA0051001",
  "qrCodeData": "base64-encoded-qr-data"
}

Invoice Fields