Nota Débito de factura electrónica

Consumo de servicios

POST

https//api.datainvoicecolombia.com/api/ubl2.1/debit-note

"Content-Type": "application/json",
"accept": "application/json",
"Authorization": "Bearer token"

Factura de Venta

{
"billing_reference": {
	"number": "SETP990000597",
	"uuid": "808adf32c40eddf08a10a8c37c5cdb934994f0595bd97c3ac4ecb373b0f7924dde756836ab822d2d36c367214e56aec5",
	"issue_date": "2022-08-09"
},
"discrepancyresponsecode": 3,
"discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA DEBITO",
"number": 41,
"type_document_id": 5,
"date": "2023-06-23",
"time": "06:00:13",
  "sendmail": true,
  "sendmailtome": true,
"customer": {
	"identification_number": 900166483,
	"dv": 1,
	"name": "INVERSIONES DAVAL SAS",
	"phone": "3103891693",
	"address": "CLL 4 NRO 33-90",
	"email": "alexanderobandolondono@gmail.com",
	"merchant_registration": "0000000-00",
	"type_document_identification_id": 6,
	"type_organization_id": 1,
	"municipality_id": 822,
	"type_regime_id": 1
},
"tax_totals": [
	{
		"tax_id": 1,
		"tax_amount": "159663.865",
		"percent": "19",
		"taxable_amount": "840336.134"
	}
],
"requested_monetary_totals": {
	"line_extension_amount": "840336.134",
	"tax_exclusive_amount": "840336.134",
	"tax_inclusive_amount": "1000000.00",
	"payable_amount": "1000000.00"
},
"debit_note_lines": 
[
	{
		"unit_measure_id": 70,
		"invoiced_quantity": "1",
		"line_extension_amount": "840336.134",
		"free_of_charge_indicator": false,
		"tax_totals": [
			{
				"tax_id": 1,
				"tax_amount": "159663.865",
				"taxable_amount": "840336.134",
				"percent": "19.00"
			}
		],
		"description": "COMISION POR SERVICIOS",
          "notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
		"code": "COMISION",
		"type_item_identification_id": 4,
		"price_amount": "840336.134",
		"base_quantity": "1"
	}
]
}

200 - Respuesta

Note

Si la factura es validada y aceptada por la DIAN, dentro de la propiedad ResponseDian se encontrará la propiedad IsValid en true, de lo contrario si esa misma propiedad es retornada en false y esto indica que hubo un error en la factura y se debe leer la propiedad ErrorMessage para obtener el error.

{
  "success": true,
  "message": "AttachedDocument #SETP990001196 generada con éxito",
  "send_email_success": true,
  "send_email_date_time": true,
  "urlinvoicexml": "FES-SETP990001196.xml",
  "urlinvoicepdf": "FES-SETP990001196.pdf",
  "urlinvoiceattached": "ad00075737720002500000152.xml",
  "cufe": "9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
  "QRStr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
  "certificate_days_left": 310,
  "resolution_days_left": 1621,
  "ResponseDian": {
      "Envelope": {
          "Header": {
              "Action": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendBillSyncResponse"
              },
              "Security": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "Timestamp": {
                      "_attributes": {
                          "Id": "_0"
                      },
                      "Created": "2025-08-12T18:01:07.516Z",
                      "Expires": "2025-08-12T18:06:07.516Z"
                  }
              }
          },
          "Body": {
              "SendBillSyncResponse": {
                  "SendBillSyncResult": {
                      "ErrorMessage": {
                          "string": "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible."
                      },
                      "IsValid": "true",
                      "StatusCode": "00",
                      "StatusDescription": "Procesado Correctamente.",
                      "StatusMessage": "La Factura electrónica SETP990001196, ha sido autorizada.",
                      "XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5jOkRvY3VtZW50UmVzcG9uc2U+DQo8L0FwcGxpY2F0aW9uUmVzcG9uc2U+",
                      "XmlBytes": {
                          "_attributes": {
                              "nil": "true"
                          }
                      },
                      "XmlDocumentKey": "9bfe029ef9a015ab60155a78be4f70ed6f88d532de4cc661cccc99b7e35dab3faf0a7e2ed55f0c9246362830ea258412",
                      "XmlFileName": "fv00075737720002500000152"
                  }
              }
          }
      }
  },
  "invoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjgogICAgPC9jYWM6UHJpY2U+CiAgPC9jYWM6SW52b2ljZUxpbmU+CjwvSW52b2ljZT4K",
  "zipinvoicexml": "UEsDBBQAAgAIACOgDFs+2HRL0hYAAHtOAAAdAAAAZnYwMDA3NTczNzcyMDAwMjUwMDAwMDEAAAABAAEASwAAAA0XAAAAAA==",
  "unsignedinvoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5XVhbnRpdHk+CiAgICA8L2NhYzpQcmljZT4KICA8L2NhYzpJbnZvaWNlTGluZT4KPC9JbnZvaWNlPgo=",
  "reqfe": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwOkVudmVsb3BlIHhtbG5zOnNvYXA9Imh0dHA6Ly93d3cudAgICAgPC93Y2Y6U2VuZEJpbGxTeW5jPgogICAgPC9zb2FwOkJvZHk+Cjwvc29hcDpFbnZlbG9wZT4K",
  "rptafe": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3d3dy53My5vcmcvMjAwMy8wNS9zb2FwLWVudmVsb3BlIiB4bWCaWxsU3luY1Jlc3BvbnNlPjwvczpCb2R5PjwvczpFbnZlbG9wZT4=",
  "attacheddocument": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxBdHRhY2hlZERvY3VtZZWZlcmVuY2U+CjwvQXR0YWNoZWREb2N1bWVudD4K"
}

