Publicar un aviso
El caso base: una propiedad, un portal. Asumimos que el cliente ya tiene su ficha y su cuenta del portal conectada — si no, empezá por dar de alta un cliente, que se hace una sola vez.
El camino
1 · cargar la propiedad POST /properties → te devuelve el paId
2 · verificar POST /properties/verify gratis, y conviene
3 · publicar PUT …/publication/{portal}
4 · ¿cómo quedó? GET /properties/{paId} gratis · o al portal (cuesta)
5 · actualizar PUT …/publication/{portal} el MISMO llamado del paso 3
6 · dar de baja DELETE …/publication/{portal}
Los pasos 1 y 3 son los obligatorios. El 2 es gratis y te ahorra llamadas; el 4, 5 y 6 son según lo que necesites.
1 · Cargar la propiedad
POST /properties con tu objeto. Te devolvemos un paId:
guardalo, es con lo que vas a hacer todo lo demás.
Mandá tu propio código en el objeto. Es tu ancla: si perdés el paId, lo recuperás del
listado buscando por él.
Las fotos y los planos viajan dentro del mismo objeto, no en llamadas aparte. Una sola llamada con todo. Las descargamos nosotros, así que la respuesta puede decir que todavía están en proceso — eso es normal y no bloquea publicar.
2 · Verificar (gratis, y es la mejor inversión del flujo)
POST /properties/verify te dice, portal por portal, si
ese aviso saldría — y qué falta si no. No le pregunta nada al portal, así que no gasta cupo ni
depende de que el portal esté arriba.
Por qué conviene: un intento rechazado por el portal gasta la llamada igual. Verificar primero es gratis, así que el cálculo es fácil.
Te separa dos cosas, y la distinción importa:
- Lo que falta en el objeto → lo arreglás vos, en lo que mandás.
- Lo que falta de la cuenta (el plan, la sucursal) → sale de la conexión del cliente, no de la propiedad. No hace falta que lo mandes en la verificación.
Usalo también antes de tener la cuenta conectada. El verificador funciona igual y te dice si tu mapeo del objeto está bien, así podés tener tu integración lista antes de que tu cliente autorice.
3 · Publicar
La única decisión del paso: en los portales que tienen planes de publicación, elegís con cuál publicar. Lo podés mandar en la llamada o dejarlo guardado en la configuración de la propiedad — y si mandás los dos, gana el de la llamada, para que puedas cambiar de plan sin reescribir la propiedad.
Si el plan que pediste no está disponible, la respuesta te dice cuáles sí tiene tu cliente. No hace falta consultarlo antes.
4 · Ver cómo quedó — y acá hay dos caminos que no son lo mismo
| Qué te dice | Cuesta | |
|---|---|---|
GET /properties/{paId} | lo que nosotros registramos de esa publicación | gratis |
GET …/publication/{portal} | lo que dice el portal: si está online, su URL, las visitas | 1 llamada |
Leé primero el gratis. Al portal preguntale cuando necesites algo que sólo él sabe —la URL del aviso, las visitas— o cuando sospeches que alguien lo cambió del lado del portal.
⚠️ No consultes el estado en un loop. Con 400 propiedades son 400 llamadas del cupo de tu cliente.
5 · Actualizar
No hay un endpoint de actualizar la publicación: es el mismo PUT del paso 3. Volver a llamarlo
actualiza el aviso en vez de duplicarlo.
Así que el flujo de un cambio de precio es: actualizás la propiedad → publicás de nuevo. Dos llamadas, y la segunda es la que llega al portal.
6 · Dar de baja
DELETE …/publication/{portal} baja el aviso de ese
portal. Es idempotente: si ya no estaba, contesta bien igual, así que no tenés que llevar la
cuenta.
Y ojo con la distinción, que es la que más confunde: bajar el aviso, desconectar la cuenta y borrar el cliente son tres cosas distintas y sólo la primera baja la publicación. Está en dar de baja.
El orden importa: qué pasa si lo hacés al revés
| Si… | Te lo decimos así |
|---|---|
| publicás antes de que el cliente tenga su ficha | el error dice que falta declarar al cliente, y cómo |
| publicás antes de que su cuenta esté conectada | el error dice que falta conectar esa cuenta, con el portal nombrado |
| publicás una propiedad que no cargaste | no la encontramos por ese paId |
Los tres son errores tempranos y con nombre: te dicen qué paso te salteaste, no "algo falló".
Lo que no tenés que hacer
- Mapear zonas. Vos mandás tu zona y nosotros resolvemos la del portal. Si una no está mapeada, el verificador te avisa antes de publicar.
- Llevar la cuenta del cupo. El portal lo informa y te lo pasamos en la respuesta de publicar.
- Consultar los planes antes de cada publicación. Si el que pediste no está, la respuesta te dice cuáles hay.
- Reintentar con otro objeto cuando el portal rechaza. Verificá primero: es gratis y te dice lo mismo sin gastar.
Relacionado
- Buenas prácticas — las cuatro reglas que valen para todos los flujos
- Publicación — los portales y qué cambia en cada uno
- Alta de propiedades · Verificar · Publicar