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:

• a Workadu account - sing up for free here
  
• an API-key - learn how to get your key
• predefine you invoice document types that you will use. Note down the ids of these types - find out your account series (document types)
• predefine your invoice document types for transactions, like cash, bank deposit, credit card or your own type (you will need both fiscal and transaction ids) -  find out your account series (document types for transactions) 
• Decide if your app or workadu will send the invoices to the customer 

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 :

• Upgrade your workadu subscription - check plans and upgrade
  
• Get your myData api keys. You must have an aade user account - click here to login and issue the keys (ERP API keys)
• Enable myData integration from integrations panel at your workadu account (you will need myData api keys) -watch the how to video (in greek) 
• Start issuing invoices