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
- 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/FacturaVentaEspecificaConsultarTipo: POST
Content Type: application/json
GUID
required
Identificador único de la factura de venta.
Respuesta
El servicio retorna un objeto con la información completa de la factura de venta. Si no existe una factura con elUniqueID 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
int
Código único de la factura de venta (ID).
GUID
Identificador único de la factura de venta.
string
Prefijo de la resolución de la factura.
int
Consecutivo de la factura.
string
Nombre del tipo de operación de la factura.
datetime
Fecha de creación de la factura.
datetime
Fecha de vencimiento de la factura.
FechaVencimiento2 y FechaVencimiento3 contienen las fechas de vencimiento adicionales, si aplican.string
Nombre de la forma de pago.
string
Número de la orden de compra.
datetime
Fecha de la orden de compra.
string
Área o departamento del cliente a donde se dirige el documento.
string
Observaciones de la factura.
bool
Indica si la factura es de tipo A.I.U.
string
Nombre del origen de la factura.
string
Nombre del usuario que registró la factura.
object
Información de la resolución de facturación del documento.
Estado
string
Nombre del estado de la factura.
int
Código del estado del documento electrónico ante la DIAN. Para resoluciones que no son de facturación electrónica retorna 1.
string
Nombre del estado del documento electrónico ante la DIAN.
string
Código Único de Factura Electrónica.
string
Contenido del código QR de la factura electrónica.
object
Respuesta del proceso de facturación electrónica. Retorna un objeto vacío si no hay respuesta registrada.
string
Nombre de la causal de rechazo de la factura, si aplica.
datetime
Fecha de anulación de la factura, si aplica.
string
Observaciones de la anulación, si aplica.
string
Nombre del usuario que anuló la factura, si aplica.
bool
Indica si la factura aún puede ser editada.
Cliente
string
Nombre completo o razón social del cliente.
Nombres, Nombres2, Apellidos y Apellidos2 contienen los nombres y apellidos por separado.string
Nombre del tipo de documento de identificación del cliente.
string
Número de identificación del cliente.
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.
string
Dirección del cliente.
string
Teléfono del cliente.
string
Celular del cliente.
string
Correo electrónico del cliente.
string
Correo electrónico del cliente para el envío de documentos electrónicos.
Valores
decimal
Valor neto de la factura (antes de impuestos).
decimal
Valor total de los impuestos y retenciones de la factura.
string
Código de la moneda de la factura.
MonedaNombre y MonedaSimbolo contienen el nombre y el símbolo de la moneda.number
Tasa de cambio, cuando la moneda es diferente al peso colombiano.
Entrega
string
Nombre de la persona que recibe la entrega.
EntregaCelular y EntregaDireccion contienen el celular y la dirección de entrega.string
Nombre del país de entrega.
EntregaPaisCodigoISO contiene su código ISO (por defecto “co”).string
Nombre de la ciudad de entrega.
string
Nombre del transportador.
Detalles y relacionados
array
Detalles de la factura, ordenados por el campo
Orden.array
Archivos anexos de la factura.
array
Terceros de la factura con su porcentaje de participación. Incluye al cliente principal.
array
Recargos y descuentos generales de la factura:
TipoRecargoDescuentoNombre, Concepto y Valor.array
Documentos referenciados en la factura:
NumeroDocumento, FechaEmision y TipoDocumento.