Factura
Estructura del objeto de una factura.
Ejemplo
{
"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
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
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)
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
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: https://youtu.be/Ll-z2yRn_Ss.
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
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
string
160
Sí
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
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
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.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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"
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
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
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
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
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
Última actualización