Factura

---

invoice

Tipo: Objeto

Objeto de una factura.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
code (Ver códigos)	string	2	No	Tipo de factura DIAN
format (Ver opciones)	string (Enum)	32	Sí	Formato PDF documento
emailSender	string	128	Sí	Remitente email
consecutive	int		No	Consecutivo de la factura
externalNumber	string	42	Sí	Número externo de la factura (Orden de compra)
currencyCode	string	3	No	Tipo de moneda
currencyRate (Obligatorio si hay un tipo de moneda extranjera)	number	18,6	No	Tasa de cambio
date	date		No	Fecha de expedición de la factura
dateDue	date		Sí	Fecha de vencimiento de la factura
dateStart	date		Sí	Fecha inicial del periodo de facturación
dateEnd	date		Sí	Fecha final del periodo de facturación
typeOfOperation (Ver códigos)	string	2	No	Tipo de operación
dueDiligence (Ver códigos)	string	2	Sí (No es nulable si se indica el tipo de operación 15 o 16)	Debida dilengencia para contol cambiario
incoterms (Requerido cuando es exportación)	string	3	Sí	Código de condición de entrega
deliveryTerms	string	800	Sí	Términos de entrega
terms	string	800	Sí	Términos y condiciones
remark	string	800	Sí	Pie de pagina
observation	string	800	Sí	Nota / Observación
termDay	int		Sí	Días del termino de pago (Si es pago a contado debe ser 0, si es crédito debe indicar el número de días)
paymentMeanCode (Ver códigos)	string	8	Sí	Código de medio de pago
branch (branch)	object		Sí	Objeto de la sucursal
resolution (resolution)	object		No	Objeto de la resolución
customer (customer)	object		No	Objeto del cliente
invoiceDetails (invoiceDetail)	array		No	Arreglo de objetos del detalle de la factura
totals (total)	object		No	Objeto de los totales de la factura
discounts (discount)	array		Sí	Arreglo de objetos de los descuentos
charges (charge)	array		Sí	Arreglo de objetos de los cargos
customFields (customFields)	array		Sí	Arreglo de objetos de los campos personalizados

branch

Tipo: Objeto

Sucursales de facturación, para indicar estos datos en lugar de los configurados por defecto para la empresa en el portal ISV.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
name	string	128	Sí	Nombre de la sucursal
address	string	64	Sí	Dirección de la sucursal
phone	string	32	Sí	Teléfono de la sucursal
countryCode	string	8	Sí	Código del país
countryName	string	48	Sí	Nombre del país
departamentCode	string	8	Sí	Código del departamento
departamentName	string	48	Sí	Nombre del departamento
cityCode	string	8	Sí	Código de la ciudad
cityName	string	48	Sí	Nombre de la ciudad

resolution

Tipo: Objeto

Datos de la resolución de facturación electrónica expedida por la DIAN.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
resolutionKey	string	256	No	Clave técnica de resolución de numeración de la DIAN
resolutionPrefix	string	8	No	Prefijo del de numeración autorizado por la DIAN
resolutionNumber	int		No	No. de la resolución
resolutionRangeInitial	int		No	Rango inicial de facturación
resolutionRangeFinal	int		No	Rango final de facturación
resolutionValidFrom	date		No	Fecha inicial de validación de facturación
resolutionValidUntil	date		No	Fecha final de validación de facturación

customer

Tipo: Objeto

Detalles del cliente.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
companyName	string	128	No	Razón social o nombre completo
personType (Ver códigos)	string	2	No	Tipo de persona
regimeType (Ver códigos)	string	2	No	Tipo de régimen
firstName	string	80	No	Nombres
lastName	string	80	No	Apellidos
identification	string	24	No	Numero de identificación
digitCheck	string	1	No	Dígito de verificación
identificationTypeCode	string	4	No	Tipo de identificación
email	string	160	Sí	Email
phone	string	24	Sí	Teléfono
merchantRegistration	string	16	Sí	Registro mercantil
responsibilities	string	500	No	Responsabilidades fiscales
responsibleFor (Ver códigos)	string	12	Sí	Responsabilidad Fiscal
economicActivities	string	500	Sí	Actividades económicas (Separadas por punto y coma) e.g: "2920;2825;2817"
billingAddress	string	128	Sí	DATO DE FACTURACIÓN - Dirección
billingCountryName	string	48	Sí	DATO DE FACTURACIÓN - Nombre del país
billingCountryCode	string	8	No	DATO DE FACTURACIÓN - Código del país
billingRegionName	string	48	Sí	DATO DE FACTURACIÓN - Nombre de la región
billingRegionCode	string	8	No	DATO DE FACTURACIÓN -Código de la región
billingCityName	string	48	Sí	DATO DE FACTURACIÓN - Nombre de la ciudad
billingCityCode	string	8	Sí	DATO DE FACTURACIÓN - Código de la ciudad
billingPostalCode	string	16	Sí	DATO DE FACTURACIÓN - Código postal
billingNeighborhood	string	40	Sí	DATO DE FACTURACIÓN - Barrio
billingPhone	string	24	Sí	DATO DE FACTURACIÓN - Teléfono
billingContactName	string	160	Sí	DATO DE FACTURACIÓN - Nombre contacto
shippingAddress	string	128	Sí	DATO DE ENTREGA - Dirección
shippingCountryName	string	48	Sí	DATO DE ENTREGA - Nombre del país
shippingCountryCode	string	8	Sí	DATO DE ENTREGA - Código del país
shippingRegionName	string	48	Sí	DATO DE ENTREGA - Nombre de la región
shippingRegionCode	string	8	Sí	DATO DE ENTREGA - Código de la región
shippingCityName	string	48	Sí	DATO DE ENTREGA - Nombre de la ciudad
shippingCityCode	string	8	Sí	DATO DE ENTREGA - Código de la ciudad
shippingPostalCode	string	16	Sí	DATO DE ENTREGA - Código postal
shippingNeighborhood	string	40	Sí	DATO DE ENTREGA - Barrio
shippingPhone	string	24	Sí	DATO DE ENTREGA - Teléfono
shippingContactName	string	160	Sí	DATO DE ENTREGA - Nombre contacto

