Características del Método ChangeDocumentAuthorityStatus

El método ChangeDocumentAuthorityStatus permite gestionar el estado tributario de un documento electrónico dentro del flujo de validación fiscal. Su función principal es modificar el estado del documento cuando este aún no ha alcanzado un estado final de aprobación.

Descripción general: Este método está diseñado para actualizar el estado tributario siempre que el documento se encuentre en una condición que permita modificaciones.
Es especialmente útil en escenarios donde el documento requiere ser corregido, revalidado o reenviado antes de ser aprobado por la autoridad fiscal correspondiente.

Comportamiento del método:

• El método solo puede ejecutarse cuando el documento NO está en estado “Aprobado”.
  Si el documento ya fue aprobado por la autoridad, el sistema no permitirá ningún cambio de estado adicional.

• Una vez invocado, el método evalúa la validez del cambio solicitado y devuelve un mensaje informativo en el parámetro StatusMessage, indicando si la operación fue exitosa o si ocurrió algún impedimento.

Ejemplos de mensajes de respuesta (StatusMessage): Dependiendo del resultado, el método puede devolver mensajes como:

• “No es posible cambiar el estado de un documento aprobado al estado XX”
  → Este mensaje indica que la operación fue rechazada, ya que el documento se encuentra en un estado final que no permite modificaciones.

• “El estado del documento fue actualizado correctamente”
  → Este mensaje confirma que el sistema procesó la solicitud y el nuevo estado fue aplicado sin inconvenientes.