An initial validation of the credentials is already performed when the Entity state is updated from ACQUIRED
to COMMISSIONED
. If the credentials are valid, the Entity mode will change to OPERATIVE
.
Additionally, you can manually trigger a validation by changing the Entity mode from OPERATIVE
→ SUSPENDED
→ OPERATIVE
using the updateEntity endpoint.
You can find more details in this article (step 2 is not relevant in this case): SIGN IT - How to update the FISCONLINE credentials?
If the credentials are valid, the Entity mode will switch to OPERATIVE
. If invalid, it will remain SUSPENDED
and it will be necessary to complete step 2 of the article to update the credentials.
Later, when you create a Record, we perform another credential check. If the credentials are no longer valid, the mode of the Record will be set to FINISHED
, but its state will be FAILED
, with the error message: "Transmission error: Agenzia delle Entrate (AdE) authentication failed".
Note: If Record creation fails due to invalid credentials, the Entity’s mode will not automatically change to DEGRADED
at this time. However, this behavior is planned to be implemented in the near future.