Referencia de recepción

Esta página reúne las estructuras y los códigos que comparten los métodos de recepción de documentos y eventos.

Documento recibido (DocumentRecepcionType)

Lo devuelven ExtraerRecepcion y ExtraerDocumentoRecepcion en el campo documentos.

Campo	Descripción	Obligatorio	Observaciones
idSegmento	Identificador del periodo del documento.	Sí	Año y mes en que se emitió el documento, en formato yyyyMM (por ejemplo, 202209).
tipoTransaccion	Tipo de transacción.	Sí	FAC: factura electrónica. NCR: nota crédito. NDB: nota débito.
numeroTransaccion	Número del documento electrónico.	Sí	Prefijo y numeración del documento.
fechaEmision	Fecha de emisión.	Sí	Fecha en que fue emitido el documento electrónico.
fechaHoraIngreso	Fecha de ingreso a la plataforma.	Sí	Fecha y hora en que el sistema registró el documento.
codigoTransaccion	CUFE o CUDE del documento electrónico.	Sí
identProveedor	Número de identificación del proveedor del documento.	Sí
nombreProveedor	Nombre o razón social del proveedor.	Sí
correoElectronico	Correo electrónico del proveedor registrado en el XML.	Sí
monto	Valor total del documento electrónico.	Sí	Valor del documento registrado en el XML.
TotalImporteBruto	Subtotal de la factura antes de impuestos.	Sí	Total antes de impuestos registrado en el XML.
TotalCargos	Total de los recargos efectuados.	Sí	Total de los recargos registrados en el XML.
TotalDescuentos	Total de descuentos del documento.	Sí	Total de descuentos aplicados al documento y registrados en el XML.
TotalBaseImponible	Sumatoria de las bases imponibles del documento.	Sí	Total de las bases gravables reportadas en el XML.
TotalAnticipos	Total de anticipos del documento.	Sí	Total de los anticipos registrados en el XML.
vlrBrutoImpuesto	Subtotal más impuestos.	Sí	Valor bruto más impuestos registrados en el XML.
TotalIVA	Total del IVA.	Sí	Valor total del IVA reportado en el XML.
esRecibido	Indica si el documento ya tiene todos los eventos de recepción y, por tanto, es título valor.	Sí	Ver Estado de recepción del documento.
comentarioRecibido	Razón del rechazo, cuando el documento fue rechazado.	No
fechaHoraRecibido	Fecha y hora en que se registró el evento de aceptación expresa o rechazo.	No
esContado	Indica si el documento es de contado o a crédito.	Sí	true: contado. false: crédito.
eventos	Códigos de los eventos registrados para el documento.	Sí	Lista separada por punto y coma, por ejemplo "02;030;032". Ver Códigos de evento.

Estado de recepción del documento

Los campos esRecibido y comentarioRecibido determinan el estado de la recepción:

esRecibido	comentarioRecibido	Estado
true	—	Documento recibido (título valor).
false	null	Documento en proceso; aún no tiene todos los eventos de recepción.
false	Razón del rechazo	Documento rechazado.

Evento del documento (EventoDocumentoType)

Lo devuelve ExtraerEventosRecepcion en el campo eventos. Los eventos de documentos emitidos tienen su propia estructura; ver ExtraerEventosEmision.

Campo	Descripción	Obligatorio	Observaciones
idSegmento	Identificador del periodo del documento.	Sí	Año y mes en que se emitió el documento, en formato yyyyMM (por ejemplo, 202209).
tipoTransaccion	Tipo de transacción.	Sí	R_FAC: factura electrónica. R_NCR: nota crédito. R_NDB: nota débito.
numeroTransaccion	Número del evento.	Sí	Prefijo y numeración.
fechaEmision	Fecha de emisión.	Sí	Fecha en que fue emitido el documento electrónico.
codigoTransaccion	CUDE del evento.	Sí
estado	Estado del proceso del evento.	Sí	ÉXITO: evento procesado correctamente. PROCE: el evento se encuentra en proceso. ERROR: el evento generó un error o fue rechazado por la DIAN.
fechaHoraIngreso	Fecha de ingreso a la plataforma.	Sí	Fecha y hora en que el sistema registró el documento.
fechaHoraEnvioAutoridad	Fecha de envío a la DIAN.	Sí
fechaHoraUltProceso	Fecha de la última actualización del evento.	Sí
XML	XML del evento (ApplicationResponse).	Sí
codigoEvento	Código del evento.	Sí	Ver Códigos de evento.
descripcionEvento	Descripción del evento.	Sí
tipoRechazo	Tipo de rechazo, cuando el evento es 031.	No	Ver Tipos de rechazo.
nombreRechazo	Descripción del rechazo, cuando el evento es 031.	No

Códigos de evento

Código	Descripción	Generado por
02	Documento validado por la DIAN.	DIAN
04	Documento rechazado por la DIAN.	DIAN
030	Acuse de recibo del documento.	Receptor
031	Reclamo o rechazo.	Receptor
032	Recibo del bien o prestación del servicio.	Receptor
033	Aceptación expresa.	Receptor
034	Aceptación tácita.	Emisor

Jerarquía de los eventos

Antes de generar un evento verifica el último evento registrado del documento. La generación sigue esta jerarquía:

Código	Evento	Generado por	Requisitos y efecto
02	Documento validado por la DIAN	DIAN	El documento fue aprobado. Es requisito para cualquier otro evento.
04	Documento rechazado por la DIAN	DIAN	El documento fue rechazado; no es posible generar más eventos.
030	Acuse de recibo del documento	Receptor	La factura fue recibida. Es requisito para los demás eventos.
032	Recibo del bien o prestación del servicio	Receptor	El comprador da fe de haber recibido el producto o servicio. Es requisito para 031, 033 o 034. Desde este evento, el comprador tiene 72 horas hábiles para aceptar o rechazar la factura.
033	Aceptación expresa	Receptor	La factura es aceptada y se convierte en título valor. Requiere 030 y 032.
031	Reclamo o rechazo	Receptor	La factura tiene algún error y es rechazada. Requiere 030 y 032 y un tipo de rechazo.
034	Aceptación tácita	Emisor	Si pasan más de 72 horas hábiles desde el evento 032 sin aceptación ni rechazo, el emisor puede generar la aceptación tácita. Ver Aceptación tácita (evento 034).

Los eventos del receptor se generan con GenerarEvento (uno a uno) o con GenerarEventosCompletos (genera 030 y 032 automáticamente antes de 033 o 031).

Tipos de rechazo

Aplican cuando el código del evento es 031 (reclamo o rechazo).

Código	Descripción
01	Documento con inconsistencias.
02	Mercancía no entregada totalmente.
03	Mercancía no entregada parcialmente.
04	Servicio no prestado.