Dar de alta un cliente
Esto se hace una vez por cliente, y después no se vuelve a tocar. Son dos pasos y una decisión.
1 · declarás su ficha POST /customers → elegís su clientRef
2 · conectás su cuenta ← acá está la bifurcación: depende del portal
3 · (opcional) chequeás GET /customers gratis
1 · La ficha
POST /customers con los datos de la inmobiliaria.
Lo que decidís acá es el clientRef, y es la decisión que más vas a usar: es cómo nos decís de
qué cliente hablás en cada llamada posterior. Elegilo vos — usá el id que ese cliente ya tiene
en tu sistema. No lo generamos nosotros a propósito, justamente para que no tengas que mantener una
tabla de equivalencias.
La ficha incluye los datos de contacto que van a salir publicados en el aviso. No es administrativo: es lo que ve la persona que consulta. Una ficha sin teléfono publica un aviso sin teléfono.
2 · Conectar su cuenta del portal — la bifurcación
Hay dos formas y no las elegís vos: las define el portal.
| Con un enlace | Con la credencial | |
|---|---|---|
| Quién autoriza | tu cliente, abriendo un link | vos, con la credencial que ya conseguiste |
| Vos manejás una credencial de él | no | sí |
| Qué nos mandás | nada: pedís el enlace y se lo pasás | la credencial de su cuenta |
| Portales | Zonaprop | Argenprop · Cabaprop · MercadoLibre |
Por qué existen las dos: algunos portales no emiten ninguna credencial por cuenta — la inmobiliaria entra, acepta, y la autorización queda del lado de ellos. En esos no hay nada que puedas guardar, y por eso el camino es el enlace.
⚠️ No son intercambiables. Si intentás registrar una credencial en un portal que va por enlace, te lo decimos con el portal nombrado y con el link para pedirlo. No es un error tuyo de permisos: es el camino equivocado para ese portal.
La tabla completa de qué portal va por dónde está en Publicación.
3 · Verificar que quedó (gratis)
GET /customers te devuelve la ficha y, al lado, el estado de
sus conexiones. No cuesta nada, así que es la forma barata de confirmar antes de empezar a
publicar.
En los portales que tienen planes de publicación, acá también vienen los planes de tu cliente — y eso es gratis porque los traemos en la misma llamada con la que verificamos que autorizó. No hace falta que los pidas aparte.
Lo que NO hay que hacer en el alta
- Generar un
clientRefnuestro. Lo elegís vos; usá el tuyo. - Pedirle los planes al portal. Ya los tenés del paso 3, gratis y con su fecha.
- Mapear sus zonas. Las resolvemos nosotros; vos mandás la tuya.
- Esperar a tener la cuenta conectada para empezar a integrar. El verificador funciona igual sin conexión, así que podés dejar tu mapeo del objeto listo antes de que tu cliente autorice.
Si tu app conecta un solo cliente
El clientRef ya está fijado del lado nuestro: la ficha es una y no hace falta que nos digas cuál en
cada llamada. Los dos pasos son los mismos.
Relacionado
- Publicar un aviso — el paso siguiente
- Clientes — los cuatro métodos de la ficha
- Consultar y desconectar — y dar de baja, para la diferencia entre desconectar y borrar