Amend a MED value recovery
Records a field-only update to a value recovery (JDPI recuperacao-valores/ PUT, contract 2.23 — Alterar). It NEVER changes status. The contract 2.23 invariants are validated before any JDPI call. An unknown id returns a coded 404.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
The value-recovery GUID.
"b2c3d4e5-f6a7-8901-bcde-f23456789012"
Body
Client-supplied idempotency key: any stable business string. The plugin projects it deterministically into the GUID form JDPI requires (contract 6), so the same value always dedups against the same JDPI request and the raw value is never sent verbatim.
"med-amend-2024-0001"
New situation code (0..5).
4
New creator-contact email.
"ops@example.com"
New creator-contact phone.
"+5511999999999"
New free-text detail; required when tpSituacao=4 (Outros).
"Updated detail."
Response
OK
True when the devolver deadline has been reached or passed (computed at read time); false when no deadline is set.
false
Creator-contact email.
"ops@example.com"
Creator-contact phone.
"+5511999999999"
JDPI creation timestamp (RFC 3339 UTC).
"2024-01-01T12:00:00.000Z"
JDPI last-modification timestamp (RFC 3339 UTC) — the watermark.
"2024-01-01T12:05:00.000Z"
Value-recovery GUID (the natural key).
"b2c3d4e5-f6a7-8901-bcde-f23456789012"
EndToEndId of the root transaction being recovered.
"E1234567820240101000000000000001"
ISPB of the recovery creator.
"12345678"
stRecValores lifecycle code (0=Criada .. 6=Cancelada).
0
Human-readable stRecValores label.
"Criada"
Situation code (0..5).
0
Human-readable tpSituacao label.
"Golpe/Estelionato"
Free-text detail (required when tpSituacao=4 Outros).
"Suspected scam."
Creator-side 72h devolver deadline (RFC 3339 UTC; contract §2.22/§5), from the Analise stage close; null unless this institution is the pspCriador on an Analisada recovery.
"2024-01-04T12:00:00.000Z"
idCorrelacao — the DICT support identifier for this consultar call; quote it to JD when disputing whether the read happened.
"a9f13566e19f5ca51329479a5bae60c5"
dtHrRetornoDict — when DICT answered this consultar (contract 2.21).
"2025-08-27T10:30:05.025Z"

