Kato

We support two Kato formats, Kato API and Kato XML. If you are unsure which one to use, please contact Kato who will be able to clarify which is applicable for you.

Setting up an import from Kato using API

When creating a property import from Kato using API you'll be presented with the following fields:

API Environment - There are two options here; 'Sandbox' or 'Production'. Ask Kato which option is applicable for you.

Client ID - You will need to obtain your Client ID from Kato.

Client Secret - You will need to obtain your Client Secret from Kato.

Setting up an import from Kato using XML

When creating a property import from Kato using XML you'll be presented with the following fields:

XML URL - You will need to obtain your XML URL directly from Kato.

Troubleshooting

My statuses are coming in wrong

Kato send the status of available properties as 'Available', not 'For Sale' or 'To Let'. When you map the statuses in the import settings you can only map this 'Available' to either 'For Sale' or 'To Let':

The same applies for 'Coming Soon'.

To get around this you have one of two options:

1) Setup a status under 'Property Hive > Settings > Custom Fields > Availabilities' also called 'Available' that covers both sales and lettings commercial properties.

2) If you'd prefer to keep two separate statuses you can map 'Available' to 'For Sale' in the import settings:

... and then use a snippet like so to correct the status for lettings properties;

add_action( "propertyhive_property_imported_agentsinsight_xml", 'correct_kato_status', 10, 2 );
function correct_kato_status( $post_id, $property )
{
    wp_suspend_cache_invalidation( true );
    wp_defer_term_counting( true );
    wp_defer_comment_counting( true );
    
    if ( isset($property->rent) && (string)$property->rent != '' )
	{
        // this a lettings property, set the status accordingly
        if ( 
                (string)$property->status == 'Available' || 
                (string)$property->status == 'Coming Soon' )
        {
            // XX  To Let. Change accordingly on your site
            // You can find this under:
            // 'Property Hive > Settings > Custom Fields > Availabilities'
            wp_set_post_terms( $post_id, XX, 'availability' ); 
        }
    }
    
    wp_suspend_cache_invalidation( false );
    wp_defer_term_counting( false );
    wp_defer_comment_counting( false );
}

// ensure all these custom status changes aren't logged as notes as this would build up over time
add_filter( 'propertyhive_add_property_availability_change_note', 'disable_availability_history_logging' );
function disable_availability_history_logging( $disabled )
{
    return false;
}