Kumusoft Solutions
EFRIS API
Auth Service
EFRIS API
Auth Service
  1. EFRIS API
  • Get Current Taxpayer Details
    GET
  • Update AES Key
    POST
  • Get Efris Stock Items
    GET
  • Update Stock List
    POST
  • Verify TIN
    GET
  • Fiscalise
    POST
  • Preview Invoice
    POST
  • Issue CreditNote
    POST
  • Register EFRIS Product
    POST
  • Get Units Of Measure
    GET
  • Increase Stock
    POST
  • EFRIS Invoice Report
    POST
  • Invoice Details
    GET
  • Get Saved Items List
    GET
  • Get Master Data
    GET
  • Reduce stock
    POST
  1. EFRIS API

Fiscalise

POST
/efris/fiscalise

Endpoint Description#

This endpoint is used to submit a fiscalization request for processing invoices. It allows users to send detailed information regarding the seller, buyer, and items involved in a transaction.
EFRIS Document Page Number: 89
Interface Name: Invoice Upload
Interface Code: T109

Request Method#

POST

Endpoint#

{{baseUrl}}/efris/fiscalise

Request Body#

The request body must be in JSON format and should include the following parameters:
data: An object containing the details of the transaction.
sellerDetails:
referenceNo (string): A unique reference number for the seller.
basicInformation:
currency (string): The currency used for the transaction (e.g., "UGX").
invoiceType (integer): The type of invoice being issued.
invoiceKind (integer): The kind of invoice.
invoiceIndustryCode (string): The industry code associated with the invoice.
buyerDetails:
buyerBusinessName (string): The business name of the buyer.
buyerLegalName (string): The legal name of the buyer.
buyerType (string): The type of buyer (e.g., "1").
itemsBought: An array of objects representing items purchased.
Each item object includes:
itemCode (string): The unique code for the item.
quantity (integer): The quantity of the item purchased.
unitPrice (number): The price per unit of the item.
total (number): The total price for the item (quantity x unit price).
taxForm (string): The tax form applicable to the item.
taxRule (string): The tax rule applicable to the item.
discountFlag (integer): A flag indicating if a discount is applied.
discountTotal (number): The total amount of discount applied.
exciseFlag (string): A flag indicating if excise tax is applicable.
exciseRate (string): The rate of excise tax.
exciseUnit (string): The unit of measurement for excise tax.
exciseTax (string): The total excise tax amount.
exciseCurrency (string): The currency for the excise tax.

Expected Response Format#

The response will typically return a JSON object indicating the success or failure of the fiscalization request, along with any relevant messages or error codes.
Ensure that all required fields are populated correctly to avoid errors in processing the request.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://auth.efris.kakasa.xyz/api/v1/efris/fiscalise' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "sellerDetails": {
            "referenceNo": "b005"
        },
        "basicInformation": {
            "currency": "UGX",
            "invoiceType": 1,
            "invoiceKind": 1,
            "invoiceIndustryCode": "101"
        },
        "buyerDetails": {
            "buyerBusinessName": "Buyer Name",
            "buyerLegalName": "Buyer Legal Name",
            "buyerType": "1",
            "buyerTin": ""
        },
        "itemsBought": [
            {
                "itemCode": "A001",
                "quantity": 1,
                "unitPrice": 45600,
                "total": 45600,
                "taxForm": "101",
                "taxRule": "STANDARD",
                "discountFlag": 1,
                "discountTotal": 600,
                "exciseFlag": "2",
                "exciseRate": "",
                "exciseUnit": "",
                "exciseTax": "",
                "exciseCurrency": "UGX"
            }
        ]
    }
}'
Response Response Example
{}
Previous
Verify TIN
Next
Preview Invoice
Built with