POST /properties/verify

Mandás el objeto de una propiedad y te contestamos tres cosas:

1. Si el objeto es válido según el contrato de Mapaprop, y qué le falta si no lo es.
2. Qué entendimos de lo que mandaste — cuántos campos reconstruimos de tu arreglo attributes.
3. Si cada portal lo podría publicar, y cuando no, exactamente qué le falta y de quién es el problema.

Para qué sirve

Integrarse a varios portales tiene un problema que aparece tarde: mandás un objeto que te parece completo, se publica, y recién ahí ves que el aviso salió sin precio, sin pileta o con el tipo equivocado — porque cada portal pide cosas distintas y se calla lo que no entiende.

Este endpoint te deja ver eso antes de publicar, sin crear nada y sin necesidad de tener las cuentas de los portales conectadas.

Resource URL

https://property-api.mapaprop.com/property-v1/properties/verify

Autenticación

Se pide un token OAuth2 y el scope property-api-verify.

POST /property-v1/properties/verify
Host: property-api.mapaprop.com
Content-Type: application/json
Authorization: Bearer {access_token}

El token se obtiene como cualquier otro: POST /api/action/oauth2-v1/authorize.

El cuerpo de la petición

{
  "canonical": { …el objeto de la propiedad… },
  "portals": ["argenprop", "zonaprop", "cabaprop"]
}

El objeto que va en canonical es el mismo de siempre: El objeto JSON de la propiedad.

Si mandás un portal que no existe, la petición falla con un 400 en vez de ignorarlo en silencio.

Qué portales te reporta

La idea es que no te lleguen problemas de un portal que no configuraste. Si ya declaraste Argenprop y nada más, Zonaprop no aparece en la respuesta ni cuenta en el summary.

Y si todavía no configuraste ninguno, los ves todos: es el caso de quien está evaluando la integración y quiere ver cómo se convierte su objeto en cada portal antes de decidir.

publication — la configuración de publicación, dentro del objeto

Dentro de canonical podés mandar una clave publication con lo que cada portal necesita de tu cuenta y de tus elecciones de publicación. No es un campo de la propiedad: es cómo la publicás.

{
  "publication": {
    "api": {
      "argenprop": { "advertiserId": 99999, "visible": true },
      "zonaprop": {
        "plan": { "plan": "SUPERDESTACADO" },
        "branch": { "custId": 1, "email": "contacto@ejemplo.com", "name": "Inmobiliaria", "phone1": "1144445555" }
      },
      "cabaprop": { "branchOfficeId": 42 }
    }
  }
}

Cada portal acepta además un token (string), que se valida de forma y nunca de validez: este endpoint no verifica cuentas. Su valor no aparece en ninguna parte de la respuesta.

publication no viaja a los portales como un campo más: se consume acá y se descarta.

La referencia completa —los dos niveles, qué pasa si mandás algo que no corresponde, y el detalle del token— está en su propia página: La clave publication.

La respuesta

{
  "mode": "client",
  "keyUsed": "canonical",
  "object": {
    "valid": true,
    "contract": [],
    "mapapropZone": "1-2-189-973",
    "conflicts": [],
    "rebuiltFromAttributes": {
      "fields": 22,
      "amenities": 36
    },
    "unresolved": []
  },
  "portals": {
    "argenprop": {
      "status": "fields_complete",
      "requiredFieldsComplete": true,
      "connection": "not_verified",
      "zone": {
        "sent": {
          "code": "1-2-189-973",
          "level": 3
        },
        "publishingTo": "Mar del Plata",
        "status": "mapped"
      },
      "blockers": [],
      "pendingAtPublishTime": [],
      "completeness": {
        "percentage": 100,
        "informed": 3,
        "supportedByThisType": 3
      }
    },
    "zonaprop": {
      "status": "fields_complete",
      "requiredFieldsComplete": true,
      "connection": "not_verified",
      "zone": {
        "sent": {
          "code": "1-2-189-973",
          "level": 3
        },
        "publishingTo": "General Pueyrredón",
        "status": "mapped"
      },
      "blockers": [],
      "pendingAtPublishTime": []
    },
    "cabaprop": {
      "status": "fields_complete",
      "requiredFieldsComplete": true,
      "connection": "not_verified",
      "zone": {
        "sent": {
          "code": "1-2-189-973",
          "level": 3
        },
        "status": "not_mapped",
        "message": "Todavía no tenemos mapeada esta zona para cabaprop. Escribinos con el código de zona y la publicamos: el mapeo queda hecho para siempre."
      },
      "blockers": [],
      "pendingAtPublishTime": []
    },
    "mercadolibre": {
      "status": "coming_soon",
      "message": "MercadoLibre: disponible pronto. La integración todavía no está habilitada en este endpoint.",
      "requiredFieldsComplete": false
    }
  },
  "summary": {
    "complete": 3,
    "of": 4
  }
}

