> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta detallada

El servicio permite a los usuarios consultar toda la información de una factura de venta específica a partir de su identificador único, en línea en formato JSON. La respuesta incluye el encabezado, los datos del cliente, los detalles con sus impuestos, los anexos, los terceros y los documentos referenciados.

El método de solicitud es POST y se requiere un encabezado "Authorization" para la autenticación, que debe contener un token **JWT** obtenido previamente del servicio de [autenticación](https://tech.sedierp.com/quickstart.md).

## Prerequisitos

Antes de realizar la consulta de una factura de venta individual, se debe contar con los siguientes datos:

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)
* Identificador único de la factura de venta (UniqueID) obtenido del servicio de consulta de facturas de venta

## Consultar factura de venta individual

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/FacturaVentaEspecificaConsultar\
**Tipo:** POST \
**Content Type:** application/json

**UniqueID** `GUID` *required*

Identificador único de la factura de venta.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/FacturaVentaEspecificaConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"UniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17"
}'
```

### Respuesta

El servicio retorna un objeto con la información completa de la factura de venta. Si no existe una factura con el `UniqueID` enviado, retorna un objeto vacío `{}`. A continuación se describen los campos principales; la respuesta incluye además campos de uso interno de la plataforma.

#### Encabezado

**FacturaID** `int`

Código único de la factura de venta (ID).

**UniqueID** `GUID`

Identificador único de la factura de venta.

**Prefijo** `string`

Prefijo de la resolución de la factura.

**Consecutivo** `int`

Consecutivo de la factura.

**TipoOperacionNombre** `string`

Nombre del tipo de operación de la factura.

**FechaCreacion** `datetime`

Fecha de creación de la factura.

**FechaVencimiento** `datetime`

Fecha de vencimiento de la factura. `FechaVencimiento2` y `FechaVencimiento3` contienen las fechas de vencimiento adicionales, si aplican.

**FormaPagoNombre** `string`

Nombre de la forma de pago.

**NumeroOrdenCompra** `string`

Número de la orden de compra.

**FechaOrdenCompra** `datetime`

Fecha de la orden de compra.

**AreaDepartamentoCliente** `string`

Área o departamento del cliente a donde se dirige el documento.

**Observaciones** `string`

Observaciones de la factura.

**IsAIU** `bool`

Indica si la factura es de tipo A.I.U.

**OrigenFacturaNombre** `string`

Nombre del origen de la factura.

**UsuarioNombreCompleto** `string`

Nombre del usuario que registró la factura.

**TipoFactura** `object`

Información de la resolución de facturación del documento.

**propiedades**

**Prefijo** `string`

Prefijo de la resolución.

**NumeroDecimales** `int`

Número de decimales configurado para los valores.

**NumeroDecimalesCantidad** `int`

Número de decimales configurado para las cantidades.

**DiasVencimientoFecha1** `int`

Días de vencimiento configurados en la resolución.

**Electronica** `bool`

Indica si la resolución es de facturación electrónica.

**Descripcion** `string`

Descripción de la resolución: prefijo, rango de numeración y número de resolución DIAN.

#### Estado

**EstadoFacturaNombre** `string`

Nombre del estado de la factura.

**EstadoDocumentoElectronicoID** `int`

Código del estado del documento electrónico ante la DIAN. Para resoluciones que no son de facturación electrónica retorna 1.

**EstadoDocumentoElectronicoNombre** `string`

Nombre del estado del documento electrónico ante la DIAN.

**CUFE** `string`

Código Único de Factura Electrónica.

**QR** `string`

Contenido del código QR de la factura electrónica.

**RespuestaFacturacionElectronica** `object`

Respuesta del proceso de facturación electrónica. Retorna un objeto vacío si no hay respuesta registrada.

**CausalRechazoFacturaNombre** `string`

Nombre de la causal de rechazo de la factura, si aplica.

**FechaAnulacion** `datetime`

Fecha de anulación de la factura, si aplica.

**ObservacionesAnulacion** `string`

Observaciones de la anulación, si aplica.

**AnulaUsuarioNombreCompleto** `string`

Nombre del usuario que anuló la factura, si aplica.

**IsEdicionFactura** `bool`

Indica si la factura aún puede ser editada.

#### Cliente

**NombreCompleto** `string`

Nombre completo o razón social del cliente. `Nombres`, `Nombres2`, `Apellidos` y `Apellidos2` contienen los nombres y apellidos por separado.

**TipoDocumentoNombre** `string`

Nombre del tipo de documento de identificación del cliente.

**Documento** `string`

Número de identificación del cliente.

**AbreviaturaDocumento** `string`

Tipo y número de identificación del cliente con formato (ej. "NIT. 900.123.456-7"). Para NIT incluye el dígito de verificación.

**Direccion** `string`

Dirección del cliente.

**Telefono** `string`

Teléfono del cliente.

**Celular** `string`

Celular del cliente.

**Email** `string`

Correo electrónico del cliente.

**EmailFacturacionElectronica** `string`

Correo electrónico del cliente para el envío de documentos electrónicos.

#### Valores

**ValorNeto** `decimal`

Valor neto de la factura (antes de impuestos).

**ValorImpuestos** `decimal`

Valor total de los impuestos y retenciones de la factura.

**MonedaAbreviatura** `string`

Código de la moneda de la factura. `MonedaNombre` y `MonedaSimbolo` contienen el nombre y el símbolo de la moneda.

**TasaCambio** `number`

Tasa de cambio, cuando la moneda es diferente al peso colombiano.

#### Entrega

**EntregaPersona** `string`

Nombre de la persona que recibe la entrega. `EntregaCelular` y `EntregaDireccion` contienen el celular y la dirección de entrega.

**PaisEntrega** `string`

Nombre del país de entrega. `EntregaPaisCodigoISO` contiene su código ISO (por defecto "co").

**CiudadEntrega** `string`

Nombre de la ciudad de entrega.

**TransportadorNombreCompleto** `string`

Nombre del transportador.

#### Detalles y relacionados

**FacturasDetalles** `array`

Detalles de la factura, ordenados por el campo `Orden`.

**propiedades**

**FacturaDetalleID** `int`

Código único del detalle (ID).

**ProductoCodigo** `string`

Código del concepto o producto.

**ProductoNombre** `string`

Descripción o nombre del concepto o producto.

**Cantidad** `number`

Cantidad del concepto o producto.

**ValorUnitario** `number`

Valor unitario del concepto o producto.

**Descuento** `number`

Valor del descuento.

**ValorTotal** `number`

Valor total del detalle.

**Orden** `int`

Orden del detalle (número de posición).

**AIU** `bool`

Indica si el detalle está marcado como A.I.U.

**MandanteNombreCompleto** `string`

Nombre del mandante del detalle, si aplica.

**CentroCostoNombre** `string`

Centro de costos del detalle, si aplica.

**Remesa** `object`

Información de la remesa del detalle: `RadicadoRemesa`, `NumeroRemesa`, `UnidadMedida`, `CantidadTransportada`, `ValorFlete` y `TipoServicio`.

**Impuestos** `array`

Impuestos y retenciones del detalle.

**propiedades**

**ImpuestoID** `int`

Código único del impuesto en la plataforma (ID).

**ImpuestoNombre** `string`

Nombre del impuesto o retención.

**Porcentaje** `number`

Porcentaje del impuesto o retención.

**ValorImpuesto** `number`

Valor del impuesto o retención, redondeado a 2 decimales.

**UnidadBaseImpuesto** `number`

Base del impuesto, cuando aplica (ej. el IVA como base de la ReteIVA).

**FacturasAnexos** `array`

Archivos anexos de la factura.

**propiedades**

**Nombre** `string`

Nombre del archivo anexo.

**Url** `string`

URL para visualizar o descargar el archivo anexo.

**FacturasTerceros** `array`

Terceros de la factura con su porcentaje de participación. Incluye al cliente principal.

**propiedades**

**TerceroID** `int`

Código único del tercero (ID).

**NombreCompleto** `string`

Nombre completo o razón social del tercero.

**Documento** `string`

Número de identificación del tercero.

**AbreviaturaDocumento** `string`

Tipo y número de identificación del tercero con formato.

**PorcentajeParticipacion** `number`

Porcentaje de participación del tercero.

**FacturasRecargosDescuentos** `array`

Recargos y descuentos generales de la factura: `TipoRecargoDescuentoNombre`, `Concepto` y `Valor`.

**FacturasDocumentosReferenciados** `array`

Documentos referenciados en la factura: `NumeroDocumento`, `FechaEmision` y `TipoDocumento`.

```json Request theme={null}
{
  "UniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17"
}
```

```json Response theme={null}
{
    "FacturaID": 15873,
    "OrigenFacturaID": 1,
    "TipoOperacionID": 2,
    "ClaseFacturaID": null,
    "Consecutivo": 1520,
    "TerceroID": 4521,
    "EstadoFacturaID": 0,
    "CausalRechazoFacturaID": null,
    "FechaCreacion": "2026-11-04T10:30:00",
    "FechaVencimiento": "2026-12-04T00:00:00",
    "FechaVencimiento2": null,
    "FechaVencimiento3": null,
    "ValorFecha1": 880500,
    "ValorFecha2": null,
    "ValorFecha3": null,
    "ValorFecha4": null,
    "CodigoBarras1": null,
    "CodigoBarras2": null,
    "CodigoBarras3": null,
    "CodigoBarras4": null,
    "UsuarioID": 37,
    "SucursalID": 1,
    "ValorNeto": 750000,
    "ValorImpuestos": 130500,
    "TasaCambio": null,
    "FechaTasaCambio": null,
    "SaldoAnterior": null,
    "Anticipo": null,
    "Observaciones": "Servicios prestados en octubre de 2026",
    "AnulaUsuarioID": null,
    "FechaAnulacion": null,
    "ObservacionesAnulacion": null,
    "TipoFacturaID": 3,
    "Ruta": null,
    "FondoRuta": null,
    "PreFacturaID": null,
    "PeriodoFacturacionID": null,
    "SancionesManuales": null,
    "CUFE": "12b4ce77d1b43d2b7199b286262198bf114d75b07158fe8dc595989d6b59180919f2f2285142f48128c0cecc8b200041",
    "QR": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=12b4ce77d1b43d2b7199b286262198bf114d75b07158fe8dc595989d6b59180919f2f2285142f48128c0cecc8b200041",
    "DIANKey": null,
    "RespuestaFacturacionElectronica": {},
    "RutaUBL": null,
    "RutaAttachedDocument": null,
    "Paga": null,
    "IsAIU": false,
    "UniqueID": "5d8e2f41-9c3a-4b7e-a1d2-6f0c8b3e9a17",
    "EmailID": null,
    "EstadoDocumentoElectronicoID": 2,
    "DispercionSMS": null,
    "IncluirSaldoAnterior": false,
    "NumeroOrdenCompra": "OC-345",
    "FechaOrdenCompra": "2026-10-28T00:00:00",
    "AreaDepartamentoCliente": "ADMINISTRACION",
    "CentroCostoID": null,
    "CiudadID": null,
    "EntregaPersona": null,
    "EntregaCelular": null,
    "EntregaDireccion": null,
    "EntregaPaisID": null,
    "EntregaCiudadID": null,
    "TransportadorTerceroID": null,
    "FormaPagoID": 2,
    "DocumentoContableID": null,
    "EstadoDocumentoContableID": null,
    "EntregaPaisCodigoISO": "co",
    "MonedaID": 1,
    "CodigoOrigen": null,
    "CodigoOrigenDescripcion": "API",
    "Prefijo": "FE",
    "OrigenFacturaNombre": "API",
    "EstadoFacturaNombre": "PENDIENTE",
    "EstadoDocumentoElectronicoNombre": "ACEPTADO",
    "FormaPagoNombre": "Crédito",
    "Nombres": "CLIENTE EJEMPLO S.A.S.",
    "Nombres2": null,
    "Apellidos": null,
    "Apellidos2": null,
    "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
    "Documento": "900123456",
    "Direccion": "CALLE 100 # 15-20",
    "Telefono": null,
    "Celular": "3001234567",
    "Email": "facturacion@clienteejemplo.com",
    "EmailFacturacionElectronica": "facturacion@clienteejemplo.com",
    "TipoDocumentoNombre": "NIT",
    "AbreviaturaDocumento": "NIT. 900.123.456-7",
    "UsuarioNombreCompleto": "CARLOS PEREZ GOMEZ",
    "AnulaUsuarioNombreCompleto": null,
    "CausalRechazoFacturaNombre": null,
    "MonedaNombre": "Peso colombiano",
    "MonedaSimbolo": "$",
    "MonedaAbreviatura": "COP",
    "IsEdicionFactura": false,
    "ClienteID": 2210,
    "CentroCostoNombre": null,
    "TipoOperacionNombre": "Estándar",
    "TransportadorNombreCompleto": null,
    "CiudadEntrega": null,
    "Ciudad": null,
    "PaisEntrega": null,
    "ClaseFacturaNombre": null,
    "TipoFactura": {
        "Prefijo": "FE",
        "NumeroDecimales": 2,
        "NumeroDecimalesCantidad": 2,
        "DiasVencimientoFecha1": 30,
        "Electronica": true,
        "Descripcion": "FE - 1 a 5000 - N°: 18764000000001"
    },
    "FacturasDetalles": [
        {
            "FacturaDetalleID": 88101,
            "ProductoID": null,
            "ProductoCodigo": "SRV-001",
            "ProductoNombre": "SERVICIO DE SOPORTE TECNICO",
            "Cantidad": 2,
            "ValorUnitario": 150000,
            "ValorDiario": null,
            "ValorTotal": 300000,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CodigoExterno": "1",
            "Orden": 1,
            "CentroCostoID": null,
            "Descuento": 0,
            "DescuentoNoGravado": 0,
            "MandanteTerceroID": null,
            "MandanteNombreCompleto": null,
            "UnidadTiempoNombre": null,
            "ProductoAbreviatura": null,
            "CentroCostoNombre": null,
            "AIU": false,
            "Remesa": {
                "RadicadoRemesa": null,
                "NumeroRemesa": null,
                "UnidadMedida": null,
                "CantidadTransportada": null,
                "ValorFlete": 300000,
                "TipoServicio": null
            },
            "Impuestos": [
                {
                    "FacturaDetalleImpuestoID": 50211,
                    "FacturaDetalleID": 88101,
                    "ImpuestoID": 1,
                    "UnidadBaseImpuesto": null,
                    "ValorImpuesto": 57000,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19,
                    "TipoImpuestoID": 1
                },
                {
                    "FacturaDetalleImpuestoID": 50212,
                    "FacturaDetalleID": 88101,
                    "ImpuestoID": 7,
                    "UnidadBaseImpuesto": null,
                    "ValorImpuesto": -12000,
                    "ImpuestoNombre": "RETEFUENTE SERVICIOS 4%",
                    "Porcentaje": 4,
                    "TipoImpuestoID": 2
                }
            ]
        },
        {
            "FacturaDetalleID": 88102,
            "ProductoID": null,
            "ProductoCodigo": "LIC-010",
            "ProductoNombre": "LICENCIA ANUAL MODULO CONTABLE",
            "Cantidad": 1,
            "ValorUnitario": 500000,
            "ValorDiario": null,
            "ValorTotal": 450000,
            "CantidadTiempo": null,
            "UnidadTiempoID": null,
            "FechaInicial": null,
            "FechaFinal": null,
            "CodigoExterno": "2",
            "Orden": 2,
            "CentroCostoID": null,
            "Descuento": 50000,
            "DescuentoNoGravado": 0,
            "MandanteTerceroID": null,
            "MandanteNombreCompleto": null,
            "UnidadTiempoNombre": null,
            "ProductoAbreviatura": null,
            "CentroCostoNombre": null,
            "AIU": false,
            "Remesa": {
                "RadicadoRemesa": null,
                "NumeroRemesa": null,
                "UnidadMedida": null,
                "CantidadTransportada": null,
                "ValorFlete": 450000,
                "TipoServicio": null
            },
            "Impuestos": [
                {
                    "FacturaDetalleImpuestoID": 50213,
                    "FacturaDetalleID": 88102,
                    "ImpuestoID": 1,
                    "UnidadBaseImpuesto": null,
                    "ValorImpuesto": 85500,
                    "ImpuestoNombre": "IVA 19%",
                    "Porcentaje": 19,
                    "TipoImpuestoID": 1
                }
            ]
        }
    ],
    "FacturasAnexos": [],
    "FacturasTerceros": [
        {
            "FacturaTerceroID": 9811,
            "TerceroID": 4521,
            "PorcentajeParticipacion": 100,
            "NombreCompleto": "CLIENTE EJEMPLO S.A.S.",
            "Documento": "900123456",
            "AbreviaturaDocumento": "NIT. 900.123.456-7"
        }
    ],
    "FacturasRecargosDescuentos": [],
    "FacturasDocumentosReferenciados": []
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.