Registra un evento RADIAN sobre una factura recibida

POST/api/v1/documents/events

Eventos de la factura electrónica (Anexo 1.9, 6.5): 030 acuse de recibo, 031 reclamo (con claim_code 01 a 04), 032 recibo del bien o prestación del servicio, 033 aceptación expresa y 034 aceptación tácita (la registra el emisor). La cuenta es quien genera el evento; issuer es el emisor de la factura. La DIAN responde en el momento (SendEventUpdateStatus). Con key de pruebas se simula. No requiere estar registrado como participante de RADIAN.

Cuerpo de la petición application/json

Montos, cantidades y tarifas van como texto decimal: "5000.00", "19".

event_codestringobligatorio
Valores: 030 · 031 · 032 · 033 · 034
claim_codestring
Solo 031: 01 documento con inconsistencias, 02 mercancía no entregada totalmente, 03 mercancía no entregada parcialmente, 04 servicio no prestado
Valores: 01 · 02 · 03 · 04
documentobjectobligatorio
+ Ver 2 campos− Ocultar 2 campos
- numberstringobligatorio
  Ejemplo: SETP990000021
- cufestringobligatorio
  CUFE de la factura (96 caracteres)
issuerobjectobligatorio
+ Ver 11 campos− Ocultar 11 campos
- person_typeinteger
  1 jurídica, 2 natural
  Valores: 1 · 2
- document_typestringobligatorio
  13 cédula, 31 NIT, 22 cédula de extranjería, 41 pasaporte...
  Ejemplo: 13
- document_numberstringobligatorio
  Ejemplo: 1020304050
- dvstring
- namestringobligatorio
  Ejemplo: Ana Pérez
- trade_namestring
- emailstring
- phonestring
- addressobject
  + Ver 8 campos− Ocultar 8 campos
  - linestring
    Ejemplo: Cra 7 # 71-21
  - city_codestring
    DIVIPOLA del municipio (5 dígitos)
    Ejemplo: 11001
  - city_namestring
    Ejemplo: Bogotá, D.C.
  - department_codestring
    DIVIPOLA del departamento (2 dígitos)
    Ejemplo: 11
  - department_namestring
    Ejemplo: Bogotá
  - postal_zonestring
  - country_codestring
    ISO 3166-1; vacío = CO
  - country_namestring
- tax_level_codesarray<string>
- tax_schemestring
  Ejemplo: ZZ
personobject
Quien registra el evento por la empresa; obligatorio salvo en 034
+ Ver 6 campos− Ocultar 6 campos
- document_typestring· por defecto 13
- document_numberstringobligatorio
- first_namestringobligatorio
- family_namestringobligatorio
- job_titlestring
- departmentstring

Respuestas

201Evento registrado (o rechazado por la DIAN, ver status)

idstring · uuid
numberstring
Ejemplo: EV1
event_codestring
Ejemplo: 030
descriptionstring
claim_codestring
document_numberstring
cufestring
issuer_idstring
issuer_namestring
cudestring
stagingboolean
statusstring
Valores: accepted · rejected
dianobject
+ Ver 4 campos− Ocultar 4 campos
- status_codestring
- status_descriptionstring
- errorsarray<string>
- rulesarray<object>
created_atstring · date-time

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring