Documento soporte
Estructura del objeto de un documento soporte.
Ejemplo
Estructura
supportDocument
Tipo: Objeto
Objeto de un documento soporte.
Campo
Tipo
Longitud
¿Es opcional?
Descripción
string (Enum)
32
Sí
Formato PDF documento
consecutive
int
No
Consecutivo del documento soporte
externalNumber
string
42
Sí
Número externo del documento soporte
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
dateDue
date
Sí
Fecha de vencimiento
dateStart
date
Sí
Fecha inicial del periodo de facturación
dateEnd
date
Sí
Fecha final del periodo de facturación
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)
string
8
Sí
Código de medio de pago
object
Sí
Objeto de la sucursal
object
No
Objeto de la resolución
object
No
Objeto del proveedor
array
No
Arreglo de objetos del detalle del documento soporte
object
No
Objeto de los totales del documento soporte
array
Sí
Arreglo de objetos de los descuentos
array
Sí
Arreglo de objetos de los cargos
branch
Tipo: Objeto
Sucursales de facturación, para colocar estos datos en lugar de los configurados 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
supplier
Tipo: Objeto
Detalles del proveedor.
Campo
Tipo
Longitud
¿Es opcional?
Descripción
companyName
string
128
No
Razón social o nombre completo
string
2
No
Tipo de persona
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í
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
supportDocumentDetails
Tipo: Objeto
Detalle del documento soporte.
Campo
Tipo
Longitud
¿Es opcional?
Descripción
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).
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
array
Sí
Descuentos sobre los items (Productos o servicios)
array
Sí
Cargos adicionales sobre los items (Productos o servicios)
array
Sí
Impuestos sobre los items (Productos o servicios)
array
Sí
Retenciones sobre los items (Productos o servicios)
object
Sí
Mandante
Los descuentos y cargos pueden ser sobre los items o sobre la documento soporte pero no sobre ambos.
Si agregas los descuentos y cargos en el detalle serán calculados sobre los items del documento soporte, de lo contrario (si son agregados directamente en el objeto del documento soporte), serán calculados sobre el documento en general.
discount
Tipo: Arreglo de objetos
Descuentos sobre el documento, tenga en cuenta que si va a realizar descuentos sobre el documento no se pueden realizar sobre el detalle o 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 el documento, tenga en cuenta que si va a realizar cargos sobre el documento no se pueden realizar sobre el detalle o 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 tenga en cuenta que son por unidad facturada, no lo calcule por la 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 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
¿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 del documento.
Campo
Tipo
Longitud
¿Es opcional?
Descripción
amount
number
18,6
No
Total del documento sin impuestos ni retenciones
prepaymentAmount
number
18,6
No
Valor anticipado aplicado al documento
Última actualización
¿Te fue útil?