Responder a una solicitud entrante de subasta de portabilidad
Envía una propuesta mediante inclusao-garantias (Manual 011 v1.6 §3.2) en respuesta a una solicitud de subasta de portabilidad obtenida a través de la integración del cliente. El catálogo define consignado.portability_proposal.received para este flujo, pero develop aún no tiene un productor operativo para ese hecho. A diferencia de la operación de oferta M001, este endpoint acepta una propuesta por llamada: una solicitud que permita una segunda propuesta, con o sin garantía de FGTS, requiere dos llamadas separadas en lugar de un array.
dataHoraValidadeSolicitacao es el mismo campo que el hecho iniciador catalogado está diseñado para transportar. Es un dato de respuesta del Manual 011 §3.1.3 y no se envía a Dataprev en esta solicitud. El cliente lo repite para que el gateway pueda rechazar una respuesta a un registro vencido antes de llamar al riel. La caducidad se evalúa por registro sin consultar un calendario.
El Manual 011 usa dos grafías para la ruta de esta operación: §2.2 omite el acento, mientras que §3.2.3.1 lo incluye. Como M011 no publica una ruta Swagger que resuelva la discrepancia, la grafía configurada debe validarse durante la homologación. Por lo demás, la solicitud y la respuesta siguen el Manual 011 §3.2.1 y §3.2.2.
X-Idempotency es la clave obligatoria de repetición del transporte. Un reintento con la misma clave devuelve la respuesta almacenada en vez de volver a enviarla al riel, como ocurre en las rutas de averbação y adjunto CCB. Este endpoint aún no dispone de almacenamiento duradero de repeticiones respaldado por PostgreSQL, por lo que la garantía no sobrevive a una expulsión de Redis ni a un reinicio del servicio.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Required transport replay key, scoped by authenticated tenant.
1 - 128"idem-portability-2026-08-10-0001"
Parámetros de ruta
Portability solicitação identity, echoed from the initiating fact. A digit string — Manual 011 v1.6 §3.2.1 publishes 32 algarismos, which overflows an int64.
1 - 32^[0-9]{1,32}$"221"
Cuerpo
This proposal's own validity instant — a SEPARATE validity from dataHoraValidadeSolicitacao above, informed by the client (Manual 011 v1.6 §3.2.1).
"2030-01-01T10:00:00Z"
The portability solicitação's own validity instant from Manual 011 v1.6 §3.1.3. The cataloged consignado.portability_proposal.received fact is designed to carry this value, but that fact has no production producer on develop yet. The value is authoritative per record and is judged against the gateway's clock before the rail is called.
"2025-10-30T23:45:29Z"
Number of instalments.
1 <= x <= 99912
Proposal identifier this gateway mints.
1 - 20"7K9M2P4R6T8V3W5X2Y4Z"
Whether this proposal pledges FGTS collateral.
false
Annual total effective cost in percent.
10^[0-9]+(\.[0-9]{1,2})?$"11.00"
Monthly total effective cost in percent.
10^[0-9]+(\.[0-9]{1,2})?$"0.90"
Principal plus financed costs as an exact decimal string.
13^[0-9]+(\.[0-9]{1,2})?$"2160.00"
Instalment amount as an exact decimal string.
13^[0-9]+(\.[0-9]{1,2})?$"180.00"
Annual interest rate in percent.
10^[0-9]+(\.[0-9]{1,2})?$"10.00"
Monthly interest rate in percent.
10^[0-9]+(\.[0-9]{1,2})?$"0.80"
Client contacts.
4Optional severance-pay percentage pledged as collateral.
6^[0-9]+(\.[0-9]{1,2})?$"15.00"
Optional rescission-penalty amount pledged as collateral.
13^[0-9]+(\.[0-9]{1,2})?$"300.00"
Optional consignable FGTS balance pledged as collateral.
13^[0-9]+(\.[0-9]{1,2})?$"600.00"
Respuesta
OK
True only when the rail's codigo equalled the observed success code.
true
Bounded rail outcome code, relayed verbatim. Free-form provider text is never returned.
32^[A-Za-z0-9_-]*$"BD"
Proposal validity echoed by Dataprev.
"2030-01-01T10:00:00Z"
The solicitação identity addressed by this response.
"221"
Proposal identifier echoed by Dataprev.
"7K9M2P4R6T8V3W5X2Y4Z"
UTC instant the gateway submitted this proposal.
"2025-10-28T00:00:00Z"
Opaque rail audit identifier, when published.
"34027710"

