---
title: "Endpoint para emitir un evento electrónico a partir del CUFE de la factura"
method: POST
path: "/events/from-cufe"
tags: ["Eventos electrónicos"]
---

# Endpoint para emitir un evento electrónico a partir del CUFE de la factura

`POST /events/from-cufe`

Permite emitir eventos electrónicos asociados a una factura a partir de su CUFE. Admite los eventos: Acuse, Reclamo, Recibo del bien o la prestación del servicio, Aceptación expresa y tácita. Solo requiere el CUFE, el número del evento y, para los eventos 030 (Acuse) y 032 (Recibo), la información del generador. La información del emisor (SenderParty) y receptor (ReceiverParty) se extrae automáticamente del XML de la factura consultado en la DIAN.

## Request body

- object
  - `type` '030' | '031' | '032' | '033' | '034', required — Código del tipo de evento, este elemento acepta una de las siguientes opciones:<br>030 Acuse de recibo de Factura Electrónica de Venta<br>031 Reclamo de la Factura Electrónica de Venta<br>032 Recibo del bien o prestación del servicio<br>033 Aceptación expresa<br>034 Aceptación Tácita<br><i>Campo oficial DIAN &lt;ResponseCode&gt;</i>
  - `companyId` string — Id de la empresa. Id único generado por la API, se deberá enviar cuando el evento se genere diferente a la Company principal
  - `number` string, required — Número del evento que se emite, el valor es alfanumérico y único por evento dentro de la misma compañía
  - `uuid` string, required — CUFE de la factura a la que se le asociará el evento
  - `issuerParty` object — Persona o empresa que recibe la factura y el bien o servicio prestado. Obligatoriedad: Campo opcional, excepto en los siguientes casos donde es requerido:<br><br>030: Acuse de recibo de Factura Electrónica de Venta<br>032: Recibo del bien o prestación del servicio<br><br><i>Campo oficial DIAN &lt;IssuerParty&gt;</i>
    - `identificationType` '11' | '12' | '13' | '21' | '22' | '31' | '41' | '42' | '47' | '50' | '91', required — Tipo de identificador fiscal
    - `identificationNumber` string, required — Número de identificación de la persona
    - `dv` string — DV del NIT. Obligatorio cuando identificationType es 31
    - `firstName` string, required — Nombre de la persona que recibió la factura o los bienes y/o servicios
    - `familyName` string, required — Apellido de la persona que recibió la factura o los bienes y/o servicios
    - `jobTitle` string — Cargo de la persona que recibió la factura o los bienes y/o servicios
    - `organizationDepartment` string — Area, sección o departamento de la persona que recibió la factura o los bienes y/o servicios
  - `claimCode` '01' | '02' | '03' | '04' — Código motivo de rechazo, este elemento acepta una de las siguientes opciones. Obligatorio en el evento "031 Reclamo de la Factura Electrónica de Venta"<br>01 Documento con inconsistencias<br>02 Mercancía no entregada<br>03 Mercancía entregada parcialmente<br>04 Servicio no prestado<br><i>Campo oficial DIAN &lt;@listID en ResponseCode&gt;</i>
  - `notes` string[] — Información adicional que se quiera agregar en el evento<br><i>Campo oficial DIAN &lt;Note&gt;</i>
  - `email` object — Objeto para enviar un email de recepción de documento
    - `to` string, required — Lista de destinatarios separados por coma
    - `cc` string — Lista de CC (carbon copy) separados por coma
    - `bcc` string — Lista de BCC (blind carbon copy) separados por coma
    - `replyTo` string, required — Dirección de correo a la que se responde el email.

## Other responses

- `200` — unresolved $ref
- `400` — Objeto que representa una respuesta de error por validaciones
- `404` — Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500` — Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)
