The Landnow Integration Guide provides steps to integrate Landnow with external systems. It includes definitions, architecture, workflow, data mapping, and use of platform apps like Salesforce Connect and Runway. The guide clearly defines hold and sale and provides a visual representation of how Landnow interacts with external systems. It covers the entire process from initial request to confirmation, and a sequence diagram explains how real-time incoming and outgoing updates are processed. The data mapping section provides a table detailing the fields in the lot data and lot status.
Developer Mapping Guide - How do we map LandNow data to your Inventory Data?
Hold
Holds can be placed on Lots in the Landnow marketplace to indicate a Lot has been reserved for a period of agreed time by the a Builder rep on behalf of a customer or exclusively for the Builder. A Hold Request is made by the Builder Rep, which is sent to the Developer Sales Consultant for approval. If approved the Lot is marked as “On Hold” and cannot be purchased other than by the Builder Rep who held the Lot. If the time period of the hold lapses without a sale, the hold on the lot is removed, and any Builder Rep can purchase or hold the lot.
Sales Order
A Sales Order, also known as a Sale, is the purchase of a Lot by a customer facilitated by the Builder Representative. Once a lot is sold, it is marked as "Sold" and can no longer be held or purchased by any other user. A Sales Order includes customer details, such as the buyer's name and contact information.
Platform App
Platform apps are an essential tool that companies use to securely authenticate and authorise users into platforms such as Salesforce, Runway, Hubspot, Microsoft Dynamics, and many others. These apps provide a seamless integration between the platform and external systems, effectively streamlining the entire process. By using platform apps, businesses can operate more efficiently, reduce the risk of security breaches, and improve their overall performance.
At Landnow, we recognise the immense value that platform apps bring to our business and our customers. By using platform apps, we can stay ahead of the curve and provide our clients with a seamless, hassle-free integration experience.
To enable real-time capabilities of the Landnow marketplace, the developer will send real-time lot data to Landnow. In turn, Landnow will ensure that inventory held or sold is reflected in real-time in the developer's system. This is a 2-way synchronisation.
graph LR
style Developer fill:#c1e1f9,stroke:#4192d9,stroke-width:3px,rounded:10px
style Landnow fill:#c1f9d5,stroke:#39f48d,stroke-width:3px,rounded:10px
Landnow(Landnow) --> |Lot Status| Developer(Developer)
Developer -->|Lot| Landnow
Setting up the integration is simple with Landnow. Once data mappings have been defined for the integration, Landnow manages the process to make it easy. To set up Landnow as an OAuth2 app on your platform of choice (e.g. Salesforce, Hubspot, etc.), simply log in to your Landnow account and click the "Connect" button.
graph TD
style Intro stroke:#000,stroke-width:4px,fill:#87CEEB,color:#000,font-size:16px
style TechSpec stroke:#000,stroke-width:4px,fill:#FFDAB9,color:#000,font-size:16px
style BuildIntegration stroke:#000,stroke-width:4px,fill:#FFDAB9,color:#000,font-size:16px
style SandboxTest stroke:#000,stroke-width:4px,fill:#F0E68C,color:#000,font-size:16px
style OAuth2Flow stroke:#000,stroke-width:4px,fill:#F0E68C,color:#000,font-size:16px
style LinkProject stroke:#000,stroke-width:4px,fill:#F0E68C,color:#000,font-size:16px
style TriggerSync stroke:#000,stroke-width:4px,fill:#F0E68C,color:#000,font-size:16px
Intro("Introduction & Onboarding Overview") --> TechSpec("Fill out Tech Spec for Data Mappings")
TechSpec --> BuildIntegration("Landnow Builds Integration Logic")
BuildIntegration --> SandboxTest("Sandbox Test Session")
SandboxTest -- "Issues found" --> TechSpec
subgraph "Testing"
SandboxTest --> OAuth2Flow("Connect Landnow via OAuth2")
OAuth2Flow --> LinkProject("Link a Project")
LinkProject --> TriggerSync("Trigger a Project Sync")
end
Details:
Introduction & Onboarding Overview (Intro):
This is the initial stage where the customer is introduced to the onboarding process. It sets the stage for the entire process and outlines what to expect.
Fill out Tech Spec for Data Mappings (TechSpec):
In this step, the customer fills out the technical specifications. This is a crucial step as it focuses on data mappings which are required for the integration process.
Landnow Builds Integration Logic (BuildIntegration):
Based on the technical specifications provided by the customer, Landnow builds the integration logic. This is a technical step handled by Landnow to ensure the customer's system can integrate smoothly with Landnow.