Características del Método ChangeDocumentStatus

El método ChangeDocumentStatus se utiliza para reportar y actualizar, de manera individual, los estados relacionados con el acuse mercantil y los eventos del sistema RADIAN de un documento electrónico. Su función principal es permitir que cada evento obligatorio o voluntario se registre adecuadamente ante la autoridad competente, siempre siguiendo el flujo regulatorio definido.

Descripción general:

Este método está diseñado para enviar información de estados tributarios o comerciales asociados a un documento, tales como:

• Acuse de recibo de la factura
• Recibo del bien o prestación del servicio
• Aceptación expresa o tácita
• Reclamos
• Respuestas de aplicación (ApplicationResponse)

Cada solicitud evalúa el identificador del documento y las reglas de negocio que determinan si el evento puede registrarse o si existe alguna restricción normativa.

Parámetros aceptados por el método:

• Uso de CountryDocumentId y countryId

Cuando la petición incluye correctamente los parámetros CountryDocumentId y countryId, no es obligatorio enviar el parámetro GlobalDocumentId.

Esto facilita el uso del método cuando el usuario conoce el identificador fiscal local asignado por la autoridad del país.

• Uso de GlobalDocumentId

Si el valor de CountryDocumentId no se conoce, entonces es obligatorio enviar el parámetro GlobalDocumentId, el cual identifica al documento de forma global dentro de la plataforma.

Propiedades disponibles en el parámetro OtherData: 

El método puede retornar información complementaria dentro del campo OtherData, incluyendo datos como:

Estos valores permiten identificar el país, la entidad certificadora (como DIAN en Colombia) y la marca de tiempo oficial registrada por la autoridad.

Validaciones y reglas comunes dentro del proceso:

Durante la ejecución del método, el sistema evalúa reglas regulatorias definidas por cada autoridad fiscal. Algunos ejemplos de mensajes devueltos en el parámetro messages incluyen:

• "Evento no puede ser registrado ya que el documento presenta un evento previo de acuse de recibo de la factura electrónica de venta."
  Indica imposibilidad de registrar un evento por secuencia incorrecta.

• "La Application response 6473921416, ha sido autorizada."
  Confirma que la autoridad aprobó la respuesta de aplicación.

• "Solo se puede transmitir el evento (034) Aceptación Tácita de la factura, pasados 3 días hábiles después de la transmisión del evento (032) recibo del bien o aceptación de la prestación del servicio."
  Valida reglas de plazos exigidos por la regulación RADIAN.

• "No se puede recibir un reclamo si previamente no se han recibido los eventos Acuse de recibo de la factura electrónica y un recibo de bien y prestación de servicio."
  Indica incumplimiento del orden obligatorio de eventos.

• "Esta UUID no existe en la base de datos de la DIAN."
  El documento no aparece registrado ante la autoridad fiscal.

Respuestas comunes ante errores en los parámetros enviados:

A continuación se muestran ejemplos de respuestas típicas cuando los parámetros obligatorios no son enviados correctamente.

1. Cuando no existe el globalDocumentId

El sistema devuelve:

2. Cuando no se especifica ni globalDocumentId ni countryDocumentId

El sistema responde:

Este mensaje aclara que la solicitud carece de identificadores válidos y no puede ejecutarse.

Resumen final: 

El método ChangeDocumentStatus es fundamental para el registro de eventos mercantiles y tributarios ante la autoridad fiscal. Sus capacidades principales incluyen:

• Reportar individualmente cada evento requerido en RADIAN o acuse mercantil.
• Permitir el uso flexible de identificadores locales o globales.
• Validar reglas reguladoras antes de aplicar los cambios.
• Retornar mensajes claros sobre el estado de la operación.