Documento soporte

Estructura del objeto de un documento soporte.

Ejemplo

{
	"format": "Estandar",
	"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",
	"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"
	},
	"supplier": {
		"companyName": "Customer",
		"personType": "1",
		"regimeType": "04",
		"firstName": "Customer",
		"lastName": "Customer",
		"identification": "000000001",
		"digitCheck": "8",
		"identificationTypeCode": "13",
		"email": "[email protected]",
		"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": ""
	},
	"supportDocumentDetails": [{
		"standardType": "",
		"standardCode": "",
		"itemCode": "0001",
		"itemName": "Item",
		"itemModel": "",
		"description": "Item prueba",
		"brandName": "",
		"itemCodeSupplier": "",
		"isPresent": false,
		"unitMeasurementCode": "",
		"unitMeasurementName": "",
		"price": "1285.00",
		"quantity": "2",
		"discounts": [{
			"name": "",
			"type": "V",
			"rate": 1,
			"amount": 1
		}],
		"charges": [{
			"name": "",
			"type": "V",
			"rate": 10,
			"amount": 10
		}],
		"taxes": [{
			"name": "Iva",
			"code": "01",
			"type": "V",
			"rate": 10,
			"amount": 10
		}],
		"withholdings": [{
			"name": "ReteFuente",
			"code": "06",
			"type": "P",
			"rate": 10,
			"amount": 3.4
		}],
		"isvMandante": {
			"name": "Mandante",
			"identification": "000001",
			"digitCheck": "8",
			"identificationTypeCode": "13"
		}
	}],
	"totals": {
		"prepaymentAmount": 68,
		"amount": 0
	},
	"discounts": [{
		"name": "",
		"type": "",
		"rate": 0,
		"amount": 0
	}],
	"charges": [{
		"name": "",
		"type": "",
		"rate": 0,
		"amount": 0
	}]
}

Estructura

supportDocument

Tipo: Objeto

Objeto de un documento soporte.

Campo

Tipo

Longitud

¿Es opcional?

Descripción

format (Ver opciones)

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)

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

supplier (supplier)

object

No

Objeto del proveedor

supportDocumentDetails (supportDocumentDetail)

array

No

Arreglo de objetos del detalle del documento soporte

totals (total)

object

No

Objeto de los totales del documento soporte

discounts (discount)

array

Sí

Arreglo de objetos de los descuentos

charges (charge)

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

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

supportDocumentDetails

Tipo: Objeto

Detalle del documento soporte.

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

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

AnteriorFacturaSiguienteNota débito

Última actualización

¿Te fue útil?