Invoicing Solution

Streamline your business process and explore our guide and examples of how to integrate workadu

API reference

Overview

Workadu offers a comprehensive invoice solution designed to empower sellers to issue invoices at their convenience, utilizing versatile tools. With the Workadu platform (reference API), you can seamlessly incorporate Workadu invoice capabilities into your applications, facilitating the handling of online, in-app, and in-person invoice. Additionally, these API grant you the ability to publish and send the invoices to customers and to myData (greek tax system) as e-invoices

Prerequisites

You will need the following in order to start your integration:

Implementation

Follow these steps to create an Invoice with the following order :

Repeat the 4th step to add more lines to your invoice. 

1. Authenticate and add headers to your call - reference here 

curl https://app.workadu.com/api/services -u based64_API_KEY:

2. Create a new customer and get its id - reference API customers

curl https://app.workadu.com/api/customers \ 
-u wk_abcd123123abcd1234: \
-d fullname = John Doe \
-d email = john@doe.com

3. Create a draft invoice - reference API invoice

curl https://app.workadu.com/api/invoices \ 
-u wk_abcd123123abcd1234: \
-d customer_id = 1234 \
-d series_id = 2100

series_id is document type id for example invoice or receipt or credit invoice. The id you will find it at the app.

4. Add invoice lines a the invoice - reference API invoice line

curl https://app.workadu.com/api/invoiceline \ 
-u wk_abcd123123abcd1234: \
-d  invoice_id = 1231 \
-d description=  "2 days charge" \
-d amount = 12.00

5. Publish the invoice - reference API invoice publish

curl https://app.workadu.com/invoices/publish \ 
-u wk_abcd123123abcd1234: \
-d  invoice_id = 1231 \
-d send = true \
-d aade_send = true

send option will publish and send the invoice to customer, aade_send will publish and send the invoice to myData (AADE, greek tax system)


6. Special Note on POS Payment Integration

When publishing an invoice with the payment type set to “POS” (Point of Sale), the request stays the same. This action unlocks the POS terminal and starts the payment process. The first response will show “Awaiting POS Payment".

To determine the outcome of the payment, you must check the status of the invoice again, using the following route:
GET https://app.workadu.com/api/invoices
For more details, refer to the API reference for status handling and best practices.

Go Live

In order to go live you should do the following steps :

Your success story starts today.

Start developing