---
title: "Crear una nota de débito"
method: POST
path: "/debit-notes"
tags: ["Notas de débito"]
---

# Crear una nota de débito

`POST /debit-notes`

Este endpoint permite registrar una nueva nota de débito en la aplicación

## Request body

- object
  - `date` string, date, required — Fecha de la nota de débito.
  - `number` string — Número del folio la nota débito. Es obligatorio para las siguientes versiones: Chile, Colombia, Costa Rica, España, México, Panamá, Perú, USA, Internacional.
  - `prefix` string — Prefijo del folio de la nota débito
  - `resolution` object — Objecto que contiene el id de la numeración asociada a la nota débito. Se puede enviar directamente el id de la numeración en este atributo. Es obligatorio para las siguientes versiones: Argentina, República Dominicana.
    - `id` string — id de la numeración asociada a la nota débito
  - `observations` string — Observaciones de la nota de débito.
  - `termsConditions` string — Términos y condiciones de la nota de débito.
  - `client` object, required — Objeto que contiene el id del cliente asociado a la nota de débito. Se puede enviar directamente el id del cliente en este atributo.
    - `id` string — id del cliente
  - `warehouse` union — Objeto que indica el id de la bodega/almacén asociada a la nota de débito. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la nota débito queda asociada a la bodega/almacén Principal. Todos los items que se envíen asociados a la nota débito deben al menos un item existente en el almacén/bodega indicado.
    - integer
    - object
      - `id` integer — Identificador único de la bodega
      - `name` string — Nombre de la bodega
  - `items` object[] — Array de objetos Item, contiene los productos. El precio del producto/servicio no debe incluir impuestos ni descuentos. Cada item enviado debe ser de tipo "Inventariable" y tener existencia en el almacén/bodega indicado. Se debe enviar al menos un item si no se envía ninguna categoría.
    - `id` integer, required — Identificador del producto
    - `tax` object[] — Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra
      - `id` integer — Identificador único que representa un impuesto específico.
      - `name` string — Nombre asignado al impuesto
      - `percentage` number — Porcentaje del impuesto
      - `description` string — Descripción del impuesto
      - `type` string — Tipo de impuesto
      - `status` string — Indica el estado del impuesto
    - `price` number, required — Precio de compra del producto
    - `quantity` number, required — Cantidad de productos que fueron comprados.
  - `categories` object[] — Array de objetos category. Contiene cuentas contables (categorias). El precio de la categoría no debe incluir impuestos ni descuentos. Cada categoría enviada debe ser de tipo "expense" (gasto) o "asset" (activo) y debe estar habilitada. Se debe enviar al menos una categoría si no se envía ningún item.
    - `id` integer, required — Identificador de la categoría
    - `tax` object[] — Array de objetos tax que indican los impuestos aplicados a la categoría al momento de la compra
      - `id` integer — Identificador único que representa un impuesto específico.
      - `name` string — Nombre asignado al impuesto
      - `percentage` number — Porcentaje del impuesto
      - `description` string — Descripción del impuesto
      - `type` string — Tipo de impuesto
      - `status` string — Indica el estado del impuesto
    - `price` number, required — Precio de compra de la categoría
    - `quantity` number, required — Cantidad comprada de la categoría
  - `refunds` object[] — Array de objetos con la información de las devoluciones asociadas a la nota débito.
    - `date` string, yyyy-mm-dd, required — Fecha de la devolución.
    - `account` integer, required — Identificador de la cuenta
    - `amount` number, required — Monto de la devolución
    - `observations` string — Observaciones acerca de la devolución
  - `bills` object[] — Array de objetos con la información de las facturas de proveedor que se desean asociar a la nota débito. El factura de proveedor debe tener saldo pendiente por pagar y este debe ser mayor o igual al atributo "amount" ingresado. La factura de proveedor no puede haber sido conciliada. Cada factura de proveedor enviada debe estar asociada al mismo cliente al que va dirigida la nota débito.
    - `id` string, required — Identificador de la factura de proveedor
    - `amount` number, required — Monto asociado
  - `currency` object, nullable — Objeto que incluye la información de la moneda y tasa de cambio asociada a la factura. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.
    - `code` string, required — Código ISO de la moneda asociada a la empresa
    - `exchangeRate` number, required — Tasa de cambio
  - `costCenter` union — Objeto que indica el id del centro de costo asociado. Se puede enviar directamente el id del centro de costo en este atributo o enviarlo como objeto.
    - integer
    - object — Objeto costCenter que indica el centro de costo asociado.
      - `id` integer — Identificador del centro de costo
      - `code` string — Código del centro de costo
      - `name` string — Nombre del centro de costo
      - `description` string — Descripción del centro de costo
      - `status` boolean — Estatus del centro de costo (activo o inactivo)
  - `comments` string[] — Arreglo de strings con cada uno de los comentarios que se desean asociar.

## Response `201`

Se obtiene un objeto que describe una nota de débito

