Aceptar o rechazar un documento recibido

El método GenerarEventosCompletos permite aceptar (evento 033) o rechazar (evento 031) un documento recibido, automatizando el flujo completo que exige la DIAN: antes del evento final, genera automáticamente el acuse de recibo (030) y el recibo del bien o servicio (032).

POST https://micro.conexusit.com/corp/demo/api/Service.svc/GenerarEventosCompletos

Endpoint

Dato	Valor
Método HTTP	POST
Operación	GenerarEventosCompletos

Flujo del proceso

Paso	Acción
1	Recepción de la solicitud.
2	Generación del evento 030 (acuse de recibo).
3	Generación del evento 032 (recibo del bien o servicio).
4	Generación del evento final: 033 (aceptación expresa) o 031 (rechazo).
5	Respuesta consolidada.

Parámetros de entrada

La solicitud se envía dentro de un objeto solicitud.

Parámetro	Tipo	Obligatorio	Descripción
guidEmpresa	string	Sí	Identificador único de la empresa receptora. Se asigna al configurar e implementar el cliente.
codigoTransaccion	string	Sí	CUFE o CUDE del documento.
codigoEvento	string	Sí	Evento final a generar: 033 (aceptación expresa) o 031 (rechazo).
periodo	string	Sí	Año y mes de emisión del documento, en formato yyyyMM (por ejemplo, 202501). Debe coincidir con la fecha de emisión del documento.
tipoRechazo	string	Condicional	Obligatorio cuando codigoEvento es 031. Ver Tipos de rechazo.

Ejemplo de solicitud

Aceptación expresa (033)

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "codigoEvento": "033",
    "periodo": "202505",
    "tipoRechazo": ""
  }
}

Rechazo (031)

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "codigoEvento": "031",
    "periodo": "202505",
    "tipoRechazo": "01"
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "GenerarEventosCompletosResult": {
    "Estado": "Ok",
    "DetalleEstado": "El evento se encuentra en la Cola de procesamiento.",
    "guidEmpresa": "<GUID de la empresa receptora>",
    "fechaInicio": null,
    "fechaFin": null,
    "identProveedor": null,
    "documentos": null,
    "periodo": "202505",
    "codigoTransaccion": "<CUFE del documento>",
    "codigoEvento": "033",
    "tipoRechazo": "",
    "nombreRechazo": "",
    "eventos": null,
    "XML": null,
    "PDF": null
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
Estado	string	Resultado de la operación: OK o ERROR.
DetalleEstado	string	Mensaje del proceso; por ejemplo, que el evento quedó en la cola de procesamiento.
guidEmpresa	string	Identificador de la empresa receptora.
fechaInicio	datetime	Inicio del procesamiento. Puede ser null.
fechaFin	datetime	Fin del procesamiento. Puede ser null.
periodo	string	Periodo del documento.
codigoTransaccion	string	CUFE o CUDE del documento.
codigoEvento	string	Evento final solicitado (033 o 031).
tipoRechazo	string	Código del tipo de rechazo, cuando el evento es 031.
nombreRechazo	string	Descripción del rechazo, cuando el evento es 031.
XML	string	XML del evento generado. Puede llegar después (proceso asíncrono).
PDF	string	Representación gráfica del evento. Puede llegar después (proceso asíncrono).

Los campos identProveedor, documentos y eventos se devuelven en null en este método.

Consideraciones importantes

• El procesamiento tarda entre 35 y 45 segundos.
• La respuesta inicial indica que el evento fue encolado, no finalizado; el XML y el PDF pueden llegar después (proceso asíncrono).
• Para el rechazo (031) es obligatorio enviar tipoRechazo.
• Si el documento ya tiene eventos previos, valida su estado con ExtraerEventosRecepcion antes de usar este método.