Features of the ChangeDocumentAuthorityStatus Method

The ChangeDocumentAuthorityStatus method is designed to manage the tax‑authority status of an electronic document within its fiscal validation lifecycle. Its primary function is to modify the document’s status as long as the document has not yet reached an approved (final) state.

General description:

This method allows the system to update the tax authority status when the document is still eligible for changes.

It is particularly useful in situations where the document needs to be corrected, revalidated, or resent before being approved by the corresponding tax authority.

Method behavior:

• The method can only be executed when the document is not in "Approved" (Aprobado) status.
  Once the document is approved, no further state modifications are permitted.

• When invoked, the method evaluates whether the requested state transition is allowed. The outcome of the process is returned through the StatusMessages parameter, indicating whether the operation was successful or rejected.

Examples of StatusMessage responses: 

Depending on the validation result, the method may return messages such as:

• “It is not possible to change the status of an approved document to status XX.”
  This indicates that the request was denied because the document has already reached a final state.

• “The document status was successfully updated.”
  This confirms that the change was processed correctly and the new state has been applied.