Welcome to the second edition of the e-conomic developer newsletter, designed to keep you updated with the best from the e-conomic developer world, including new features, tips & tricks, resources and more. Please feel free to get back to us with your feedback or ideas for future topics. Next edition of the developer newsletter is scheduled for early/mid July.
Create your own tabs!
You can now create your own custom tabs in e-conomic, allowing you to show any web page directly in e-conomic. This means that you can access your favourite websites – e-mail systems, news sites, you name it – without leaving the e-conomic application window!
For integration purposes, the benefit is obvious: You can display external systems, i.e. any solution that is integrated with e-conomic, from within the e-conomic application. This reduces the need to switch back and forth between e-conomic and other systems, and thus makes integrations much smoother to work with.
Below, you can see how it looks with a tab created for the Tradeshift invoicing solution:
To create tabs in e-conomic, make sure you've activated the API module and then go to the 'Settings' tab and click 'Extensions' > 'Extra tabs' > 'Create tab'.
Note that if you enter 'unsafe' URLs (HTTP), you will be warned that you're mixing safe and unsafe content when you click the tab you've created. To avoid this, use only 'safe' URLs (HTTPS/SSL).
Want to create an invoice?
No matter what kind of integration you want to build to e-conomic, chances are that you need a mechanism for creating invoices. To help you with that, we've created a simple code example that allows you to do the following:
Create invoice
Add invoice lines
Book invoice
Get invoice PDF
Below, you can see what the code looks like (in .NET/C#):
We've also posted this code in the API Forum in case you want to copy it.
Note that this code only works if you have set up customers, products and sales prices. Also, error handling has not been incorporated into this example.
You can see many more code examples in our Developer Toolkit. If you have any coding questions, you can use the API Forum, or contact our API team.
What web hook events would you like us to support?
In the previous edition we introduced web hooks (also see the web hook examples in our Developer Toolkit), and we're now looking to add further supported web hook events.
We've received some requests for events of the type 'customer/product created/changed/deleted', but we'd appreciate more input on which events would be most useful and time-saving to you as developers.
Multiple invoices are sent to a customer who makes a single large payment to cover all invoices. Selected invoices are matched against the customer payment, while the remainder of the payment is returned to the customer.
Can you do this through the e-conomic API?
Correct – of course, you can! Read about how to do this and many other things in the API forum.
Additionally, we recommend that you familiarize yourself with the e-conomic application by taking a free trial, attending an online presentation or searching our e-copedia (online help). Experience tells us that understanding how operations are performed in the web application will make it much easier for you to create similar actions using the API.
As an integration developer, you're trying to make two systems communicate with each other, and knowing how the e-conomic application works will get you a long way towards that goal.
And what you don't know about the e-conomic application, we'll be happy to tell you!