Eventos Colombia

Informar eventos mercantiles

Por medio de este método, se puede informar cada uno de los estados mercantiles o estados RADIAN de un documento (Acuse, Recibo, Reclamo, Aceptación, etc).

Para realizar la petición en la API, deberá ingresar los siguientes parámetros:

Parámetro	Tipo	Descripción	Valores permitidos
ChangeDocumentStatus (request)
globalDocumentId*	String	Identificación de documento en Gosocket.	UUID de 36 caracteres alfanuméricos xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
countryDocumentId	String	Identificador fiscal del documento a nivel país, conocido también como CUFE, CLAVE, UUID, ID	Ver tabla Estructura Country Document ID
countryId	String	Código del País de emisión del documento	ar, bo, br, cl, co, cr, ec, gt, mx, pa, pe, py, do, sv, uy
status*	Integer	Código del estado mercantil o estado RADIAN a informar.	Ejemplo: 30, 31, 32
description*	String	Descripción del estado a informar.	Ejemplo: Autorizado
code*	String	Código del Tipo de documento (factura, nota, etc)	1, 2, 3, …

*Requerido

Los eventos mercantiles se identifican de la siguiente forma:

Los eventos RADIAN se identifican de la siguiente forma:

---

Ejemplo de petición

Nota: Recuerde que antes de utilizar el método, debe realizar su autenticación dentro de la pestaña Authorization.

 Para este método utilizamos la pestaña Params de Postman.

1. Seleccione el tipo de método. En este caso, se debe seleccionar POST.
2. Ingrese la URL del método.
3. Ingrese los parámetros que se muestran en la tabla anterior con sus valores correspondientes.
4. Presione Send.

---

Ejemplo de respuesta

Para interpretar correctamente la respuesta de la API, tome en cuenta los siguientes criterios:

---

Características del método ChangeDocumentStatus

• El método permite informar uno a uno los estados del acuse mercantil o estado de RADIAN.
• Cuando se envía en la petición el parámetro CountryDocumentId y el parámetro countryId no se requiere enviar de forma obligatoria el parámetro GlobalDocumentId
• Cuando no se conoce el valor del CountryDocumentId, se debe enviar el parámetro GlobalDocumentId
• En el parámetro OtherData se pueden encontrar las siguientes propiedades:

{
"Country": "co",
"Certifier": "DIAN",
"AuthorityTimeStamp": "25/07/2022 19:20:31"
}

• Algunos ejemplos de reglas validadas en el proceso del parámetro messages son:

  • "Evento no puede ser registrado ya que el documento presenta un evento previo de acuse de recibo de la factura electronica de venta."
  • "La Application response 6473921416, ha sido autorizada."
  • "Solo se pueda 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"
  • "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"
  • "Esta UUID no existe en la base de datos de la DIAN"

• Cuando no existe el Id del documento (globalDocumentId), el sistema responde:

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": null,
"Messages": null,
"ResponseValue": null,
"Code": "400",
"Description": "Document Not Found",
"ErrorException": null
}

Veámos los diferentes escenarios en los que podemos utilizar este método.