go-xero

README

#Go Xero

Implements interactions with a Xero private application.

Installation

You need to have Git and Go already installed. Run this in your terminal

go get github.com/arduino/go-xero

Usage

Import it in your Go code:

import (
  "github.com/arduino/go-xero/xero"
  "github.com/arduino/go-xero/xero/invoice"
  "github.com/arduino/go-xero/xero/manual-journal"
  "github.com/arduino/go-xero/xero/payment"
)

Client Creation

To initialize a client you need a private key and a consumer key

keyFile, openFileErr := ioutil.ReadFile("privatekey.pem")
if openFileErr != nil {
  log.Fatal("opening key file ERROR: ", openFileErr)
  return
}

xeroClient, xeroClientErr := xero.NewClient("your_consumer_key", keyFile)
if xeroClientErr != nil {
  log.Fatal("init xero client ERROR: ", xeroClientErr)
  return
}

Get the invoices list

invoices, err := xeroClient.GetAllInvoices()

Create new invoice / invoices

var invoiceToSave invoice.Invoice
// ... invoiceToSave marshal / population
r, newInvoiceErr := xeroClient.NewInvoice([]invoice.Invoice{invoiceToSave})

Create new payment / payments

var paymentToSave payment.Payment
// ... paymentToSave marshal / population
r, newPaymentErr := xeroClient.NewPayment([]payment.Payment{paymentToSave})

Create new journal

var journalToSave manualjournal.Journal
// ... journalToSave marshal / population
r, err := xeroClient.NewManualJournal(journalToSave)