Endpoint para emitir un evento relacionado a una factura electrónica
Changed onEndpoint para emitir un evento relacionado a una factura electrónico a partir de los datos recibidos en la petición
Request
- Base URLhttps://sandbox-api.alegra.com/e-provider/col/v1
- URLhttps://sandbox-api.alegra.com/e-provider/col/v1/events
- AuthHTTP bearer
Headers
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.
Request body
Response
Objeto que representa la respuesta de la API cuando se emite un evento electronico a la DIAN
Changes
- breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - info
added the new optional
headerrequest parameterIdempotency-Key - info
added the non-success response with the status
- info
added the non-success response with the status
- breaking