El objeto JSON de la propiedad

Esta es la referencia de lo que vos mandás: qué campos tiene el objeto propiedad, cuáles son obligatorios, qué valores acepta cada uno y cómo se dice "este dato no lo tengo".

Es una referencia del objeto, no de un endpoint. Para entender cómo se identifica una propiedad —por qué el tipo y la operación son claves estables y de dónde salen sus valores— leé primero El modelo de propiedad.

El objeto que mandás

Éste es el objeto completo. Abajo está qué es obligatorio, qué es opcional y qué valores acepta cada campo.

{
  "code": "DEV-V3-909181",
  "type": 6,
  "operation": 2,
  "title": "Hermoso departamento luminoso con excelente ubicación y amenities completos",
  "address": "Av. Santa Fe 4271",
  "mapLatitude": -34.5828,
  "mapLongitude": -58.4206,
  "zone0": 1,
  "zone1": 2,
  "zone2": 189,
  "description": "Excelente propiedad ubicada en zona premium con fácil acceso a transporte público, comercios y servicios. Ideal para vivir o invertir.\n\nCuenta con todos los servicios y amenities modernos. Perfecta para familias o inversión.\n\nUbicación estratégica con fácil acceso a centros comerciales, escuelas y transporte público.",
  "descriptionFormatted": "Excelente propiedad ubicada en zona premium con fácil acceso a transporte público, comercios y servicios. Ideal para vivir o invertir.\n\nCuenta con todos los servicios y amenities modernos. Perfecta para familias o inversión.\n\nUbicación estratégica con fácil acceso a centros comerciales, escuelas y transporte público.",
  "zipcode": "1684",
  "betweenStreets": "Entre Av. Pueyrredón y Av. Coronel Díaz",
  "urlWebExternal": "https://ejemplo-inmobiliaria.com/propiedad-dev",
  "conditions": "Contado",
  "yearsOld": 16,
  "totalFloors": 16,
  "apartmentsPerFloor": 3,
  "floors": 2,
  "buildingArea": 126,
  "landArea": 189,
  "ambiences": 2,
  "rooms": 3,
  "dependencies": 1,
  "bathrooms": 1,
  "toilettes": 2,
  "garage": 2,
  "currency": "USD",
  "price": 142410,
  "zone3": 973,
  "rented": false,
  "sold": false,
  "reserved": false,
  "suspended": false,
  "occupancy": null,
  "images": [
    {
      "url": "https://cdn.ejemplo.com/propiedades/909181/foto-1.jpg",
      "description": "Imagen principal",
      "main": true
    },
    {
      "url": "https://cdn.ejemplo.com/propiedades/909181/foto-2.jpg",
      "description": "Imagen 2",
      "main": false
    },
    {
      "url": "https://cdn.ejemplo.com/propiedades/909181/foto-3.jpg",
      "description": "Imagen 3",
      "main": false
    }
  ],
  "blueprint": {
    "url": "https://cdn.ejemplo.com/propiedades/909181/plano.pdf"
  },
  "videos": [
    {
      "source": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "description": "Recorrido"
    }
  ],
  "prices": {
    "expensesCurrency": "ARS",
    "expensesPrice": 500,
    "taxCurrency": "ARS",
    "taxPrice": 200,
    "paymentPeriod": 1
  },
  "altPrices": [
    {
      "description": "Alquiler por semana",
      "currency": "ARS",
      "price": 100000
    }
  ],
  "attributes": [
    {
      "locale": "es_AR",
      "country": "ar",
      "id": "accessible",
      "label": "Accesible",
      "group": "propertyAttribute",
      "group_sub": "label",
      "group_subtype": "ammenities",
      "type": "bool",
      "key_legacy": "accessible",
      "selected": true,
      "status": true
    },
    {
      "locale": "es_AR",
      "country": "ar",
      "id": "statusAverage",
      "label": "Estado Regular",
      "group": "propertyStatus",
      "group_sub": "status",
      "type": "list",
      "key_legacy": "8",
      "value": 8
    },
    // … y 42 entradas más, una por cada atributo de la propiedad
  ],
  "publication": { … }  // la configuración de publicación por portal — ver su propia página
}

