Kuando / Documentación/Feed XML

Partner API · v1

Feed XML

Envía propiedades desde Convecta u otro sistema que genere un feed XML.

Navegar por la documentación

Endpoint y autenticación

El receptor XML utiliza la misma API key de Partner API y el permiso properties:write.

HTTP
POST https://www.kuando.cl/api/partner/v1/properties/xml
Authorization: Bearer kdo_live_xxxxxxxxxxxxxxxx
Content-Type: application/xml; charset=utf-8

También puedes enviar la key con X-API-Key. Solicítala a contacto@kuando.cl.

Estructura del XML

Se aceptan feeds con raíz listings, properties, inmuebles, propiedades, anuncios o avisos, con campos habituales en español o inglés.

XML
<?xml version="1.0" encoding="UTF-8"?>
<properties>
  <property>
    <external_id>A-1001</external_id>
    <title>Departamento en Providencia</title>
    <purpose>arriendo</purpose>
    <property_type>departamento</property_type>
    <region>Metropolitana</region>
    <commune>Providencia</commune>
    <lat>-33.4372</lat>
    <lng>-70.6506</lng>
    <location_precision>exact</location_precision>
    <price_arriendo currency="CLP">650000</price_arriendo>
    <images>
      <image>https://cdn.ejemplo.cl/A-1001-1.jpg</image>
    </images>
  </property>
</properties>

Usa un identificador estable como external_id. Reenviar el mismo código actualiza la propiedad. El feed también acepta lat y lngjuntos, con location_precision opcional, que usa exactpor defecto. Para aproximar la ubicación envía approximate. Las propiedades ausentes de un feed no se retiran automáticamente.

Feeds de varias corredoras

Si el feed agrupa varias carteras, cada propiedad debe incluir un código estable de corredora, por ejemplo agency_external_id. Registra antes cada corredora con el endpoint de agencias de la guía API REST. Cada corredora mantiene su propia cuenta Kuando con correo y teléfono de acceso. El plan se asigna según el acuerdo comercial de la integración y el cupo se calcula por cuenta, sin compartirlo entre corredoras.

Respuestas y límites

El receptor limita cada solicitud a 5 MB y 1.000 propiedades. Una respuesta HTTP 200 incluyeok, partial, los contadores de filas y un results por identificador.

JSON · respuesta resumida
{
  "ok": true,
  "partial": false,
  "pausedByPlanLimit": 0,
  "format": "xml",
  "provider": "convecta",
  "root": "properties",
  "total": 1,
  "created": 1,
  "updated": 0,
  "failed": 0,
  "results": [
    { "external_id": "A-1001", "status": "created", "propertyStatus": "active" }
  ]
}
HTTPMotivo
400El envío supera el máximo de 1.000 propiedades.
401La API key falta o no es válida.
403La key no tiene el permiso properties:write.
413El XML supera el máximo de 5 MB.
422El XML está mal formado o no contiene publicaciones reconocibles.
429Se alcanzó el límite de solicitudes por IP.

Las filas inválidas se detallan en results. Corrige y reenvía las filas fallidas usando el mismo identificador externo.

¿Necesitas coordinar tu integración?

Cuéntanos qué sistema usas y qué método quieres conectar.

Escribir a Kuando
Volver al contenido