Skip to main content

POST Desfazer Junção

Desfaz uma junção: devolve ao cadastro absorvido os registros que eram dele e o reativa. Só vale até 30 dias após a junção. Registros criados no cadastro que ficou depois da junção continuam com ele. Campos que o cadastro que ficou herdou do absorvido voltam ao valor anterior, a menos que tenham sido editados depois.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_patients.

Só usuário

A junção precisa ser desfeita por um usuário: com API Key a rota responde 403.


Endpoint​

POST https://api-dev.imagemais.com.br/api/patients/merges/{id}/undo

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID da junção

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/patients/merges/1/undo' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

201 Sucesso​

{
"id": 12,
"sourceId": 205,
"targetId": 118,
"keptFields": [
"phone"
]
}

keptFields lista os campos que não foram revertidos porque o cadastro que ficou foi editado depois da junção (o valor atual foi preservado).

400 Requisição inválida​

Retornado quando o id não é numérico.

{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

Além de Permissões insuficientes, a rota responde assim quando chamada com API Key.

{
"message": "A junção precisa ser desfeita por um usuário",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Junção não encontrada",
"error": "Not Found",
"statusCode": 404
}

409 Conflito​

Mensagens possíveis:

  • Esta junção já foi desfeita.
  • O prazo de 30 dias para desfazer esta junção acabou.
  • O cadastro #{id} não está mais juntado ao #{outro}
  • O cadastro #{id} foi juntado a outro ou excluído depois. Desfaça isso antes.
{
"message": "Esta junção já foi desfeita.",
"error": "Conflict",
"statusCode": 409
}

500 Erro interno​

{
"message": "Não foi possível desfazer a junção",
"error": "Internal Server Error",
"statusCode": 500
}