- object
  - `id` number — Identificador único que representa una nota débito específica. La aplicación lo asigna automáticamente.
  - `date` string, yyyy-mm-dd — Fecha de la nota débito
  - `observations` string — Observaciones de la nota débito. No visibles en el documento impreso o PDF.
  - `termsConditions` string — Términos y condiciones aplicables a la nota de crédito. Visibles en el documento impreso o PDF.
  - `client` object — Objeto que contiene la información del cliente asociado a la nota débito.
  - `numberTemplate` object — Objeto que contiene la información de la numeración de la nota débito.
    - `id` string — Identificador del numberTemplate.
    - `prefix` string — Prefijo de la nota débito.
    - `number` string — Número de la nota débito.
    - `documentType` string — Tipo de documento
  - `warehouse` object — Objeto que contiene la información de la bodega de la nota débito. Contiene los siguientes atributos:id: Identificador de la bodega.name: Nombre de la bodega.observations: Observaciones de la bodega.isDefault: True, si es la bodega predeterminada.address: Dirección fisica de la bodega.status: Estado de la bodega.
    - `id` integer — Identificador único de la bodega
    - `name` string — Nombre de la bodega
  - `total` number — Total de la nota débito. Se debe tener en cuenta que el total de la nota débito es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la nota débito y conforma la suma de los items y categorías asociados a la nota débito.
  - `balance` number — Saldo pendiente por aplicar a la nota débito. Es la resta del total menos el totalApplied.
  - `totalApplied` number — Total aplicado a la nota débito. Esta conformado por la sumatoria de todos los reembolsos y facturas de proveedor asociados a la nota débito.
  - `decimalPrecision` number — Precisión decimal de la nota de crédito.
  - `items` object[] — Array de objetos Item, que contiene los productos asociados a la nota débito. Estos solamente pueden ser productos inventariables.
    - `id` integer — Identificador del producto
    - `name` string — Nombre del producto
    - `discount` number — Porcentaje de descuento aplicado al producto
    - `description` string — Descripción del producto o servicio
    - `reference` string — Referencia del producto o servicio
    - `tax` object[] — Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra
      - `id` integer — Identificador único que representa un impuesto específico.
      - `name` string — Nombre asignado al impuesto
      - `percentage` number — Porcentaje del impuesto
      - `description` string — Descripción del impuesto
      - `type` string — Tipo de impuesto
      - `status` string — Indica el estado del impuesto
    - `price` number — Precio de compra del producto
    - `quantity` number — Cantidad de productos que fueron comprados.
    - `total` number — Total del producto (no incluye impuestos)
  - `categories` object[] — Array de objetos Category, que contiene las categorías asociadas a la nota débito. Estas solamente pueden ser de tipo expense (Egreso) o asset (Activo). .price: Precio de venta de la categoría.
    - `id` integer — Identificador de la categoría
    - `name` string — Nombre de la categoría
    - `discount` number — Porcentaje de descuento aplicado a la categoría
    - `observations` string — Observaciones acerca de la categoría.
    - `tax` object[] — Array de objetos tax que indican los impuestos aplicados a la categoría al momento del débito
      - `id` integer — Identificador único que representa un impuesto específico.
      - `name` string — Nombre asignado al impuesto
      - `percentage` number — Porcentaje del impuesto
      - `description` string — Descripción del impuesto
      - `type` string — Tipo de impuesto
      - `status` string — Indica el estado del impuesto
    - `price` number — Precio de compra de la categoría
    - `quantity` number — Cantidad comprada de la categoría
    - `total` number — Total de la categoría (no incluye impuestos)
    - `subtotal` number — Subtotal de la categoría
  - `refunds` object[] — Array que contiene los desembolsos realizados en la nota débito.
    - `id` integer — Identificador de la transacción asociada al reembolso
    - `number` string — Número de la transacción asociada al reembolso
    - `amount` number — monto del reembolso reembolso
    - `date` string, yyyy-mm-dd — Fecha de la transacción asociada al reembolso
    - `bankAccount` object
      - `id` integer — Identificador de la cuenta bancaria asociada al reembolso
      - `name` string — Nombre de la cuenta
      - `type` string — Tipo de cuenta
    - `observations` string — Observaciones asociadas al reembolso
    - `anotation` string — Anotación sobre la transacción asociada al reembolso
    - `type` string — Tipo de transacción asociada al reembolso. Siempre sera in para este caso.
    - `paymentMethod` string — Método de pago de la transacción asociada al reembolso
    - `currency` object — Objeto que incluye la información de la moneda. Solo se incluye si la compañía tiene activo multimoneda y la factura está en una moneda diferente de la principal de la compañía.
      - `code` string — Código ISO de la moneda asociada a la empresa
      - `symbol` string — Símbolo de la moneda
      - `exchangeRate` number — Tasa de cambio
  - `bills` object[] — Array que contiene las facturas de proveedor asociadas a la nota débito.
    - `id` integer — Identificador único que representa una factura específica. La aplicación lo asigna automáticamente.
    - `prefix` string — Prefijo de la factura
    - `number` string — Número de la factura
    - `date` string, date — Fecha de la factura.
    - `dueDate` string, date — Fecha de vencimiento de la factura.
    - `observations` string — Observaciones de la factura.
    - `termsConditions` string — Términos y condiciones aplicables a la factura.
    - `status` string — Indica el estado de la factura, las opciones posibles son `open` (la factura no se ha pagado completamente) y `closed` (la factura se ha pagado completamente)
    - `total` number — Total de la factura. Se debe tener en cuenta que el total de la factura es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la factura.
    - `balance` number — Saldo pendiente por pagar a la factura.
    - `amount` number — Valor pagado
  - `currency` object — Objeto que incluye la información de la moneda asociada a la nota débito. Solo se incluye si la compañía tiene activo multimoneda y la factura está en una moneda diferente de la principal de la compañía.Este objeto contiene:code : Código ISO de la moneda asociada a la empresa.exchangeRate: Tasa de cambio.symbol: Simbolo de la moneda.
    - `code` string — Código ISO de la moneda asociada a la empresa
    - `symbol` string — Símbolo de la moneda
    - `exchangeRate` number — Tasa de cambio
  - `costCenter` object — Objeto costCenter que indica el centro de costo asociado a la factura de venta.
    - `id` integer — Identificador del centro de costo
    - `code` string — Código del centro de costo
    - `name` string — Nombre del centro de costo
    - `description` string — Descripción del centro de costo
    - `status` boolean — Estatus del centro de costo (activo o inactivo)

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)