Dar de baja un cliente
DELETE /property-v1/customers
Cuando dejás de trabajar con un cliente, esto lo saca de circulación. Es reversible: el
POST lo reactiva con el mismo customerId.
curl -X DELETE https://property-api.mapaprop.com/property-v1/customers \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
No lleva body. Respuesta 200:
{
"deleted": true,
"alreadyDeleted": false,
"customer": {
"customerId": "MAPAPROP-PA-000002",
"clientRef": "cliente-42",
"deletedAt": "2026-10-01T18:22:04.117Z",
"name": "Inmobiliaria Modelo"
}
}
El customerId viene en la respuesta porque es el código con el que ese cliente está publicado en los
portales: te sirve para tu propio registro.
Requiere el scope property-api-delete, que es distinto de los otros tres: podés estar habilitado
para crear, leer y actualizar clientes y no para darlos de baja.
Qué deja de funcionar
A partir de la baja, ese cliente no opera:
| Operación | Después de la baja |
|---|---|
POST /properties | 400 con rule: account_required |
PUT .../publication/{portal} | 409 con customer_not_active |
POST /connect-links | 409 |
GET y PUT de su ficha | 404 con customer_deleted |
Qué NO toca
Los avisos que tu cliente tenga publicados en los portales siguen publicados. La baja no los da de baja: están en SU cuenta del portal, publicados con sus credenciales, y no es una decisión nuestra. Si hay que bajarlos, se bajan desde el panel del portal.
Tampoco se borran sus propiedades, ni sus fotos, ni sus conexiones a portales. La baja es una marca, no una limpieza — y por eso se puede deshacer.
Darla de baja dos veces no es un error
La segunda llamada devuelve 200 con alreadyDeleted: true y la fecha de la primera. Si una
llamada falló y no sabés si llegó, volvé a llamar.
Deshacerla
El mismo POST la reactiva, con revived: true y el
customerId de siempre:
curl -X POST 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", "phone1": "2234567890" }'
Los datos que mandes en ese POST son los que quedan.
Códigos de respuesta
| Código | Qué pasó | Qué hacer |
|---|---|---|
200 | Dado de baja, o ya lo estaba (alreadyDeleted: true) | — |
400 | Falta el header x-client-ref | — |
401 | Token ausente o inválido | — |
403 | Tu token no tiene el scope property-api-delete | Escribinos para habilitarlo |
404 | Ese clientRef nunca declaró una ficha | Nada que dar de baja |
Relacionado
- Clientes — qué es la ficha y los cuatro métodos
POST·GET·PUT- Publicar en un portal — el
409 customer_not_active