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.
POST https://www.kuando.cl/api/partner/v1/properties/xml
Authorization: Bearer kdo_live_xxxxxxxxxxxxxxxx
Content-Type: application/xml; charset=utf-8Tambié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 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.
{
"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" }
]
}| HTTP | Motivo |
|---|---|
| 400 | El envío supera el máximo de 1.000 propiedades. |
| 401 | La API key falta o no es válida. |
| 403 | La key no tiene el permiso properties:write. |
| 413 | El XML supera el máximo de 5 MB. |
| 422 | El XML está mal formado o no contiene publicaciones reconocibles. |
| 429 | Se 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.