---
title: "Changes to Endpoint para emitir una nota débito electrónica a la DIAN"
method: POST
path: "/debit-notes"
---

# Changes to Endpoint para emitir una nota débito electrónica a la DIAN

`POST /debit-notes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `2bc52ab55c2b`: 3 breaking, 2 warning, 16 info

## Changes

- **2026-11-03** `2bc52ab55c2b`: 3 breaking, 2 warning, 16 info
  - the response property `files/attachedDocument` became nullable for the status `200`
  - the response property `files/xml` became nullable for the status `200`
  - the response property `files/zip` became nullable for the status `200`
  - the `foreignCurrency/rateValue` request property's exclusiveMinimum was set to `true`
  - the `note/items/` request property's maxLength was set to `5000`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `delivery`
  - added the new optional request property `foreignCurrency/totalAmounts`
  - added the new optional request property `items/items/additionalItemProperties`
  - added the new optional request property `items/items/aiuContract`
  - added the new optional request property `orderReference`
  - the `healthSectorGeneral/prepaidPayments/items/amount` request property format was generalized from `float` to no format
  - the `totalAmounts/advanceTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/chargeTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/discountTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/grossTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/payableTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/taxTotal` request property format was generalized from `float` to no format
  - the `totalAmounts/taxableTotal` request property format was generalized from `float` to no format
  - added the non-success response with the status `409`
  - added the non-success response with the status `422`

---

[Operation](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/docs/debit-notes/post.md) - [API](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [Page](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/changes/debit-notes/post)
