Mapaprop
DEVELOPING

Cupo mensual y límites

Zonaprop limita la cantidad de llamadas que se pueden hacer por inmobiliaria. El límite es del portal, no nuestro, y lo acuerda cada inmobiliaria con ellos.

Cupo habitual1500 llamadas por mes
Se cuenta porcada inmobiliaria, no por tu aplicación
Se renuevael día 1 a las 00:00 (hora de Argentina), de golpe
Sobranteno se acumula — lo que no usaste se pierde

Que sea por inmobiliaria tiene una consecuencia práctica: el consumo de un cliente no afecta a los otros, y si uno se queda sin cupo, sólo se le frenan sus operaciones.

Qué consume cupo y qué no

Esto es lo que más conviene tener claro, porque no es evidente:

Operación¿Consume?
Conectar la cuenta (cuando tu cliente autoriza)sí, 1
Desconectar la cuentasí, 1
Publicar, actualizar o dar de baja un avisosí
Consultar el estado de la conexión (GET /connections)no
Pedir un enlace de conexiónno

Las dos últimas leen nuestro registro, no el del portal.

Los errores también consumen cupo. Una llamada que falla por datos inválidos se descuenta igual que una exitosa. Reintentar en bucle una operación que viene fallando gasta el cupo del mes de tu cliente sin conseguir nada.

Cuánto le queda

Te lo devolvemos en la conexión, sin que tengas que preguntarle al portal:

curl https://property-api.mapaprop.com/connections/zonapropapi \
  -H "Authorization: Bearer <TU_TOKEN>" \
  -H "x-client-ref: cliente-42"

{
  "connection": {
    "portal": "zonapropapi",
    "status": "active",
    "appMeta": {
      "quotaRemaining": 1494,
      "quotaLimit": 1500,
      "quotaReadAt": "2026-10-01T20:44:40.323Z"
    }
  }
}

quotaRemaining es el último valor que nos informó el portal, no una consulta en vivo. Por eso va con quotaReadAt: miralo para saber de cuándo es. Si tu cliente operó por otro medio desde entonces, el número real puede ser menor.

Consultarlo no consume cupo justamente porque no le preguntamos al portal.

Planes de publicación

Zonaprop también limita cuántos avisos puede tener publicados cada inmobiliaria, según los planes que haya contratado. Eso es independiente del cupo de llamadas.

"plans": [
  { "plan": "Destacado", "planTotal": 50, "planAvailable": 12 }
]

Te lo devolvemos en la misma respuesta. Igual que el cupo, es el último valor conocido: si tu cliente publica desde el panel de Zonaprop, baja sin que nos enteremos.

Una cuenta sin planes se conecta igual. plans: [] significa que Zonaprop todavía no le asignó ninguno — la conexión es válida, pero no va a poder publicar hasta que los contrate con el portal. Es algo que resuelve tu cliente directamente con ellos.

Desconectar

DELETE /connections/zonapropapi hace dos cosas: deja de reconocer la conexión de nuestro lado y le avisa al portal que ya no operamos en nombre de esa inmobiliaria.

Las dos hacen falta. En Zonaprop no existe una credencial por cuenta que podamos borrar, así que si sólo lo anotáramos de nuestro lado, el portal nos seguiría reconociendo.

La respuesta te dice cómo salió:

{ "status": "revoked", "remoteUnlink": "ok", "externalListingsUntouched": true }
  • remoteUnlink: "ok" — desvinculado también en el portal.
  • remoteUnlink: "pending" — tu cliente ya está desconectado de nuestro lado, pero el portal no respondió. Volvé a llamar más tarde.

Desconectar no da de baja los avisos. Los avisos publicados en Zonaprop son de tu cliente y siguen online. Si quiere bajarlos, tiene que hacerlo antes de desconectar, o directamente desde el portal.

Relacionado