Fetch invoices

Step-by-step guide to fetch invoices from multiple accounting systems using a single Unified API.

Fetch invoices from other systems in 5 steps

1. Authorize access

   Your user must first authorize your application to access their accounting platform (e.g., Xero, Lexware Office, Sevdesk) via an authorization flow (e.g., OAuth, API key) through maesn Connect.

2. Retrieve filtered list of invoices

   Start by retrieving a list of invoices by calling GET /invoices and applying the appropriate filters, for example lastModifiedAt which is universally supported or dueDate, status or paymentStatus where available, to give your users an overview of their invoices.

3. Show invoice details

   When the end user has selected a specific invoice, present all the details including line items by calling GET /invoices/{id}.

4. Retrieve the invoice document (optional)

   Present original PDF documents by calling GET /invoices/{id}/document.

5. Retrieve captured invoices (optional)

   In addition, to invoices originally created in the respective accounting platforms, invoices created elsewhere and subsequently uploaded to the accounting platform can be retreived through

   • GET /bookingProposals
   • GET /bookingProposals/{id}
   • GET /bookingProposals/{id}/document.

You can utilize Webhooks to make this process more efficient.