1. Kennisbank
  2. FAQ Voor Developers

Format for agent input Diorama

Format for agent input Diorama

There are multiple ways to get data into Diorama. We can connect directly to your CRM system or an API you already made available (most of our suppliers work with an API / XML format). We have no preference, because we will map all objects internally. We map different flavours of XML or SOAP to this format into our object structure. The most common variant we get is 1 XML file that contains all offices and agents.
Please show us your existing format (XML file) or API and we will check this.
But for other cases, we have got information regarding the fields:
Required:
  • Name
    • The name of this agent/office
  • Phone number
  • Website url
    • If the agent doesn’t have a separate website, use the main
  • Address
    • Country (The country field is a ISO 3166-1 – Alpha-2 code we also accept Alpha-3 codes but we convert these to Alpha-2 codes)
    • Postal code / ZIP code
    • Address line 1
    • Address line 2
    • Province / State
    • City
    • Latitude
    • Longitude
  • Employee / agent
    • Main contact (yes/no)
    • Gender
    • Function
    • Display name
    • First name
    • Last name
    • E-mail
    • Phone number
  • Import (to match with listing data)
    • Agent id
    • Extra agent id
  • Media / Logo
    • URL (Required)
Optional
  • Active – Yes / No
  • Send invite – Yes / No
    • Do we send out the invites
    • Can be off, in case of pilot period or when adding in batches and you don’t want everything to start immediately
  • Group
    • Is this agent part of a group or separate franchise?
  • Facebook
    • Page id
  • Colors
    • Color code 1 (primary)
    • Color code 2 (secondary)
  • Title for public landingpage
  • Text for public landingpage
  • Postal address
    • Country (The country field is a ISO 3166-1 – Alpha-2 code we also accept Alpha-3 codes but we convert these to Alpha-2 codes)
    • Postal code / ZIP code
    • Address line 1
    • Address line 2
    • Province / State
    • City
    • Latitude
    • Longitude
  • Autopost generated slideshow videos to Youtube
    • Yes
    • No
    • Group
    • Agent
Do you have any questions, errors or were you just expecting more? We are always happy to help! Please share your thoughts and questions: service@moving.digital