BETA

Actualizar un cliente

PUT /property-v1/customers

Cambia los datos de la ficha. Es la razón por la que la ficha existe: cambiar un teléfono es esta llamada y nada más, en vez de recargar el inventario.

curl -X PUT https://property-api.mapaprop.com/property-v1/customers \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-client-ref: cliente-42" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Inmobiliaria Modelo",
        "email": "contacto@inmobiliaria-modelo.test",
        "phone1": "2239999999" }'

Acepta los mismos campos que el POST y devuelve 200 con la ficha actualizada.

El PUT declara cómo queda la ficha completa, no hace merge campo por campo: lo que no mandes queda vacío. Si querés cambiar sólo el teléfono, mandá también el resto de los datos.

Por eso name, email y phone1 también son obligatorios acá: un PUT que los omitiera dejaría al cliente sin el contacto que sale publicado en sus avisos. Responde 400 con el campo en field.

El customerId no se toca. Es lo único que hace que cambiar un teléfono no obligue a recrear nada.

Las sucursales también se actualizan acá

branches funciona igual que en el POST: declarás el padrón completo y se guarda. Y si sos cliente de Mapaprop y declarás una sucursal nueva con sus datos y sin mapapropBranchId, la creamos en tu cuenta y te devolvemos su id en la respuesta:

{
  "branches": { "created": [ { "branchRef": "sur", "mapapropBranchId": 781 } ], "failed": [] },
  "customer": { "…" }
}

Repetir el PUT no duplica nada, y no tenés que mandar el mapapropBranchId. El vínculo entre tu branchRef y el id de la sucursal lo guardamos nosotros, y lo conservamos aunque tu body no lo mencione. Así que podés repetir exactamente el mismo PUT: las que ya se crearon no se crean de nuevo. Si una falló, corregís esa y repetís.

Lo que no hace este PUT es cambiar los datos de una sucursal que ya está en Mapaprop: ésos se leen de tu cuenta, que es donde los editás. Lo que declarás acá para una sucursal vinculada es sólo el vínculo.

El cambio alcanza a las propiedades NUEVAS

Cada propiedad guarda el contacto con el que se dio de alta: es el registro de cómo se publicó, así que no se reescribe — ni mandando la propiedad de nuevo.

O sea: la ficha te ahorra repetir el bloque en cada alta, y lo que ya cargaste conserva sus datos.

Si necesitás que un cambio de contacto alcance al inventario ya cargado, escribinos a dev@mapaprop.com: hoy no hay forma de hacerlo por API.

Un cliente dado de baja no se actualiza

Si el cliente está dado de baja, el PUT responde 404 con error: customer_deleted. Primero se reactiva con el POST —que además aplica los datos que le mandes— y después se actualiza si hace falta.

Es a propósito: un PUT que lo actualizara dejaría una ficha dada de baja con datos nuevos, que no significa nada.

Códigos de respuesta

CódigoQué pasóQué hacer
200La ficha actualizada—
400Falta name, email o phone1; country no es un entero positivo; branch no es un objeto; o un texto pasa de 256 caracteresEl campo viene en field
401Token ausente o inválido—
403Tu token no tiene el scope property-api-updateEscribinos para habilitarlo
404No existe, o está dado de baja (error: customer_deleted)Ver GET

Relacionado