Sign in
Confirmation and Documentation

Final confirmation of the application (ConfermaDomanda)

Changed on

Invoked when the state is READY_FOR_DOCUMENTS_UPLOAD. The client supplies an Idempotency-Key identifying the user action: re-sending the same key is a safe retry. Once the application is ACQUIRED, a different key yields 400 / 115 (state not coherent).

post/confirm

Request

  • Base URL: https://api.your-bff.it/v1
  • URL: https://api.your-bff.it/v1/confirm
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

Client-generated UUID identifying a single user action (intent). The same key MUST be reused when retrying the same action (e.g. after a network timeout) so the operation is replayed safely. A new key signals a new intent: replace the draft, overwrite the photo, etc. The BFF maps this client key to the per-step INPS Idempotency-Key it persists, guaranteeing the local record stays reconcilable with the INPS source of truth.

Request body

idLavorazionestring required

The INPS idLavorazione of the draft application.

tipologiaUlterioreDocumentazionestring nullable

1 - Trento/Bolzano/Valle d’Aosta, 2 - Sentenza/Decreto, 3 - Invalidità ante 2010.

nomeFilestring nullable

Required if TipologiaUlterioreDocumentazione=1 or 3

allegatostring byte nullable

Verbale in PDF encoded in Base64 (max 2Mb). Required if TipologiaUlterioreDocumentazione=1 or 3.

siglaProvinciaTribunalestring nullable

Required if TipologiaUlterioreDocumentazione=2

descrizioneComuneTribunalestring nullable

Required if TipologiaUlterioreDocumentazione=2

dataSentenzastring date-time nullable

Date of the Sentence/Homologation Decree. Required if TipologiaUlterioreDocumentazione=2.

dichiarazioneConformitaVerbaleboolean nullable

1=YES. Required if TipologiaUlterioreDocumentazione=1 or 3.

autodichiarazioneSentenzaboolean nullable

1=YES. Required if TipologiaUlterioreDocumentazione=2.

dirittoAccompagnatoreboolean nullable

0=NO, 1=SI. Independent of documentation type.

Response

Application acquired by INPS. Final state returned.

state'READY_FOR_NEW_DRAFT' | 'DRAFT' | 'READY_FOR_PHOTO_UPLOAD' | 'UPLOADING_PHOTO' | 'READY_FOR_DOCUMENTS_UPLOAD' | 'UPLOADING_DOCUMENTS' | 'ACQUIRED'

Internal workflow state (managed by the BFF/DB) that guides the FE's display logic.

numDomusstring nullable

INPS-assigned document number for the acquired application.

Changes