---
title: "Endpoint para emitir un evento relacionado a una factura electrónica"
method: POST
path: "/events"
tags: ["Eventos electrónicos"]
---

# Endpoint para emitir un evento relacionado a una factura electrónica

`POST /events`

Endpoint para emitir un evento relacionado a una factura electrónico a partir de los datos recibidos en la petición

## Request body

- object
  - `number` string, required — Número del evento que se emite, el valor es alfanumérico y único por evento dentro de la misma compañia
  - `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>
  - `company` object — Detalles de la organización que emite el evento, en caso de omitir este objeto se usará la compañia principal asociada al usuario
    - `id` string — Id de la empresa
    - `organizationType` 1 | 2 — Tipo de organización jurídica. Se debe colocar el código que corresponda de la tabla de tipos de organización jurídica de la DIAN. Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)
    - `identificationType` '11' | '12' | '13' | '21' | '22' | '31' | '41' | '42' | '47' | '50' | '91' — Tipo de documento de identificación del emisor. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN
    - `identificationNumber` string — Número de identificación o NIT del emisor, sin guiones ni dv
    - `dv` string — DV del NIT del emisor. Es obligatorio si identificationType = 31
    - `name` string — Nombre o nombre comercial del emisor
    - `taxCode` '01' | '04' | 'ZA' | 'ZZ' — Código tipo de impuesto según los códigos de la tabla de la DIAN. IVA (01). INC (04). IVA e INC (ZA). No aplica (ZZ)
  - `associatedDocument` object, required — Objecto que contiene la información del documento de referencia
    - `prefix` string — Prefijo del documento de referencia
    - `number` number, required — Número del documento de referencia
    - `uuid` string, required — CUFE del documento de referencia
  - `receiverParty` object — Información del receptor del evento<br><i>Campo oficial DIAN &lt;ReceiverParty&gt;</i>
    - `name` string, required — Nombre o razón social del receptor
    - `organizationType` 1 | 2, required — Tipo de organización jurídica. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN. Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)
    - `identificationType` '11' | '12' | '13' | '21' | '22' | '31' | '41' | '42' | '47' | '50' | '91', required — Tipo de documento de identificación del receptor. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN
    - `identificationNumber` string, required — Número de identificación o NIT del receptor, sin guiones ni DV
    - `dv` string — DV del NIT del receptor. Es obligatorio si idNumberType = 31
    - `taxCode` '01' | '04' | 'ZA' | 'ZZ', required — Código tipo de impuesto según los códigos de la tabla de la DIAN.<br><br>"01" IVA<br>"04" INC<br>"ZA" IVA e INC<br>"ZZ" No aplica<br><br>Valor por default: "ZZ" No aplica
  - `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' — 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:<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.

## Response `200`

Objeto que representa la respuesta de la API cuando se emite un evento electronico a la DIAN

- object
  - `event` object
    - `id` string — Id del evento emitido
    - `type` object — Tipo de evento emitido
      - `code` string — Código del evento emitido
      - `value` string — Nombre del evento emitido
    - `date` string, date-time — Fecha de emisión del evento
    - `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED' — Estado legal del evento ante la DIAN
    - `companyIdentification` number — Identificación del emisor del evento
    - `cude` string — del documento electrónico del evento
    - `associatedDocumentId` string — Código único de la factura electrónica asociada al evento
    - `receiver` object — Información relacionada al receptor del documento
      - `id` string — Número de identificación o NIT del receptor, sin guiones ni DV
      - `name` string — Nombre o razón social del receptor
      - `identificationType` string — Tipo de organización jurídica. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN
      - `dv` string
    - `prefix` string — Prefijo del evento electrónico
    - `number` number, double — Número de evento electronico
    - `fullNumber` string — Número de nota débito electrónica (Incluye prefijo y número)
    - `governmentResponse` object — Objeto con información de la respuesta de la DIAN
      - `code` string — Código de respuesta de la DIAN
      - `message` string — Mensaje de respuesta de la DIAN
      - `errorMessages` string[] — Array con mensajes de error devueltos por la DIAN
    - `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT' — Estado del evento electrónico
  - `files` object
    - `xml` string — Link de descarga a el XML que se envia a la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento.
    - `attachedDocument` string — Link de descarga a el AttachedDocument obetenido como respuesta de al DIAN al enviar el archivo XML. Este campo solo se añade al tener una respuesta de la DIAN. Este enlace solo dura por 60 minutos, para renovar el link solicite nuevamente el documento.

## Other responses

- `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/versions/5fcb0d90e251/schema)