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