Descripción de los campos de la respuesta

Campos	Descripción
success	Indica si la api procesó la petición correctamente
send_email_success	Indica si el correo electrónico se envio correctamente
urlinvoicexml	Nombre del xml de la factura
urlinvoicepdf	Nombre del pdf de la factura
urlinvoiceattached	Nombre del xml de la factura firmado
cufe	Cufe de la factura
QRStr	Url del portal dian para generar el QR de la factura
certificate_days_left	Dias restantes del certificado
resolution_days_left	Dias restantes de la resolución
ResponseDian	Respuesta del dian
invoicexml	XML de la factura en formato base64
zipinvoicexml	ZIP de la factura en formato base64
unsignedinvoicexml	XML de la factura sin firmar en formato base64
reqfe	request de la petición en formato base64
reqrptafe	Respuesta de la petición en formato base64
attacheddocument	Documento adjuntado en formato base64

422 - Error por campos obligatorios

{
	"message": "The given data was invalid.",
	"errors": {
		"customer.name": [
			"El campo customer.name es obligatorio."
		]
	}
}

Rechazo por documento enviado

{
  "success": true,
  "message": "AttachedDocument #SETP990001192 generada con éxito",
  "send_email_success": false,
  "send_email_date_time": false,
  "urlinvoicexml": "FES-SETP990001192.xml",
  "urlinvoicepdf": "FES-SETP990001192.pdf",
  "urlinvoiceattached": ".xml",
  "cufe": "1393a88b14dfe70b1ec158cff51ecb86b3fed77e31c7a92281b36d8e1f317c1d2e16a95e8236f4f07c4ea2aae1e56f34",
  "QRStr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=1393a88b14dfe70b1ec158cff51ecb86b3fed77e31c7a92281b36d8e1f317c1d2e16a95e8236f4f07c4ea2aae1e56f34",
  "certificate_days_left": 310,
  "resolution_days_left": 1621,
  "ResponseDian": {
      "Envelope": {
          "Header": {
              "Action": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendBillSyncResponse"
              },
              "Security": {
                  "_attributes": {
                      "mustUnderstand": "1"
                  },
                  "Timestamp": {
                      "_attributes": {
                          "Id": "_0"
                      },
                      "Created": "2025-08-12T17:55:17.329Z",
                      "Expires": "2025-08-12T18:00:17.329Z"
                  }
              }
          },
          "Body": {
              "SendBillSyncResponse": {
                  "SendBillSyncResult": {
                      "ErrorMessage": {
                          "string": "Regla: 90, Rechazo: Documento procesado anteriormente."
                      },
                      "IsValid": "false",
                      "StatusCode": "99",
                      "StatusDescription": "Validación contiene errores en campos mandatorios.",
                      "StatusMessage": "Documento con errores en campos mandatorios.",
                      "XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4c2U+DQogIDwvY2FjOkRvY3VtZW50UmVzcG9uc2U+DQo8L0FwcGxpY2F0aW9uUmVzcG9uc2U+",
                      "XmlBytes": {
                          "_attributes": {
                              "nil": "true"
                          }
                      },
                      "XmlDocumentKey": "318ac0a063b260ce9eacc78e4e311a40570ce517ec6465282d16d63da03b4207c56d9be92cefac7cd041db8084f2b195",
                      "XmlFileName": "fv00075737720002500000081"
                  }
              }
          }
      }
  },
  "invoicexml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiI2ljZT4K",
  "zipinvoicexml": "UEsDBBQAAAAA=",
  "unsignedinvoicexml": "PD94bWw2NhYzpQcmljZT4KICA8L2NhYzpJbnZvaWNlTGluZT4KPC9JbnZvaWNlPgo=",
  "reqfe": "PD94bWwgdmVyc2lvbj0iMS4WxvcGU+Cg==",
  "rptafe": "PHM6RW52ZWxvcGUgeG1sbnU+PC9zOkJvZHk+PC9zOkVudmVsb3BlPg==",
  "attacheddocument": ""
}

Note

Debe tener en cuenta que las notas débito son una copia de la factura electrónica, por lo que la mayoría de los campos son iguales, solo los que se describen a continuación son diferentes. Tambien en vez de enviar el campo invoice_lines se envia debit_note_lines

Campos de la Notas Débito

• billing_reference (array): Campos para la factura de referencia

• billing_reference->number: Número de factura

• billing_reference->uuid: Cufe de la factura de referencia

• billing_reference->issue_date: Fecha de emisión de la factura de referencia

• discrepancyresponsecode: Identificador de los códigos de motivo de rechazo de nota débito (Ver tabla Motivos de rechazo de nota débito)

• discrepancyresponsedescription: Descripción del motivo por el cual se emite la nota débito