Nota crédito

Estructura del objeto de una nota crédito.

Ejemplo

{
	"format": "Estandar",
	"emailSender": "",
	"concept": "1",
	"consecutive": 5,
	"externalNumber": "",
	"currencyCode": "COP",
	"currencyRate": 0,
	"date": "2020-1-18",
	"dateStart": "2020-1-18",
	"dateEnd": "2020-1-20",
	"typeOfOperation": "01",
	"terms": "",
	"remark": "",
	"observation": "",
	"invoicePrefix": "inv",
	"invoiceConsecutive": 990004331,
	"invoiceCufe": "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
	"invoiceDate": "2020-1-18",
	"branch": {
		"name": "Sucursal",
		"address": "KR con CLL",
		"phone": "000000",
		"countryCode": "CO",
		"countryName": "COLOMBIA",
		"departamentCode": "25",
		"departamentName": "Cundinamarca",
		"cityCode": "25178",
		"cityName": "Chipaque"
	},
	"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 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": ""
	},
	"invoiceNoteDetails": [{
		"standardType": "",
		"standardCode": "",
		"itemCode": "0001",
		"itemName": "Item",
		"itemModel": "",
		"description": "Item prueba",
		"brandName": "",
		"itemCodeSupplier": "",
		"isPresent": false,
		"unitMeasurementCode": "NIU",
		"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": {
		"amount": 68,
		"prepaymentAmount": 0
	},
	"discounts": [{
		"name": "",
		"type": "",
		"rate": 0,
		"amount": 0
	}],
	"charges": [{
		"name": "",
		"type": "",
		"rate": 0,
		"amount": 0
	}],
	"customFields": [{
		"value": "666",
		"key": "invoiceId"
	}]
}

Estructura

invoiceNoteCr

Tipo: Objeto

Objeto de una nota crédito.

Campo	Tipo	Longitud	¿Es nulo?	Descripción
format (Ver opciones)	string	32	Sí	Formato PDF del documento
emailSender	string	128	Sí	Remitente email
concept (Ver códigos)	string	1	No	Concepto por el cual se hace la nota crédito
consecutive	int		No	Consecutivo de la nota
externalNumber	string	16	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 nota
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
terms	string	800	Sí	Términos y condiciones
remark	string	800	Sí	Pie de pagina
observation	string	800	Sí	Nota / Observación
invoicePrefix	string	8	No	Prefijo de la factura a la cual se le está realizando la nota crédito
invoiceConsecutive	int		No	Consecutivo de la factura a la cual se le está realizando la nota crédito
invoiceCufe	int		No	Cufe de la factura a la cual se le está realizando la nota crédito
invoiceDate	date		No	Fecha de la factura a la cual se le está realizando la nota crédito
branch (branch)	object		Sí	Objeto de la sucursal
resolution (resolution)	object		No	Objeto de la resolución
customer (customer)	object		No	Objeto del cliente
invoiceNoteDetails (invoiceNoteDetail)	array		No	Arreglo de objetos del detalle de la nota
totals (total)	array		No	Objeto de los totales de la nota
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 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.

Campo	Tipo	Logitud	¿Puede ser nulo?	Descripción
resolutionKey	string	256	No	Clave de resolución
resolutionPrefix	string	8	No	Prefijo de la resolución
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
email	string	160	Sí	Email
phone	string	24	Sí	Teléfono
merchantRegistration	string	16	Sí	Registro mercantil
responsibleFor	string	12	Sí	Responsable de... Ver códigos
responsibilities	string	500	No	Responsabilidades fiscales
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	Sí	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

invoiceNoteDetail

Tipo: Objeto

Detalle de la nota crédito.

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
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 nota pero no sobre ambos.

Si agregas los descuentos y cargos en el detalle serán calculados sobre los items de la nota, de lo contrario (si son agregados directamente en el objeto de la nota), serán calculados sobre la nota en general.

discount

Tipo: Arreglo de objetos

Descuentos sobre la nota, tenga en cuenta que si va a realizar descuentos sobre la nota 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 nota, tenga en cuenta que si va a realizar cargos sobre la nota 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

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 nota crédito.

Campo	Tipo	Longitud	¿Puede ser nulo?	Descripción
amount	number	18,6	No	Total de la nota sin impuestos ni retenciones
prepaymentAmount	number	18,6	No	Valor anticipado aplicado a la nota

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