This started as a fork of the now archived
gooffice. It has since moved namespaces. And is now maintained by Planetary Quantum GmbH.
go get github.com/hostwithquantum/golexofficeimport(
"github.com/hostwithquantum/golexoffice"
)
func main() {
// initialize the client, http.Client is optional but allows you to set timeouts, etc.
client := golexoffice.NewConfig("token", &http.Client{})
}The following samples assumes you have the client setup.
To get all contacts you can perform the following function.
// Get all contacts
contacts, err := client.Contacts()
if err != nil {
fmt.Println(err)
} else {
fmt.Println(contacts)
}If you want to read out a specific contact, you can do this via the id (UUID).
// Get a contact by id
contact, err := client.Contact("b324c2be-b745-4128-9ecd-e262a0a761cd")
if err != nil {
fmt.Println(err)
} else {
fmt.Println(contact)
}To create a new contact, lexoffice needs some data. These must be entered in a structure.
// Define body
body := golexoffice.ContactBody{
"",
0,
golexoffice.ContactBodyRoles{
&golexoffice.ContactBodyCustomer{},
&golexoffice.ContactBodyVendor{},
},
&golexoffice.ContactBodyCompany{
"J&J Ideenschmiede GmbH",
"12345/12345",
"DE123456789",
true,
[]golexoffice.ContactBodyContactPersons{{
"Herr",
"Jonas",
"Kwiedor",
"[email protected]",
"04152 8903730",
}},
},
golexoffice.ContactBodyAddresses{
[]&golexoffice.ContactBodyBilling{{
"Rechnungsadressenzusatz",
"Fährstraße 31",
"21502",
"Geesthacht",
"DE",
}},
[]&golexoffice.ContactBodyShipping{{
"Lieferadressenzusatz",
"Fährstraße 31",
"21502",
"Geesthacht",
"DE",
}},
},
golexoffice.ContactBodyEmailAddresses{
[]string{"[email protected]"},
[]string{"[email protected]"},
[]string{"[email protected]"},
[]string{"[email protected]"},
},
golexoffice.ContactBodyPhoneNumbers{
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
},
"Testnotiz",
}
// Create a new contact
contactReturn, err := client.AddContact(body)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(contactReturn)
}If you want to update a contact, then some information is very important. You need the ID of the contact & the version.
// Define body
body := golexoffice.ContactBody{
"ID",
1,
golexoffice.ContactBodyRoles{
&golexoffice.ContactBodyCustomer{},
&golexoffice.ContactBodyVendor{},
},
golexoffice.ContactBodyCompany{
"J&J Ideenschmiede GmbH",
"12345/12345",
"DE123456789",
true,
[]&golexoffice.ContactBodyContactPersons{{
"Herr",
"Jonas",
"Kwiedor",
"[email protected]",
"012345678999",
}},
},
golexoffice.ContactBodyAddresses{
[]&golexoffice.ContactBodyBilling{{
"Rechnungsadressenzusatz",
"Fährstraße 31",
"21502",
"Geesthacht",
"DE",
}},
[]&golexoffice.ContactBodyShipping{{
"Lieferadressenzusatz",
"Fährstraße 31",
"21502",
"Geesthacht",
"DE",
}},
},
golexoffice.ContactBodyEmailAddresses{
[]string{"[email protected]"},
[]string{"[email protected]"},
[]string{"[email protected]"},
[]string{"[email protected]"},
},
golexoffice.ContactBodyPhoneNumbers{
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
[]string{"04152 8903730"},
},
"Testnotiz",
false,
}
// Update the contact
contactReturn, err := client.UpdateContact(body)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(contactReturn)
}If you want to read out a specific invoice, you can do this via the id (UUID).
// Invoice is to get a invoice by id
invoice, err := client.Invoice("0cf8142b-6f54-4c96-9766-6f44a9a4814b")
if err != nil {
fmt.Println(err)
} else {
fmt.Println(invoice)
}In order to create a new invoice, the data must be sent in a certain format. This works as follows.
If you can assign an invoice to an existing customer, then in the struct InvoiceBodyAddress{} please specify only the Id and leave the rest empty.
For more information, please refer to the documentation.
// Define body
body := golexoffice.InvoiceBody{
"",
"",
"",
"",
1,
false,
"",
"",
"2021-07-20T00:00:00.000+01:00",
"",
golexoffice.InvoiceBodyAddress{
"",
"Test Company",
"",
"Teststreet 12",
"Geesthacht",
"21502",
"DE",
},
[]golexoffice.InvoiceBodyLineItems{{
"",
"custom",
"Testarticle",
"Very nice article!",
1,
"Stück",
golexoffice.InvoiceBodyUnitPrice{
"EUR",
13.4,
15.59,
19,
},
0,
13.4,
}},
golexoffice.InvoiceBodyTotalPrice{
"EUR",
13.4,
15.95,
nil,
2.55,
nil,
nil,
},
[]golexoffice.InvoiceBodyTaxAmounts{{
19,
2.55,
15.95,
}},
golexoffice.InvoiceBodyTaxConditions{
"net",
nil,
},
&golexoffice.InvoiceBodyPaymentConditions{
"Please pay within the next 30 days.",
30,
golexoffice.InvoiceBodyPaymentDiscountConditions{
0,
0,
},
},
golexoffice.InvoiceBodyShippingConditions{
"2021-07-20T00:00:00.000+01:00",
nil,
"none",
},
"Invoice",
"We hereby invoice you for the items you have ordered",
"Thank you for your purchase",
}
// Create new contact
invoice, err := client.AddInvoice(body)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(invoice)
}Here you will find a function with which you can upload a file to lexoffice. You only need the path to the file and the lexoffice token.
For more information, please refer to the documentation.
// Open file
file, err := os.Open("/Users/jonaskwiedor/Downloads/Rechnung 201912101300005.pdf")
if err != nil {
fmt.Println(err)
}
// upload the file to LexOffice
files, err := client.AddFile(file, "Rechnung 201912101300005.pdf")
if err != nil {
fmt.Println(err)
} else {
fmt.Println(files)
}