ALalegra
Eventos electrónicos

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

Changed on

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.

post/events/from-cufe

Request

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

Parameters

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

Request body

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 <ResponseCode></i>

companyIdstring

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

numberstring required

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

uuidstring required

CUFE de la factura a la que se le asociará el evento

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 <@listID en ResponseCode></i>

notesstring[]

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

Response

(unresolved $ref)

Changes

  • 2bc52ab55c2bRevision 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