Endpoint para emitir un evento relacionado a una factura electrónica a partir de su AttachedDocument

Changed on Nov 3, 2026

Endpoint para emitir un evento relacionado a una factura electrónica a partir del documento XML AttachedDocument que se genera con la factura, el contenido del XML debe ser enviado en base64 junto con los datos extra requeridos en cada evento

post/events/from-xml

Request

Base URL
https://sandbox-api.alegra.com/e-provider/col/v1
URL
https://sandbox-api.alegra.com/e-provider/col/v1/events/from-xml
Auth
HTTP bearer

Parameters

#/paths/~1events/post/parameters/0 (unresolved $ref)

Request body

numberstring required

Número del evento que se emite, el valor es alfanumérico y único por evento dentro de la misma compañía

type'030' | '031' | '032' | '033' | '034' required

Código del tipo de evento, este elemento acepta una de las siguientes opciones: 030 Acuse de recibo de Factura Electrónica de Venta 031 Reclamo de la Factura Electrónica de Venta 032 Recibo del bien o prestación del servicio 033 Aceptación expresa 034 Aceptación Tácita Campo oficial DIAN <ResponseCode>

xmlContentstring required

Contenido en bas64 del XML AttachedDocument de la factura electrónica

claimCode'01' | '02' | '03' | '04'

Código motivo de rechazo, este elemento acepta una de las siguientes opciones: 01 Documento con inconsistencias 02 Mercancía no entregada 03 Mercancía entregada parcialmente 04 Servicio no prestado Campo oficial DIAN <@listID en ResponseCode>

notesstring[]

Información adicional que se quiera agregar en el evento Campo oficial DIAN <Note>

Response

(unresolved $ref)

Changes

Nov 3, 20262bc52ab55c2b Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- info
  added the new optional header request parameter Idempotency-Key
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history