Repetir o cadastro no Mapaprop
POST /property-v1/properties/{paId}/mapaprop
No caminho normal você não chama este endpoint. Se você é cliente da Mapaprop e gerou o seu
token pelo app, a propriedade é cadastrada sozinha na sua conta: assim que termina a ingestão das
imagens, sem que você peça nada — ver Mapaprop. O
resultado aparece no bloco mapaprop do GET da propriedade.
Este endpoint existe para repetir quando o cadastro foi interrompido e você já corrigiu a causa.
O bloco mapaprop
{
"mapaprop": {
"state": "synced",
"propertyId": 2619527,
"branchId": 1,
"message": "La propiedad existe en tu cuenta de Mapaprop con el id 2619527 (sucursal 1)…"
}
}
state | o que aconteceu | repetir? |
|---|---|---|
pending | ainda não rodou | não: aguarde |
synced | a propriedade existe na conta | não é necessário |
rejected | o objeto tem algo que o Mapaprop não consegue guardar | sim, depois de corrigir |
blocked | a conta não está em condições | não: fale com a gente |
unauthorized | um problema nosso | não: já estamos cuidando |
exhausted | as tentativas automáticas se esgotaram | sim |
synced significa que a propriedade existe, não que esteja publicada. Para publicá-la use
PUT /properties/{paId}/publication/mapaprop.
Quando serve
Quando o estado é rejected. O bloco informa qual campo e por quê:
{
"state": "rejected",
"fields": ["currency"],
"message": "Mapaprop rechazó la propiedad: currency llegó como 1 (number) y Mapaprop guarda un código ISO. Mandá uno de: USD, ARS. Corregila con PUT …"
}
Corrija o objeto com PUT /properties/{paId} e só então
repita.
Quando a propriedade ficou synced mas sem as imagens. Se o cadastro deu certo e os acessórios
—fotos, planta, vídeos— falharam, o bloco avisa em accessoriesMessage. Nesse caso a repetição
envia apenas os acessórios: não cria a propriedade de novo.
A resposta
202 Accepted
{
"paId": "01M6Q16SAKDDD12YZ5RQKSN03G",
"reintentada": true,
"detail": "El alta en Mapaprop se está reintentando. El resultado aparece en GET /property-v1/properties/{paId}."
}
É assíncrona: responde na hora e o resultado aparece no GET. Não espere o cadastro nesta
chamada.
Os 409
error | o que significa |
|---|---|
already_synced | a propriedade já está cadastrada e os acessórios também |
no_customer_id | seu token não saiu de uma conta Mapaprop: suas propriedades existem apenas no PropertyAPI |
not_consolidated | as imagens ainda estão sendo processadas. O cadastro dispara sozinho quando terminarem |
Se você não é cliente da Mapaprop —ou gerou o token por outra via— este endpoint não serve para você e o cadastro nunca dispara. É o caso normal de um integrador que publica apenas em portais.