Deep links enable an external application to create a link that directs the user to a specific resource within a specific Xero Organisation. They provide a high quality user experience for customers that are using both Xero and a connected app and need to jump between the two applications in order to complete certain tasks or view certain data.
By using the Organisation ShortCode, you can construct a deep link to a resource in Xero that will reference the correct Xero Organisation, for example:
The ShortCode for a Xero Organisation can be retrieved from the Organisation endpoint.
Invoices & Bills have an additional feature that enables a link to be created to an external product or source document.
For integrations that create Invoices & Bills this feature enables a two way linkage between the Xero & 3rd party applications.
<Invoices> <Invoice> <Type>ACCREC</Type> <Contact> <Name>Martin Hudson</Name> </Contact> <Date>2017-07-24T00:00:00</Date> <DueDate>2017-07-31T00:00:00</DueDate> <LineAmountTypes>Exclusive</LineAmountTypes> <Url>https://MyAppPortal.xero/Invoice/XYZ123</Url> <LineItems> <LineItem> <Description>Monthly rental for property at 56a Wilkins Avenue</Description> <Quantity>4.3400</Quantity> <UnitAmount>395.00</UnitAmount> <AccountCode>200</AccountCode> </LineItem> </LineItems> </Invoice> </Invoices>