invoiceDetail

Tipo: Objeto

Detalle de la factura.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
standardType (Ver códigos)	string	3	Sí	Tipo de código estándar DIAN
standardCode	string	64	Sí	Código estándar DIAN
itemCode	string	32	No	Código del producto o servicio
itemName	string	200	No	Nombre del producto o servicio
itemModel	string	32	Sí	Modelo del producto o servicio
description	string	1024	No	Descripción de la venta
brandName	string	64	Sí	Marca del producto o servicio
itemCodeSupplier	string	32	Sí	Código del producto colocado por el proveedor
isPresent	boolean	1	No	Indica si el producto es un obsequio y por tanto el precio es cero
isRemmitance	boolean	1	Sí	Indica si el producto o servicio es una remesa (Sólo para sector de transportes)
remmitanceNumber	string	32	Sí	Número de Radicación de la Remesa entregado por el RNDC (Obligatorio para sector transportes)
remmitanceConsecutive	string	23	Sí	Nro. del consecutivo de la Remesa según codificación interna de cada empresa (Obligatorio para sector transportes)
RemmitanceValue	int		Sí	Valor del flete a cobrar por el servicio de transporte de la remesa. (Obligatorio para sector transportes)
remmitanceQuantityValue	int		Sí	Valor de cantidad de la carga transportada, debe ser un entero (sin decimales).
remmitanceMeasurementUnit (Ver códigos)	string	3	Sí	Unidad de medida de la carga transportada
unitMeasurementCode	string	4	No	Código de unidad de medida del producto o servicio (NIU por defecto)
unitMeasurementName	string	64	Sí	Nombre de unidad de medida del producto o servicio
price	number	18,6	No	Precio unitario del producto o servicio
quantity	number	18,6	No	Cantidad del producto o servicio
discounts (discount)	array		Sí	Descuentos sobre los items (Productos o servicios)
charges (charge)	array		Sí	Cargos adicionales sobre los items (Productos o servicios)
taxes (tax)	array		Sí	Impuestos sobre los items (Productos o servicios)
withholdings (tax)	array		Sí	Retenciones sobre los items (Productos o servicios)
isvMandante (mandante)	object		Sí	Mandante en caso de pago a terceros

discount

Tipo: Arreglo de objetos

Descuentos. Ten en cuenta que si vas a realizar descuentos sobre la factura no puedes realizarlos sobre el detalle, es decir, sobre cada producto o servicio facturado.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
name	string	40	Sí	Nombre del descuento
type	string	1	No	Tipo de valor (V: Valor Fijo, P: Porcentaje)
rate	number	18,2	No	Tarifa del descuento (porcentaje o valor)
amount	number	18,2	No	Valor del descuento

charge

Tipo: Arreglo de objetos

Cargos sobre la factura, ten en cuenta que si vas a realizar cargos sobre la factura no puedes realizarlos sobre el detalle, es decir, sobre cada producto o servicio facturado.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
name	string	40	Sí	Nombre del cargo
type	string	1	No	Tipo de valor (V: Valor Fijo, P: Porcentaje)
rate	number	18,6	No	Tarifa del cargo (porcentaje o valor)
amount	number	18,6	No	Valor del cargo

tax

Tipo: Arreglo de objetos

Impuestos sobre el item, producto o servicio facturado. Estos impuestos son por unidad facturada, no los calcules por cantidad.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
name	string	64	No	Nombre del impuesto
code	string	8	No	Código del impuesto
type	string	1	No	Tipo del impuesto (V: Valor Fijo, P: Porcentaje, M: Tarifa x1000)
rate	number	18,6	No	Tarifa o Porcentaje
amount	number	18,6	No	Valor con cada cantidad

mandante

Tipo: Objeto

Datos del mandante en caso de pago a terceros.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
name	string	128	No	Razón social o nombre
identification	string	24	No	Número de identificación
digitCheck	string	1	No	Dígito de verificación
identificationTypeCode	string	4	No	Tipo de identificación

total

Tipo: Objeto

Totales de la factura.

Campo	Tipo	Longitud	¿Es opcional?	Descripción
amount	number	18,6	No	Total de la factura sin impuestos ni retenciones
prepaymentAmount	number	18,6	No	Valor anticipado aplicado a la factura

customFields

Tipo: Arreglo de objetos

Campos personalizados. Por ejemplo, puedes enviar la llave de control interno de tus factura. Estos campos no son enviados a la DIAN son de utilidad únicamente para el integrador.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
key	string	64	Sí	Llave del campo
value	string	64	Sí	Valor del campo