Generar un evento sobre un documento recibido

El método GenerarEvento permite al receptor generar un evento específico sobre una factura recibida de un proveedor. A diferencia de GenerarEventosCompletos, no ejecuta automáticamente otros eventos: cada evento se envía de forma individual y en el orden correspondiente.

Es útil para generar los eventos uno a uno, controlar manualmente el flujo de recepción o integrarse con procesos propios.

Uso por el emisor

El mismo método lo usa el emisor para generar la aceptación tácita (034) sobre una factura que emitió, enviando esRecepcion en false. Ese proceso se describe en Eventos de emisión → Aceptación tácita (evento 034).

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	GenerarEvento

Requisito previo

El integrador debe garantizar el orden correcto de los eventos: 030 → 032 → 033 o 031. El método no valida automáticamente la secuencia. Consulta la jerarquía de los eventos antes de generar uno.

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 a generar. Como receptor: 030 (acuse de recibo), 032 (recibo del bien o servicio), 033 (aceptación expresa) o 031 (reclamo o rechazo). Como emisor: 034 (aceptación tácita).
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.
esRecepcion	boolean	No	Indica si el documento es recibido (true) o emitido (false). Para el evento 034 sobre un documento emitido se envía false.

Ejemplo de solicitud

Acuse de recibo (030)

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

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"
  }
}

Aceptación tácita (034), como emisor

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa emisora>",
    "periodo": "202603",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "codigoEvento": "034",
    "esRecepcion": false
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "GenerarEventoResult": {
    "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": "030",
    "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 solicitado.
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 es asíncrono: la respuesta inicial indica que el evento quedó en cola, no que esté finalizado.
• El evento 031 (rechazo) requiere tipoRechazo.
• El evento 034 solo puede generarse si existe el evento 032 y han pasado más de 72 horas hábiles desde su registro; si no se cumplen las condiciones, el servicio devuelve un error.
• El XML y el PDF del evento pueden generarse después; consulta el resultado con ExtraerEventosRecepcion.
• Si necesitas confirmación final, implementa un control de estado consultando periódicamente los eventos del documento.