Las fotos, el plano, los videos y los precios accesorios

Van en el mismo JSON: mandás un objeto solo.

⚠️ El price y la currency de la propiedad no van acá: son campos del inmueble y ya están más arriba.

El arreglo attributes

Cada entrada describe un dato. Hay dos familias: el estado de la propiedad (propertyStatus) y los atributos — amenidades, orientación, tipo de calefacción y demás (propertyAttribute).

[
  {
    "locale": "es_AR",
    "country": "ar",
    "id": "accessible",
    "label": "Accesible",
    "group": "propertyAttribute",
    "group_sub": "label",
    "group_subtype": "ammenities",
    "type": "bool",
    "key_legacy": "accessible",
    "selected": true,
    "status": true
  },
  {
    "locale": "es_AR",
    "country": "ar",
    "id": "statusAverage",
    "label": "Estado Regular",
    "group": "propertyStatus",
    "group_sub": "status",
    "type": "list",
    "key_legacy": "8",
    "value": 8
  }
]

El valor que mandás es key_legacy: es el mismo en todos los países. El id, el label y el value salen del catálogo de tu país — de dónde sacarlos está más abajo.

customerSource — de dónde salió el cliente

Toda respuesta que trae el bloque customer trae también, en la raíz, de dónde salió:

El cliente NO es parte de este objeto

Hasta el 2026-09-30 el bloque customer viajaba acá adentro. Ya no: el cliente se declara una vez y sus propiedades lo heredan.

👉 Clientes — el POST /property-v1/customers, sus campos, el customerId que te devolvemos y la sucursal.

⚠️ Si mandás customer dentro de este objeto, se ignora — como propertyId, customerId y branchId. Y sin cliente declarado, el alta responde 400 con rule: account_required.

publication — cómo se publica

Dentro del mismo objeto viaja una clave publication con lo que cada portal necesita de tu cuenta y de tus elecciones de publicación. No es un campo del inmueble: es cómo lo publicás.

{
  "publication": {
    "api": {
      "argenprop": {
        "advertiserId": 99999,
        "visible": true,
        "token": "<tu-token-de-argenprop>"
      },
      "zonaprop": {
        "plan": {
          "plan": "SUPERDESTACADO"
        },
        "token": "<tu-token-de-zonaprop>"
      },
      "cabaprop": {
        "branchOfficeId": 42,
        "token": "<tu-token-de-cabaprop>"
      },
      "mercadolibre": {
        "listingTypeId": "gold_special",
        "condition": "used",
        "token": "<tu-token-de-mercadolibre>"
      }
    }
  }
}

La referencia completa está en La clave publication.

Campos obligatorios

Son 26, más el arreglo attributes. Todo lo demás es opcional.

La mayoría son campos sueltos:

Campos opcionales

Cómo se dice "no tengo este dato"

Un campo opcional que no tenés se manda en null o no se manda: para nosotros es lo mismo.

Lo que no es lo mismo es mandar 0. Un 0 en una superficie, en la antigüedad, en la cantidad de ocupantes o en una coordenada se guarda como el número cero — o sea, como un dato.

De dónde salen los valores

Los campos enumerados —el tipo, la operación, el estado, las orientaciones, los amenities— no tienen una lista fija en esta página a propósito: dependen del país y cambian cuando se agrega uno nuevo.

Los pedís acá:

GET /property-attributes?country=AR

Ver la referencia completa del endpoint

Te devuelve, para ese país, todo lo que acepta: la clave en texto (pa_key), el valor que mandás (pa_key_legacy), la etiqueta traducida (pa_label) y la familia (pa_group_subtype).

Verificá antes de publicar

Podés mandar tu objeto y ver qué produce, sin dar de alta nada:

POST /property-v1/properties/verify

Te dice si el objeto es válido, qué reglas incumple campo por campo, y qué pasaría en cada portal. Es el mismo cuerpo del alta, sin la escritura.

Ver también

• El modelo de propiedad — claves estables, catálogo por país, qué mandás vos y qué ponemos nosotros
• GET /property-attributes — el catálogo de valores
• POST /properties — el endpoint de alta