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

AnteriorNota débitoSiguienteNota de ajuste

Última actualización

¿Te fue útil?