object — qué pasó con tu objeto

conflicts merece atención: si mandás "type": 23 y tu attributes dice "Departamento", se publica como Departamento. No es un error, es la regla — pero si no era lo que querías, lo ves acá en vez de en el aviso.

portals — qué dice cada portal

Valores de status:

Cada blocker trae:

{ "field": "price",
  "kind": "missing",
  "message": "`price` es obligatorio en el objeto de Mapaprop y no vino…",
  "youCanFixIt": true }

youCanFixIt contesta la única pregunta que importa de un blocker: ¿esto lo arreglo yo mandando más datos, o es una limitación del portal? Si es true, mandá el dato. Si es false, ese portal no admite lo que le estás pidiendo y no hay JSON que lo resuelva.

zone — en qué zona vamos a publicar

Cada portal tiene su propio mapa de zonas, y nosotros mantenemos la traducción entre tu zona de Mapaprop y la de ese portal. zone te muestra las dos puntas:

{ "sent": { "code": "1-2-189-973", "level": 3 },
  "publishingTo": "Mar del Plata",
  "status": "mapped" }

Los estados:

summary

{ "summary": { "complete": 3, "of": 4 } }

Cuántos portales tienen los obligatorios completos, sobre el total evaluado.

Los campos obligatorios de Mapaprop mandan sobre los del portal

Esto es lo más importante de entender del endpoint.

Mapaprop tiene su propio contrato de campos obligatorios, y no depende de lo que pida cada portal. Si falta uno de esos campos, ningún portal queda en fields_complete — aunque ese portal en particular no lo exija.

Ejemplo: Argenprop no exige el precio para armar su payload. Igual, si no mandás price:

{
  "object": {
    "valid": false,
    "contract": [ { "field": "price", "rule": "required", "detail": "" } ]
  },
  "portals": {
    "argenprop": {
      "status": "missing_data",
      "requiredFieldsComplete": false,
      "blockers": [
        { "field": "price",
          "kind": "missing",
          "message": "`price` es obligatorio en el objeto de Mapaprop y no vino. Sin él no se publica en ningún portal, lo exija o no este portal en particular.",
          "youCanFixIt": true }
      ]
    }
  },
  "summary": { "complete": 0, "of": 4 }
}

La lista completa de campos obligatorios está en El objeto JSON de la propiedad.

No hace falta tener el portal conectado

El campo connection te dice si la cuenta de ese portal está conectada, pero no condiciona nada: el objeto se mapea igual y los blockers se calculan igual.

Es un dato al costado, y sigue importando: un objeto impecable no se publica si la cuenta no está conectada. Pero para perfeccionar tu objeto no necesitás tener ninguna.

Errores

{ "error": "Portales desconocidos: idealista. Válidos: argenprop, zonaprop, cabaprop, mercadolibre, mapaprop" }

MercadoLibre

Sale siempre como coming_soon. La integración existe pero todavía no está habilitada en este endpoint, y preferimos no mostrarte un mapeo sin verificar: lo tomarías por bueno.

Cómo usarlo

1. Mandá tu objeto tal como lo tenés hoy.
2. Mirá primero object.valid y object.contract. Si hay un obligatorio faltando, arreglá eso — va a estar bloqueando todos los portales a la vez.
3. Mirá object.conflicts. Si aparece algo, tu attributes y tus campos sueltos se están contradiciendo, y gana attributes.
4. Portal por portal, resolvé los blockers con youCanFixIt: true.
5. Los youCanFixIt: false no los podés resolver: son límites del portal.
6. Repetí. No se crea nada, así que probá tantas veces como necesites.