Nota de Ajuste para Documento Soporte Electrónico

Consumo de servicios

POST

https//api.datainvoicecolombia.com/api/ubl2.1/sd-credit-note

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

Factura de Venta

{
"billing_reference": {
	"number": "DS8",
	"uuid": "1b991cbf678826d3f58b0814a824d46e8332635298f288b1d2ac978835692c53dd2479a9e128a0131c8665f3afeb3c5d",
	"issue_date": "2022-09-01"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
  "notes": "PRUEBA DE NOTA CREDITO",
  "prefix": "NDS",
"number": 5,
"type_document_id": 13,
"date": "2022-09-01",
"time": "06:00:13",
  "sendmail": true,
  "sendmailtome": true,
"seller": {
	"identification_number": "41946692",
      "dv": "6",
	"name": "ELIZABETH CARDONA VILLADA",
	"phone": "3226563672",
	"address": "LIMONAR MZ 6 CS 3 ET 1 PISO 2",
	"email": "elizabethcardonav@gmail.com",
	"merchant_registration": "0000-00",
      "postal_zone_code": 630001,
	"type_document_identification_id": 3,
	"type_organization_id": 2,
	"municipality_id": 820,
	"type_liability_id": 117,
	"type_regime_id": 1
},
	"tax_totals": [{
	"tax_id": 1,
	"tax_amount": "0.00",
	"taxable_amount": "200.00",
	"percent": "0.00"
}],
  "allowance_charges": [{
      "discount_id": 1,
      "charge_indicator": false,
      "allowance_charge_reason": "DESCUENTO GENERAL",
      "amount": "0.00",
      "base_amount": "200.00"
  }],
  "legal_monetary_totals": {
      "line_extension_amount": "200.00",
      "tax_exclusive_amount": "200.00",
      "tax_inclusive_amount": "200.00",
      "allowance_total_amount": "0.00",
      "charge_total_amount": "0.00",
      "payable_amount": "200.00"
  },
"credit_note_lines": [{
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "200.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [{
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "200.00"
      }],
  	"tax_totals": [{
		"tax_id": 1,
		"tax_amount": "0.00",
		"taxable_amount": "200.00",
		"percent": "0.00"
	}],
      "description": "COMISION POR SERVICIOS",
      "code": "COMISION",
	"brandname": "FULLFIT",
  	"modelname": "1088",
      "type_item_identification_id": 4,
      "price_amount": "200.00",
      "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 de ajuste son una copia del documento soporte electrónico, 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 adjustment_note_lines

Campos de la Nota de Ajuste para Documento Soporte Electrónico

• billing_reference (array): Campos para el documento de referencia

• billing_reference->number: Número de documento de referencia

• billing_reference->uuid: Cufe del documento soporte de referencia

• billing_reference->issue_date: Fecha de emisión del documento soporte de referencia

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

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