API Endpoints

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

post
https://sandbox-api.alegra.com/e-provider/col/v1/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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto con el CUFE de la factura y la información mínima requerida para la emisión del evento

string
enum
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>

Allowed:
string

Id de la empresa. Id único generado por la API, se deberá enviar cuando el evento se genere diferente a la Company principal

string
required

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

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:

030: Acuse de recibo de Factura Electrónica de Venta
032: Recibo del bien o prestación del servicio

Campo oficial DIAN <IssuerParty>

string
enum

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"
01 Documento con inconsistencias
02 Mercancía no entregada
03 Mercancía entregada parcialmente
04 Servicio no prestado
Campo oficial DIAN <@listID en ResponseCode>

Allowed:
notes
array of strings

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

notes
email
object

Objeto para enviar un email de recepción de documento

Headers
uuid
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Llave que identifica una operación lógica, generada por el integrador. Cuando se envía, la API garantiza que la operación se ejecute a lo sumo una vez para esa llave: un reintento tras un timeout, un error de red o un fallo del cliente devuelve el resultado de la primera ejecución en lugar de emitir un segundo documento.

Debe ser un UUID versión 4 en su forma canónica con guiones. Cualquier otro valor se rechaza con 400. Se acepta en mayúsculas o minúsculas: la API normaliza a minúsculas, de modo que la misma llave escrita distinto sigue siendo la misma operación.

Genera una llave nueva por cada operación lógica, guárdala junto con la operación y reutilízala en todos los reintentos de esa misma operación. Reutilizar una llave con un cuerpo diferente devuelve 422.

La respuesta almacenada refleja el resultado de la petición original y no se actualiza después: para conocer el estado actual del documento usa el endpoint GET o el webhook.

Las llaves se conservan 7 días.

Responses

Updated 4 months ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago