Create your own tabs in e-conomic

June 9, 2011
Dear e-conomic developer,

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:
Tradeshift

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#):
Invoice code

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.
Web hooks

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.

So if you have any suggestions, please let us know by replying to our post on the subject in the API Forum.
Ideas

Matching invoices and payments

Imagine this scenario:

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.

Getting Started

If you're new to the world of API and integrations, we suggest you take a look at our page on the basics of integrations, browse through some of the benefits of integrations and check out some of our existing integrations.

For info about the API, you can take a look at the Developer Toolkit, the API Documentation or visit the API Forum where you can find news about the API, ask questions and request or offer resources for developing integrations.

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!