Xero API: Send Multiple Invoices

: Joel Lipman; Xero; 15 August 2021; Hits: 1853

What?
A really quick article for anyone who got stumped by the same issue: How to send multiple invoices to Xero in one API call?

Why?
Our use-case is in Zoho Deluge which couldn't generate more than 5 invoices in a scheduled task because Xero only allows 5 concurrent connections at one time... And Zoho was trying to send about 7 at a time (as in schedule created 7 Zoho invoices but only 5 Xero invoices). Our solution: Send all Zoho invoices in API call to Xero... apparently it can accept up to 60 invoices in one call.

How?
Crazy simple solution, your JSON needs to have the key "Invoices" and the list of invoices to create:

copy raw

{"Invoices":[... list of invoices ...]}

{"Invoices":[... list of invoices ...]}

If sending just the 1:

copy raw

{... invoice JSON ...}

{... invoice JSON ...}

But if sending multiple invoices, you need the key "Invoices" so your JSON request would be something like:

copy raw

{
  "Invoices": [
    {
      "Type": "ACCREC",
      "Contact": {
        "ContactID": "abcdef01-2345-6789-abcd-ef012345678"
      },
      "Reference": "TEST Invoice (DO NOT ACTION) 1",
      "DueDate": "2021-09-13",
      "Date": "2021-08-13",
      "LineItems": [
        {
          "Description": "My expensive product #1",
          "Quantity": 1,
          "UnitAmount": 240,
          "TaxType": "OUTPUT2",
          "TaxAmount": 48,
          "AccountCode": 3610,
          "DiscountAmount": 24,
          "Tracking": [
            {
              "Name": "Activity",
              "Option": "ELEPHANT"
            }
          ]
        }
      ]
    },
    {
      "Type": "ACCREC",
      "Contact": {
        "ContactID": "abcdef01-2345-6789-abcd-ef012345678"
      },
      "Reference": "TEST Invoice (DO NOT ACTION) 2",
      "DueDate": "2021-09-13",
      "Date": "2021-08-13",
      "LineItems": [
        {
          "Description": "My not so expensive product",
          "Quantity": 1,
          "UnitAmount": 20,
          "TaxType": "OUTPUT2",
          "TaxAmount": 0,
          "AccountCode": 3610,
          "DiscountAmount": 12,
          "Tracking": [
            {
              "Name": "Activity",
              "Option": "RHINO"
            }
          ]
        }
      ]
    }
  ]
}