How can we help? How can we help?
  1. Box+Dice Help Centre
  2. Integrations
  3. Portals

Understand the enterprise importer for REA XML feeds

MRI Box and Dice MRI Box and Dice

Summary

Learn how the Box+Dice Enterprise Importer receives and processes REA XML feeds from third-party systems.

This article covers:

Overview

The Enterprise Importer allows third-party systems to send property listing data to Box+Dice using the REA XML format.

These XML feeds are processed by the importer and listing data is added to the Box+Dice agent database. If the agency uses a GRAB website, the imported listings may also appear on the website.

To ensure listings import correctly, the XML file must follow REA XML standards and include the required identifiers used by Box+Dice to match listings with the correct office and consultant.

Send an REA XML Feed via FTP

To submit listing data, upload your REA-compliant XML file to the Box+Dice FTP server.

FTP details
  • Server: ftp.boxdice.com.au
  • Username: ftp_username
  • Password: ftp_password
  • Upload folder: /upload
  • Mode: Passive
Note: Contact CS.BoxDice@mrisoftware.com if you do not have FTP credentials.

To upload XML file:

  • Generate your listing feed in REA XML format
  • Connect to the Box+Dice FTP server
  • Log in using your FTP credentials
  • Upload the XML file to the /upload folder

The file will be processed shortly after it is uploaded.

Required identifiers and import behaviour

To ensure listings import correctly, include the following identifiers in your XML feed.

Office identifier

REAXML Tags

If the client database has more than one Office, ensure you include the B+D tag: 

ABC123

Box+Dice Support will provide this ID if you do not request us to use one you prefer instead.
If this tag is omitted the import may fail, or load the listing to the wrong office.
The property address is used in conjunction with this, or a fallback if not provided.

You may also include a unique listing identifier:

xyz_123456

This tag will allow the specific listing to be targeted and updated, even if the address is changed.

Consultant matching

When the XML file is processed, Box+Dice attempts to match the listing to an existing consultant using:

  • Consultant name
  • Mobile number
  • Email address

If a match is found, the listing will be imported to the correct consultant and office.

Important: If the consultant cannot be matched, the import will fail.

A notification email will be sent to Consultant #1 listed in the XML if:

  • the XML file is invalid, or
  • the import fail

Add images to the listing feed

Images can be included in two ways.

Option 1: Reference images via URL

Images can be referenced directly in the XML file using a public image URL.

Option 2: Upload images with a ZIP file

Images can also be uploaded alongside the XML file as a ZIP archive.

Example structure:

my_xml_file_name.zip should contain:

  • my_xml_file_name.xml
  • main_photo.jpg
  • second_photo.jpg
  • floor_plan.gif
Tip: Ensure the XML file name matches the ZIP file name.

Articles in this section