Responder a uma solicitação recebida de leilão de portabilidade
Envia uma proposta por meio de inclusao-garantias (Manual 011 v1.6 §3.2) em resposta a uma solicitação de leilão de portabilidade obtida pela integração do cliente. O catálogo define consignado.portability_proposal.received para esse fluxo, mas develop ainda não tem um produtor operacional para esse fato. Diferentemente da operação de lance M001, este endpoint aceita uma proposta por chamada: uma solicitação que permita uma segunda proposta, com ou sem garantia de FGTS, exige duas chamadas separadas em vez de um array.
dataHoraValidadeSolicitacao é o mesmo campo que o fato iniciador catalogado foi projetado para transportar. É um dado de resposta do Manual 011 §3.1.3 e não é enviado à Dataprev nesta solicitação. O cliente o repete para que o gateway possa rejeitar uma resposta a um registro expirado antes de chamar o trilho. A expiração é avaliada por registro, sem consultar um calendário.
O Manual 011 usa duas grafias para o caminho desta operação: §2.2 omite o acento, enquanto §3.2.3.1 o inclui. Como o M011 não publica um caminho Swagger que resolva a divergência, a grafia configurada deve ser validada durante a homologação. Fora isso, a solicitação e a resposta seguem o Manual 011 §3.2.1 e §3.2.2.
X-Idempotency é a chave obrigatória de repetição do transporte. Uma nova tentativa com a mesma chave retorna a resposta armazenada em vez de reenviá-la ao trilho, como ocorre nas rotas de averbação e anexo CCB. Este endpoint ainda não tem armazenamento durável de repetições respaldado por PostgreSQL, portanto a garantia não sobrevive a uma remoção do Redis nem a uma reinicialização do serviço.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Required transport replay key, scoped by authenticated tenant.
1 - 128"idem-portability-2026-08-10-0001"
Parâmetros de caminho
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"
Corpo
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"
Resposta
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"

