Features of the ChangeDocumentStatus Method

The ChangeDocumentStatus method is used to report and update, individually, the commercial acknowledgment statuses (acuse mercantil) and RADIAN events associated with an electronic document. Its primary purpose is to ensure that each required or optional event is properly registered with the corresponding tax authority, following the regulatory workflow.

General description: 

This method enables the system to transmit specific fiscal or commercial status updates related to a document, including:

• Acknowledgment of receipt of the invoice
• Receipt of goods or service acceptance
• Express or tacit acceptance
• Complaints or objections
• ApplicationResponse events

Each request is validated using the document identifiers and the business rules defined by the tax authority, ensuring compliance with legal and operational requirements.

Accepted parameters and their behavior:

• Using CountryDocumentId with countryId

When both CountryDocumentId and countryId are included in the request, the GlobalDocumentId parameter is not required.

This allows the method to work with local tax identifiers when they are already known by the user or system.

Information returned in the OtherData parameter:

The method may return additional contextual information under the OtherData field, such as:

Validation rules and common messages:

During execution, the method applies regulatory and technical validations. Some examples of messages returned in the messages field include:

• "The event cannot be registered because a previous acknowledgment of receipt of the electronic sales invoice has already been recorded." (Evento no puede ser registrado ya que el documento presenta un evento previo de acuse de recibo de la factura electrónica de venta).
  Indicates that the sequence of events is incorrect.

• "The Application Response 6473921416 has been authorized." (La Application response 6473921416, ha sido autorizada)
  Confirms the authority’s approval of the ApplicationResponse event.

• "Event (034) Tacit Acceptance may only be transmitted 3 business days after event (032) Goods Receipt or Service Acceptance has been submitted." (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)
  Enforces waiting periods required by RADIAN regulations.
  

• "A complaint cannot be submitted unless the Acknowledgment of Receipt and the Goods Receipt/Service Acceptance events have been registered first." (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)
  Confirms mandatory event prerequisites.

• "This UUID does not exist in DIAN’s database." (Esta UUID no existe en la base de datos de la DIAN)
  Indicates that the authority does not recognize the document.

Typical error responses returned by the method

Below are the most frequent responses returned when required identifiers are missing.

1. When the globalDocumentId does not exist

2. When neither globalDocumentId nor countryDocumentId is included

Summary: 

The ChangeDocumentStatus method is essential for managing RADIAN events and merchant acknowledgment statuses. Its main capabilities include:

• Reporting each event individually and in compliance with fiscal regulations.
• Allowing flexible identification through global or country-level IDs.
• Validating regulatory rules before applying changes.
• Returning clear messages regarding success, errors, and authority responses.