Keytouse-UBL-API

KeyToUse

KeyToUse is a pioneering company specializing in e-invoicing solutions that adhere to UBL XML standards. With a strong focus on compliance with the Zakat, Tax and Customs Authority (ZATCA) regulations, KeyToUse has developed an exceptional platform that streamlines the invoicing process for businesses. The solutions offered enhance efficiency, reduce errors, and ensure seamless integration with existing enterprise resource planning (ERP) systems. By leveraging state-of-the-art technology, KeyToUse provides clients with a robust framework for electronic invoicing that not only meets but exceeds industry standards.

The hallmark of KeyToUse's offerings is a commitment to delivering excellent service and customer satisfaction. A user-friendly interface allows for rapid invoice generation and processing, enabling businesses to maintain compliance while significantly reducing administrative burdens. KeyToUse’s platform features advanced data validation processes and real-time analytics, empowering companies to gain valuable insights into invoicing operations. This proactive approach ensures that clients can manage invoicing needs efficiently, minimizing delays and enhancing cash flow.

In addition to technical capabilities, KeyToUse prides itself on providing personalized support to clients. A dedicated team of experts is available to assist with implementation and ongoing management, ensuring that businesses can fully leverage the benefits of e-invoicing. By choosing Key To Use, organizations can confidently navigate the complexities of electronic invoicing while enjoying a significant reduction in costs and operational risks associated with traditional paper-based processes.

That's how it works:

1. Insert Data into the Database:
First, send insert statements as POST requests to populate rows in the database. All POST request are sent to https://ubl.keytouse.com/zatca

2. Select Data from the Invoice Table:
Next, send another POST request with XML as the request type.
For example, if you want to select all rows from the Invoice table that you have already inserted, the JSON format should be:

[{"requesttype": "getsetdata", "query": "SELECT * FROM Invoice"}]

3. Using cURL to Retrieve Data:
You can try using cURL as follows:

curl -X POST -H "Content-Type: application/json" -d "[{\"requesttype\": \"getsetdata\", \"query\": \"SELECT * FROM Invoice\"}]" https://ubl.keytouse.com/zatca

This command will return data from the Invoice table as plain text.

4. Retrieve Specific Invoice in XML Format:
To obtain the XML format of a specific invoice, use the following cURL command:

curl -X POST -H "Content-Type: application/json" -d "[{\"requesttype\": \"getxml\", \"invoiceid\":\"INV001\"}]" https://ubl.keytouse.com/zatca

5. Quick View of Invoice in XML Format:
For a quick view, you can use the following URL in your browser to get the invoice in XML format:

https://ubl.keytouse.com/xmlgen?invoiceid=INV001

6. Efficient Data Upload:
Note that a single query to get or set data or to retrieve XML is not as efficient as uploading all data as a JSON file.
A JSON file can be uploaded to facilitate programmatic process automation. For example, a Python client can do this:

payload = [{"requesttype": "setdata", "data": json.dumps(data)}]
response = requests.post("https://ubl.keytouse.com/zatca", json=payload)

If the upload is successful, the XML invoice will be returned in the response; otherwise, an error will be returned.

7. Conclusion:
Pretty simple!