Download the PHP package paybilldev/kra-etims-sdk without Composer

On this page you can find all versions of the php package paybilldev/kra-etims-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package kra-etims-sdk

KRA eTims Integration SDK

A PHP SDK for integrating with the Kenya Revenue Authority (KRA) Electronic Tax Invoice Management System (eTims) API for Paybill Kenya but can generally be used in any php project.

Author

Bartile Emmanuel

Email: [email protected]

Tel: +254757807150

Introduction to KRA eTims

Kenya Revenue Authority currently uses an Integrated Software that collects and manages domestic tax revenues. The Electronic Tax Invoice Management System (eTims) has introduced a supply chain management capability and integration with other KRA systems.

Area of Application

KRA seeks to introduce the usage of Online and Virtual Sales Control Unit (OSCU & VSCU) capable of handling a richer dataset than the traditional Electronic Tax Register system. This system includes specific requirements concerning the Trader Invoicing System to be used together with an Online or Virtual Sales Control Unit.

Key Definitions

Receipt Types

Each receipt issued by Trader Invoicing System is formed from a combination of receipt type and transaction type:

  1. Receipt types: NORMAL, COPY, TRAINING, PROFORMA
  2. Transaction types: SALE, CREDIT NOTE, DEBIT NOTE

Receipt Labels

RECEIPT TYPE TRANSACTION TYPE RECEIPT LABEL
NORMAL SALES NS
NORMAL CREDIT NOTE NC
COPY SALES CS
COPY CREDIT NOTE CC
TRAINING SALES TS
TRAINING CREDIT NOTE TC
PROFORMA SALES PS

Features

Installation

Project Structure

Usage

As a PHP SDK

TIS Specifications and Requirements

Data Flow Between TIS and OSCU/VSCU

For the purpose of signing an invoice, the data flow between the Trader Invoicing System and the Virtual Sales Control Unit will be as follows for each receipt type:

  1. TIS sends receipt data to OSCU/VSCU:

    • Date and time
    • Personal Identification Number
    • Buyer's PIN (Optional)
    • Receipt number
    • Receipt type and transaction type
    • Tax rates
    • Total amounts with tax
    • Tax amounts
  2. OSCU/VSCU receives receipt data from TIS

  3. OSCU/VSCU generates response data and sends it back to TIS:

    • SCU ID
    • Date and time
    • Receipt label
    • Receipt counter per receipt type
    • Receipt counter of all receipts
    • Digital signatures (except for TRAINING and PROFORMA receipts)
  4. TIS finalizes receipt by printing OSCU/VSCU information on the receipt

  5. TIS sends complete journal data of NS and NC receipt labels in text form to OSCU/VSCU

Receipt Requirements

A receipt must show the following minimum required information:

  1. Taxpayer's name
  2. Personal Identification Number
  3. The address at which the sale takes place
  4. Personal Identification number of the buyer
  5. Receipt type and transaction type
  6. Serial number of the receipt from an uninterrupted ascending number series per receipt type
  7. Registered items and/or services with description, quantity, price, with any other action that may be done such as cancellations, corrections
  8. Total sales amount
  9. Tax rates applied
  10. The value added tax added to the sale amount
  11. Means of payment
  12. SCU information:
    • Date and time stamped by OSCU/VSCU
    • Sequential receipt type number
    • Receipt signatures
    • OSCU/VSCU identification number
  13. Date and time stamped by TIS

TIS Functional Requirements

  1. TIS shall not issue a receipt of any type before the data flow with OSCU/VSCU has been finalized
  2. Copies, training, or proforma receipts must be clearly distinguishable from normal receipts
  3. All corrections on the receipt should be performed before approving it
  4. Normal Sale (NS) refers to a receipt that shall be produced and offered to the client
  5. TIS shall not be able to register a sales amount without simultaneously printing a receipt
  6. TIS shall not be able to register the amount of a transaction without identifying the good and/or service
  7. TIS shall not be able to correct a transaction without prior cancelation of the original transaction
  8. TIS shall print only one original receipt. Reprints shall have a watermark with mention "Copy"
  9. TIS shall not issue a receipt of goods when the corresponding stock is less than the requested quantity

Development

License

MIT


All versions of kra-etims-sdk with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0|^7.0
respect/validation Version ^2.4
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package paybilldev/kra-etims-sdk contains the following files

Loading the files please wait ....