> For the complete documentation index, see [llms.txt](https://factura-electronica.aliaddo.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://factura-electronica.aliaddo.dev/primeros-pasos/estructura-de-los-datos/factura.md). # Factura ## Ejemplo ```javascript { "code": "01", "format": "Estandar", "emailSender": "", "consecutive": "990004322", "externalNumber": "", "currencyCode": "COP", "currencyRate": 0, "date": "2020-1-23", "dateDue": "2020-1-29", "dateStart": "2020-1-23", "dateEnd": "2020-1-29", "typeOfOperation": "10", "dueDiligence": "", "incoterms": "", "deliveryTerms": "", "terms": "", "remark": "", "observation": "", "termDay": 0, "paymentMeanCode": "48", "branch": { "name": "", "address": "", "phone": "", "countryCode": "", "countryName": "", "departamentCode": "", "departamentName": "", "cityCode": "", "cityName": "" }, "resolution": { "resolutionKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c", "resolutionPrefix": "SETT", "resolutionNumber": "18760000001", "resolutionRangeInitial": "990000000", "resolutionRangeFinal": "995000000", "resolutionValidFrom": "2019-01-19", "resolutionValidUntil": "2030-01-19" }, "customer": { "companyName": "Customer", "personType": "1", "regimeType": "04", "firstName": "Customer", "lastName": "Customer", "identification": "000000001", "digitCheck": "8", "identificationTypeCode": "13", "email": "email@email.com", "phone": "", "merchantRegistration": "", "responsibleFor": "ZZ", "responsibilities": "R-99-PN", "economicActivities": "2824;2920", "billingAddress": "KR con Calle", "billingCountryName": "Colombia", "billingCountryCode": "CO", "billingRegionName": "Cundinamarca", "billingRegionCode": "25", "billingCityName": "Chipaque", "billingCityCode": "25178", "billingPostalCode": "", "billingNeighborhood": "", "billingPhone": "", "billingContactName": "", "shippingAddress": "", "shippingCountryName": "", "shippingCountryCode": "", "shippingRegionName": "", "shippingRegionCode": "", "shippingCityName": "", "shippingCityCode": "", "shippingPostalCode": "", "shippingNeighborhood": "", "shippingPhone": "", "shippingContactName": "" }, "invoiceDetails": [{ "standardType": "", "standardCode": "", "itemCode": "0001", "itemName": "Item", "itemModel": "", "description": "Item prueba", "brandName": "", "itemCodeSupplier": "", "isPresent": false }], "charges": [{ "name": "Servicio", "type": "P", "rate": 10, "amount": 1000 }], "tip": { "base": 10000, "rate": 10, "amount": 1000 } } ``` ## Estructura ### invoice Tipo: Objeto Objeto de una factura.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
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
tip (tip)	object		Sí	Objeto de la propina (ChargeIndicator=true, AllowanceChargeReasonCode=03)
currencyExchange (Ver currencyExchange)	object		Sí (Obligatorio si typeOfOperation es 15 o 16 — declaración cambiaria DIAN Res. 000210/2025)	Objeto de declaración de operación de cambio (compra/venta de divisas)
customFields (customFields)	array		Sí	Arreglo de objetos de los campos personalizados

### branch Tipo: Objeto Sucursales de facturación, para colocar estos datos a cambio de los de la empresa configurados en el portal ISV.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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, para generar la resolución por favor ver vídeo: .

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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	string	12	Sí	Responsable de... Ver códigos
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	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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

{% hint style="warning" %} Los **descuentos y cargos** pueden ser sobre los items o sobre la factura **pero no sobre ambos**. Si agregas los descuentos y cargos en el detalle serán calculados **sobre los items de la factura**, de lo contrario (si son agregados directamente en el objeto de la factura), serán calculados **sobre la factura en general**. {% endhint %} ### discount Tipo: Arreglo de objetos Descuentos **sobre la factura**, tenga en cuenta que **si va a realizar descuentos sobre la factura no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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**, tenga en cuenta que **si va a realizar cargos sobre la factura no se pueden realizar sobre el detalle** o sobre cada producto o servicio facturado.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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

### tip Tipo: Objeto Propina de la factura. Se envía como cargo DIAN con `ChargeIndicator=true`, `AllowanceChargeReasonCode=03` y `AllowanceChargeReason="Propina"`. La tarifa máxima permitida es 10%.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
base	number	18,6	No	Monto base sobre el cual se calcula la propina
rate	number	18,6	No	Tarifa de la propina, en porcentaje (máximo 10)
amount	number	18,6	No	Monto total de la propina, calculado según la tarifa

### tax Tipo: Arreglo de objetos Impuestos sobre el item, producto o servicio facturado estos impuestos tenga en cuenta que **son por unidad facturada, no lo calcule por la cantidad**.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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 x 1000)
rate	number	18,6	No	Tarifa o Porcentaje
amount	number	18,6	No	Valor con cada cantidad

### mandante Tipo: Objeto Datos del mandante.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	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 Valores personalizados, puedes enviar por ejemplo la key interna de tu factura, "Estos campos no son enviados a la DIAN son de utilidad únicamente para el integrador".

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

### currencyExchange Tipo: Objeto Declaración de operación de cambio (compra/venta de divisas), exigida por la Resolución DIAN 000210/2025 para operadores de casas de cambio. Se envía únicamente cuando `typeOfOperation` es `15` (compra) o `16` (venta); si no se envía en ese caso, la extensión UBL de cambio no se adjunta a la factura.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
beneficiaryParty (Ver exchangeParty)	object		No	Persona que origina la compra/venta de divisas (Formulario 18 "Identificación del beneficiario")
declarantParty (Ver exchangeParty)	object		No	Persona que firma la declaración; igual a beneficiaryParty si el beneficiario declara directamente
declarationData (Ver declarationData)	object		No	Datos de la operación de cambio
exchangeProfessionalParty (Ver exchangeProfessionalParty)	object		No	Datos de la casa de cambio que realiza la operación
customerDueDiligence (Ver customerDueDiligence)	object		No	Debida diligencia del cliente, exigida por el Art. 18 de la Res. DIAN 000210/2025

### exchangeParty Tipo: Objeto Reutilizado para `beneficiaryParty` y `declarantParty`. **Resolución de dirección:** se usa `address` si se envía; si no, se arma con los campos planos (`addressLine`, `cityName`, `cityCode`/`municipalityCode`, `department`, `departmentCode`, `countryCode`, `countryName`). Si `beneficiaryParty` o `declarantParty` no traen ninguna dirección (ni `address` ni campos planos con código DANE), se usa automáticamente la dirección de `customerDueDiligence.customer` como *fallback*. Este fallback no aplica a `exchangeProfessionalParty`.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
additionalAccountID	string	-	No	Tipo de persona (Tabla 5): 1 jurídica, 2 natural
documentType	string	-	No	Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP
documentNumber	string	-	No	Número de documento (solo dígitos)
schemeId	string	-	Sí (requerido si documentType = 31)	Esquema de identificación; valor `1` = NIT con dígito de verificación
name	string	-	No	Nombre completo o razón social
addressLine	string	-	Sí	Dirección en texto libre; usado solo si `address` no se envía
cityName	string	-	Sí	Ciudad; usado solo si `address` no se envía
cityCode	string	5	Sí	Código DANE de municipio; usado solo si `address` no se envía. Alias: `municipalityCode`
municipalityCode	string	5	Sí	Código DANE de municipio; alias de `cityCode`. Usado solo si `address` no se envía
department	string	-	Sí	Nombre del departamento; usado solo si `address` no se envía
departmentCode	string	2	Sí	Código DANE de departamento; usado solo si `address` no se envía
countryCode	string	-	Sí	Código ISO 3166-1 alpha-2; usado solo si `address` no se envía
countryName	string	-	Sí	Nombre del país; usado solo si `address` no se envía
birthDate	string (fecha)	-	Sí (solo persona natural, additionalAccountID=2)	Fecha de nacimiento, formato yyyy-MM-dd
birthPlace	string	-	Sí (solo persona natural, additionalAccountID=2)	Lugar de nacimiento
economicActivityName	string	-	Sí	Descripción CIIU de la actividad económica
economicActivityId	string	-	Sí (requerido para persona jurídica)	Código CIIU Rev. 4, ej. 3415, 6492, 6619
telephone	string	-	Sí	Teléfono
email	string	-	Sí	Correo electrónico
address (Ver exchangeAddress)	object		Sí	Dirección estructurada; tiene prioridad sobre addressLine/cityName si se envía
shareholders (Ver shareholder)	array		Sí (requerido si additionalAccountID=1, persona jurídica; omitir o vacío para persona natural)	Arreglo de socios/accionistas

### shareholder Tipo: Arreglo de objetos Socios o accionistas de una persona jurídica. Solo se reportan socios con participación igual o superior al 25%.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
name	string	-	No	Nombre completo del socio
documentType	string	-	No	Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP
documentNumber	string	-	No	Número de documento
sharePercentage	number	-	No	Porcentaje de participación accionaria (solo se reportan socios ≥25%)

### exchangeAddress Tipo: Objeto Dirección estructurada, reutilizada en `beneficiaryParty`, `declarantParty`, `exchangeProfessionalParty` y `customer` (dentro de `customerDueDiligence`).

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
municipalityCode	string	5	Sí	Código DANE de municipio, ej. 11001 Bogotá, 05001 Medellín, 76001 Cali
cityName	string	-	Sí	Nombre de ciudad según catálogo DANE
department	string	-	Sí	Nombre del departamento, ej. Bogotá D.C., Antioquia
departmentCode	string	2	Sí	Código DANE de departamento, ej. 11 Bogotá, 05 Antioquia, 76 Valle del Cauca
addressLine	string	-	Sí	Dirección en texto libre
countryCode	string	-	Sí	Código ISO 3166-1 alpha-2; si se omite, se aplica por defecto `CO`
countryName	string	-	Sí	Nombre del país; si se omite, se aplica por defecto `Colombia`

### exchangeProfessionalParty Tipo: Objeto Datos de la casa de cambio (siempre persona jurídica).

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
additionalAccountID	string	-	No	Siempre `1` (persona jurídica)
documentType	string	-	No	Siempre `31` (NIT)
documentNumber	string	-	No	NIT sin dígito de verificación
schemeId	string	-	No	Siempre `1`
name	string	-	No	Razón social de la casa de cambio
telephone	string	-	Sí	Teléfono(s); puede contener varios números en texto libre
chamberOfCommerceCity	string	-	Sí	Ciudad de la cámara de comercio, ej. Bogotá, Medellín, Cali
chamberOfCommerceCode	string	-	Sí	Código de cámara de comercio: 04 Bogotá, 06 Medellín, 09 Cali, 08 Barranquilla, 13 Bucaramanga, 15 Cartagena, 17 Cúcuta, 23 Pereira, 24 Manizales
commercialRegistration	string	-	Sí	Matrícula mercantil
addressLine	string	-	Sí	Dirección en texto libre de la oficina o sucursal; usado solo si `address` no se envía
cityName	string	-	Sí	Ciudad; usado solo si `address` no se envía
cityCode	string	5	Sí	Código DANE de municipio; alias: `municipalityCode`. Usado solo si `address` no se envía
municipalityCode	string	5	Sí	Código DANE de municipio; alias de `cityCode`. Usado solo si `address` no se envía
department	string	-	Sí	Nombre del departamento; usado solo si `address` no se envía
departmentCode	string	2	Sí	Código DANE de departamento; usado solo si `address` no se envía
countryCode	string	-	Sí	Código ISO 3166-1 alpha-2; usado solo si `address` no se envía
countryName	string	-	Sí	Nombre del país; usado solo si `address` no se envía
address (Ver exchangeAddress)	object		Sí	Dirección de la oficina o sucursal; tiene prioridad sobre los campos planos si se envía

### declarationData Tipo: Objeto Descripción completa de la operación de cambio.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
id	string	-	No	Consecutivo de la declaración, ej. C6VE102253
concept	string	-	No	Declaración de origen de fondos en texto libre (Formulario 18, literales 1-3)
conceptLocale	string	-	Sí	Idioma/locale del concepto; se recomienda `ES_CO`
salePointId	string	-	Sí	Identificador del punto de venta / ventanilla
salePointType	string	-	Sí	Tipo de punto de venta o terminal, ej. DISPENSER, VENTANILLA, CAJERO. Requerido para identificar operaciones en dispensers o cajeros automáticos
employeeNumber	string	-	Sí	Documento o código del cajero
cardNumber	string	-	Sí (solo si el pago fue con tarjeta)	Número de tarjeta usada en el pago
cm	string	-	Sí	Código de movimiento interno (opcional)
operationType	string	-	No	`purchase` (typeOfOperation 15) o `sale` (typeOfOperation 16)
exchangedQuantityCurrency	string	3	No	Código ISO 4217 de la moneda entregada por el cliente, ej. USD, EUR, GBP, COP, BRL, ARS, MXN
exchangedQuantity	number	18,2	No	Cantidad entregada por el cliente
exchangeRate	number	18,2	No	Tasa de cambio (TRM o pactada)
exchangeRateCurrency	string	3	No	Moneda de referencia de la tasa, ej. COP
exchangedTotalCurrency	string	3	No	Código ISO 4217 del monto recibido (contravalor)
exchangedTotal	number	18,2	No	Contravalor bruto antes de comisión
commission	number	18,2	Sí	Comisión cobrada; 0 si no aplica. Solo se incluye en el XML si es mayor a 0
commissionCurrency	string	3	Sí	Moneda de la comisión, ej. COP
amountToReceive	number	18,2	Sí	Monto neto tras comisión; 0 si no aplica. Solo se incluye en el XML si es mayor a 0
paymentMeansCode	string	-	No	Tabla 13 del Anexo Técnico DIAN (97 códigos); ejemplos: 10 Efectivo, 20 Cheque, 42 Consignación bancaria, 45 Transferencia crédito, 47 Transferencia débito, 48 Tarjeta crédito, 49 Tarjeta débito, ZZZ Otro. Ver tabla completa en el Anexo Técnico DIAN
paymentMeansId	string	-	Sí	Identificador secuencial, usualmente `1`
exchangeControlNumber	string	-	No	Numeral cambiario según Anexo 1 DCIP-83 del Banco de la República: 1601 Ingresos de divisas (compra), 2904 Egresos de divisas (venta). Ver tabla completa en banrep.gov.co
exchangeControlDescription	string	-	Sí	Descripción del numeral cambiario, ej. "Otros conceptos"
exchangeControlOperation	string	-	No	`purchase` o `sale`

### customerDueDiligence Tipo: Objeto Debida diligencia del cliente, exigida por el Art. 18 de la Res. DIAN 000210/2025.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
diligenceTypeCode	string	-	No	Ver catálogo del Anexo Técnico DIAN, ej. `01` = DDC General
diligenceTypeId	string	-	Sí	Usualmente igual a diligenceTypeCode
diligenceTypeName	string	-	Sí	Ej. "Debida Diligencia del Cliente - DDC General", "...Intensificada", "...Reforzada"
customer (Ver dueDiligenceCustomer)	object		No	Datos del cliente para debida diligencia
intensifiedDueDiligence	string	-	Sí	Se activa por encima de umbrales de la Superfinanciera; nulo si no aplica
strengthenedDueDiligence	string	-	Sí	Para clientes de alto riesgo o PEP; nulo si no aplica

### dueDiligenceCustomer Tipo: Objeto

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
additionalAccountID	string	-	No	`1` jurídica / `2` natural
documentType	string	-	No	Tipo de documento: 11 Registro civil, 12 T.I., 13 Cédula, 21 T.E., 22 C.E., 31 NIT, 41 Pasaporte, 42 Doc. extranjero, 47 PEP, 48 PPT, 50 NIT otro país, 91 NUIP
documentNumber	string	-	No	Número de documento
name	string	-	No	Nombre completo o razón social
birthDate	string (fecha)	-	Sí (solo persona natural, additionalAccountID=2)	Fecha de nacimiento, formato yyyy-MM-dd
birthPlace	string	-	Sí (solo persona natural, additionalAccountID=2)	Lugar de nacimiento
telephone	string	-	Sí	Teléfono
email	string	-	Sí	Correo electrónico
fundsSourceId	string	-	Sí	Ver catálogo del Anexo Técnico DIAN, ej. `CP` = Capital Propio
fundsSourceName	string	-	Sí	Ej. Capital Propio, Salario, Venta de inmueble
fundsDestinationId	string	-	Sí	Ver catálogo del Anexo Técnico DIAN
fundsDestinationName	string	-	Sí	Ej. Turismo, Pago proveedores, Estudios
fundsPurposeId	string	-	Sí	Ver catálogo del Anexo Técnico DIAN, ej. `2904` = Otros conceptos
fundsPurposeName	string	-	Sí	Ej. Otros conceptos, Importaciones de bienes
economicActivityId	string	-	Sí	Código CIIU, ej. 3415, 6492
economicActivityName	string	-	Sí	Descripción de la actividad económica
addressLine	string	-	Sí	Dirección en texto libre; usado solo si `address` no se envía
cityName	string	-	Sí	Ciudad; usado solo si `address` no se envía
cityCode	string	5	Sí	Código DANE de municipio; alias: `municipalityCode`. Usado solo si `address` no se envía
municipalityCode	string	5	Sí	Código DANE de municipio; alias de `cityCode`. Usado solo si `address` no se envía
department	string	-	Sí	Nombre del departamento; usado solo si `address` no se envía
departmentCode	string	2	Sí	Código DANE de departamento; usado solo si `address` no se envía
countryCode	string	-	Sí	Código ISO 3166-1 alpha-2; usado solo si `address` no se envía
countryName	string	-	Sí	Nombre del país; usado solo si `address` no se envía
address (Ver exchangeAddress)	object		Sí	Dirección estructurada del cliente; tiene prioridad sobre los campos planos si se envía
constitutionData (Ver constitutionData)	object		Sí (solo persona jurídica, additionalAccountID=1)	Datos de constitución de la sociedad
legalBackgroundCheck	string	-	Sí	Resultado de verificación de antecedentes, en texto libre
legalBackgroundLocale	string	-	Sí	Idioma/locale del resultado; se recomienda `ES_CO`
isPep	boolean	1	No	Indica si el cliente es Persona Expuesta Políticamente. Si es true, se recomienda diligenciar politicalExposition
politicalExposition (Ver politicalExposition)	array		Sí	Respuestas al cuestionario estándar de exposición política (3 preguntas); nulo si solo se usa el flag isPep

### constitutionData Tipo: Objeto Solo aplica para personas jurídicas (dentro de `dueDiligenceCustomer`, cuando additionalAccountID=1).

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
legalConstitutionDate	string (fecha)	-	Sí	Formato yyyy-MM-dd; omitir si se desconoce
socialCapital	number	18,2	Sí	Capital social; nulo si no aplica
socialCapitalCurrency	string	3	Sí	Moneda del capital social, usualmente COP
shareholdingStructure	string	-	Sí	Descripción en texto libre de la estructura accionaria

### politicalExposition Tipo: Arreglo de objetos Cuestionario estándar de 3 preguntas de exposición política.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
id	string	1	No	Identificador de la pregunta: `1`, `2` o `3` (conjunto estándar de 3 preguntas)
question	string	-	No	Texto completo de la pregunta
answer	string	-	No	`SI` o `NO`