Call us: +358 9 8561 9420
 

NoAPI - Norfello API tool

Kanzen:noapi aku$ ./noapi.py help postita Use postita.fi services. Usage: noapi.py postita <command> <arguments> [options] To use postita.fi services, you need to provide your login credentials to NoAPI with the options username and password. Postita.fi supports these commands: send <jobname> <filename> --username <user> --password <pass> Sends the PDF file from path <filename> to postita.fi, which will create a new job with the name <jobname> for this file. The argument <jobname> has to be enclosed within quote marks if it contains any whitespace. send_finvoice <jobname> <filename> --username <user> --password <pass> Sends the Finvoice XML file from path <filename> to postita.fi, which will create a new job with the name <jobname> for this file. The argument <jobname> has to be enclosed within quote marks if it contains any whitespace. The XML file can contain multiple invoices. delete <job_id> --username <user> --password <pass> Cancel the job with <job_id>. This is only possible if the job has not yet been processed or sent. job_info <job_id> --username <user> --password <pass> Get the status of the job with <job_id>. job_list [send_mindate] --username <user> --password <pass> Get a list of jobs in the queue. There is an optional argument [send_mindate] in the format DD.MM.YYYY that will skip all jobs that were created before that date. job_pdf <job_id> <filename> --username <user> --password <pass> Get the PDF file from the job associated with <job_id>. The file will be saved to path <filename>. account_info --username <user> --password <pass> Query the status of your user account. You can get output in JSON format with option --json.

What is it?

NoAPI is a tool for using the APIs of Norfello's various services. It unites these APIs under a single easy-to-use command line interface tool. With NoAPI it is easy to automatically send electronic invoices and mail through postita.fi and query information of Finnish companies through BizSearch.

Currently NoAPI supports two of our services: BizSearch and Postita.

A short description of these services:

    - BizSearch is used for searching information of companies that use e-invoices.

    - Postita enables you to send electronic invoices and mail from your computer.

Examples:

  • noapi.py bizsearch Norfello searches information about company called "Norfello".
  • noapi.py postita send "A letter" letter.pdf --username user --password secret sends a letter from your computer to the postita.fi service.

How can I get it?

Simple, download it from here:

In order to use it, you need to install Python on your computer.  If you're using either Mac OS X or Linux, you most likely already have it. Try typing 'python' to your command line interface. If you don't have Python yet, see http://python.org/ for installation instructions.