---
title: "Crear nota débito cliente"
method: POST
path: "/income-debit-notes"
tags: ["Notas Débito cliente"]
---

# Crear nota débito cliente

`POST /income-debit-notes`

Endpoint que permite crear una nota débito cliente desde cero.

## Request body

- union
  - object
    - `date` string, required — Fecha de creación de la nota de debito. Formato yyyy-MM-dd
    - `dueDate` string, required — Fecha de vencimiento de la nota de debito. Formato yyyy-MM-dd
    - `annotation` string — Notas de la nota de débito cliente, visibles en el PDF o documento impreso.
    - `type` string, required — Tipo de nota de débito cliente
    - `paymentMethod` string, required — Indica el medio o forma de pago de la nota debito cliente.
    - `paymentType` string, required — Indica el tipo de pago de la nota debito cliente.
    - `client` object, required — Objeto que contiene el id del cliente asociado a la nota de débito cliente
      - `id` string — Id del cliente
    - `payments` object[] — Array de objetos que indican los pagos que se han realizado a la nota débito.
      - `date` string, date — Fecha del pago
      - `account` object — Objeto que incluye el id de la cuenta banco a la cual debe ingresar el dinero
        - `id` integer — Identificador de la cuenta bancaria
      - `amount` number — Valor pagado
      - `paymentMethod` 'cash' | 'check' | 'transfer' | 'deposit' | 'credit-card' | 'debit-card' — Método de pago
      - `observations` string — Observaciones del pago
    - `items` object[], required — Array de objetos item (productos/servicios) asociados a la factura. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto o servicio que se vende; `price (double, obligatorio)`: precio de venta; `reference (string)` : referencia del producto/servicio; `description (string)`: descripción del producto/servicio; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad vendida del producto o servicio. El precio del producto/servicio no debe incluir impuestos ni descuentos.
      - `id` string — Identificador del producto
      - `name` string — Nombre del producto
      - `discount` number — Porcentaje de descuento aplicado al producto
      - `observations` string — Observaciones acerca del producto
      - `tax` object[] — Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra
        - `id` string — Identificador único que representa un impuesto específico.
      - `price` number — Precio de compra del producto
      - `quantity` number — Cantidad de productos que fueron comprados.
    - `invoice` object — Objeto que contiene el id de la factura asociada a la nota de débito cliente
      - `id` string — Id de la factura
    - `costCenter` object — Objeto que indica el id del centro de costo que se desea asociar a la nota de débito cliente
      - `id` string — Id del centro de costos
    - `currency` object — Objeto que incluye la información de la moneda y tasa de cambio asociada a la nota de débito cliente. 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 — Código ISO de la moneda
    - `warehouse` object — Objeto que contiene el id de la bodega asociada a la nota de débito cliente
      - `id` string — Id de la bodega
    - `numberDeliveryOrder` string — Número de orden de entrega
    - `seller` object — Objeto que contiene el id del vendedor asociado a la nota débito cliente
      - `id` string — id del vendedor
    - `status` string — Estado de la nota débito cliente, las opciones posibles son: open o draft. Si no se especifica, el valor por defecto es open. si paymentMethod es CASH el estado de la nota debito es closed
    - `numberTemplate` object — Objeto que contiene la información de la numeración de la nota débito cliente. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la nota débito cliente. Si no se envía este atributo la aplicación intenta crear la nota débit cliente con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.
      - `id` string — ID de la numeración
      - `prefix` string — Prefijo de la nota débito cliente (enviar en caso de que la numeración sea manual, opcional)
      - `number` string — Número de la nota débito cliente (enviar en caso de que la numeración sea manual, requerido)
    - `stamp` object — Objeto que contiene la información de emisión de la nota débito cliente. Solo se debe incluir si tiene facturación electronica activa
      - `generateStamp` boolean — si se desea emitir la nota debito cliente
  - object
    - `date` string, required — Fecha de creación de la nota de debito. Formato yyyy-MM-dd
    - `dueDate` string, required — Fecha de vencimiento de la nota de debito. Formato yyyy-MM-dd
    - `annotation` string — Notas de la nota de débito cliente, visibles en el PDF o documento impreso.
    - `account` object — Cuenta bancaria, si paymentMethod es CASH la cuenta bancaría es requerida
      - `id` string — Id de la cuenta bancaria
    - `client` object, required — Objeto que contiene el id del cliente asociado a la nota de débito cliente. Se puede enviar directamente el id del cliente en este campo.
      - `id` string — Id del cliente
    - `numberTemplate` object — Objeto que contiene la información de la numeración de la nota débito cliente. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la nota débito cliente. Si no se envía este atributo la aplicación intenta crear la nota débit cliente con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.
      - `id` string — Id de la numeración
      - `number` string — Número de la nota débito cliente (enviar en caso de que la numeración sea manual, requerido)
    - `type` 'DEBIT_NOTE', required — Tipo de nota de débito cliente
    - `invoice` object — Objeto que contiene el id de la factura asociada a la nota de débito cliente
      - `id` string — Id de la factura
    - `creditNote` object — Objeto que contiene el id de la nota de crédito asociada a la nota de débito cliente. en costa rica solo se puede asociar un tipo de documento, factura o nota de crédito, arrojará error si se envía invoice y creditNote
      - `id` string — Id de la nota de crédito
    - `paymentMethod` string, required — Indica la forma de pago de la nota debito cliente. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).
    - `stamp` object — Objeto stamp indica que se desea expedir/emitir la nota de crédito electrónica en Alegra.
      - `generateStamp` boolean — si se desea emitir la nota debito cliente
    - `items` object[], required — Array de objetos item con propiedades específicas para Costa Rica versión 4.3
      - `id` string — Identificador del producto
      - `name` string — Nombre del producto
      - `description` string — Descripción del producto/servicio
      - `reference` string — Referencia del producto
      - `price` number — Precio de venta del producto
      - `quantity` number — Cantidad del producto
      - `discount` object — Objeto de descuento con nuevas propiedades para Costa Rica versión 4.3.
        - `discount` number, required — Porcentaje o monto de descuento
        - `nature` string, required — Descripción del descuento
      - `tax` object[] — Array de impuestos con exoneraciones para Costa Rica versión 4.3.
        - `id` string — Identificador único que representa el impuesto un impuesto en específico
        - `exoneration` object — Objeto opcional cuando se aplique una exoneración a un impuesto en específico.
          - `documentType` 'AUTHORIZED_PURCHASES' | 'EXEMPT_SALES_TO_DIPLOMATS' | 'AUTHORIZED_BY_SPECIAL_LAW' | 'EXEMPTIONS_DGH' | 'TRANSITORY_V' | 'TRANSITORY_IX' | 'TRANSITORY_XVII' | 'OTHER' — Tipo de documento de exoneración
          - `documentNumber` string — Número del documento de exoneración
          - `institutionName` string — Nombre de la institución emisora
          - `percentage` string — Porcentaje de exoneración
    - `additionalCharges` object[] — Array de cargos adicionales para la versión 4.3 de Costa Rica.
      - `id` string — Identificador único que representa el cargo adicional en específico
      - `amount` number — Monto del cargo adicional en la moneda de la nota de crédito
      - `metadata` object — Metadatos del cargo adicional. Se envía cuando el cargo es por cobro de tercero
        - `thirdParty` object — Información de tercero cuando el cargo es por cobro de tercero
          - `thirdPartyName` string — Nombre del tercero
          - `identificationNumber` string — Número de identificación del tercero
  - object
    - `date` string, required — Fecha de creación de la nota de debito. Formato yyyy-MM-dd
    - `dueDate` string, required — Fecha de vencimiento de la nota de debito. Formato yyyy-MM-dd
    - `annotation` string — Notas de la nota de débito cliente, visibles en el PDF o documento impreso.
    - `account` object — Cuenta bancaria, si paymentMethod es CASH la cuenta bancaría es requerida
      - `id` string — Id de la cuenta bancaria
    - `client` object, required — Objeto que contiene el id del cliente asociado a la nota de débito cliente
      - `id` string — Id del cliente
    - `numberTemplate` object — Objeto que contiene la información de la numeración de la nota débito cliente. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la nota débito cliente. Si no se envía este atributo la aplicación intenta crear la nota débit cliente con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error.
      - `id` string — ID de la numeración
      - `prefix` string — Prefijo de la nota débito cliente (enviar en caso de que la numeración sea manual, opcional)
      - `number` string — Número de la nota débito cliente (enviar en caso de que la numeración sea manual, requerido)
    - `paymentMethod` 'CASH' | 'CREDIT' | 'CARD' | 'CONSIGNATION' | 'SEPARATED' | 'SERVICES_PROVIDED_TO_STATE_TO_CREDIT' | 'OPERATIVE_LEASING' | 'FINANCIAL_LEASING', required — Para Costa Rica versión 4.4, indica el método de pago de la nota de débito.
    - `type` string, required — Indica el tipo de la nota de débito. Consulta el catálogo de parámetros correspondiente haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).
    - `otherTypeReason` string — Campo obligatorio cuando type es OTHER. Descripción del motivo de la nota de débito personalizado.
    - `invoice` object — Objeto que contiene el id de la factura asociada a la nota de débito cliente
      - `id` string — Id de la factura
    - `creditNote` object — Objeto que contiene el id de la nota de crédito asociada a la nota de débito cliente. en Costa rica solo se puede asociar un tipo de documento, factura o nota de crédito, arrojará error si se envía invoice y creditNote
      - `id` string — Id de la nota de crédito
    - `stamp` object — Para Costa Rica versión 4.4, el objeto stamp indica que se desea expedir/emitir la nota de débito electrónica en Alegra.
      - `generateStamp` boolean
    - `economicActivity` integer — Para Costa Rica versión 4.4, indica el código de la actividad económica asociada a la nota de débito. Si no se envía, se asignará por defecto el código de la actividad económica de la compañía.
    - `items` object[] — Array de objetos item con propiedades específicas para Costa Rica versión 4.4
      - `id` string — Identificador del producto
      - `name` string — Nombre del producto
      - `description` string — Descripción del producto/servicio
      - `reference` string — Referencia del producto
      - `price` number — Precio de venta del producto
      - `quantity` number — Cantidad del producto
      - `transactionType` 'NORMAL_SALE_OF_GOODS_AND_SERVICES_GENERAL_TRANSACTION' | 'SELF_CONSUMPTION_GOODS_EXEMPT' | 'SELF_CONSUMPTION_GOODS_TAXED' | 'SELF_CONSUMPTION_SERVICE_EXEMPT' | 'SELF_CONSUMPTION_SERVICE_TAXED' | 'MEMBERSHIP_FEE' | 'MEMBERSHIP_FEE_EXEMPT' | 'CAPITAL_GOODS_FOR_ISSUER' | 'CAPITAL_GOODS_FOR_RECEIVER' | 'SELF_CONSUMPTION_CAPITAL_GOODS_EXEMPT_FOR_ISSUER' | 'CAPITAL_GOODS_WITHOUT_CONSIDERATION_TO_THIRD_PARTIES_EXEMPT_FOR_ISSUER' | 'CAPITAL_GOODS_WITHOUT_CONSIDERATION_TO_THIRD_PARTIES_EXEMPT_FOR_RECEIVER' | 'WITHOUT_CONSIDERATION_TO_THIRD_PARTIES' — Tipo de transacción según catálogo de Costa Rica versión 4.4. Consulta el catálogo de parámetros correspondiente haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).
      - `discount` object — Objeto de descuento con nuevas propiedades para Costa Rica versión 4.4.
        - `discount` number — Porcentaje o monto de descuento
        - `type` 'VOLUME_DISCOUNT' | 'SEASONAL_DISCOUNT' | 'PROMOTIONAL_DISCOUNT' | 'COMMERCIAL_DISCOUNT' | 'FREQUENCY_DISCOUNT' | 'SUSTAINED_DISCOUNT' | 'OTHER' — Tipo de descuento según catálogo de Costa Rica versión 4.4. Consulta el catálogo de parámetros correspondiente haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).
        - `nature` string — Campo obligatorio cuando type es OTHER. Descripción del descuento personalizado
      - `tax` object[] — Array de impuestos con exoneraciones para Costa Rica versión 4.4.
        - `id` string — Identificador único que representa el impuesto un impuesto en específico
        - `exoneration` object — Objeto opcional cuando se aplique una exoneración a un impuesto en específico.
          - `documentType` 'AUTHORIZED_PURCHASES' | 'EXEMPT_SALES_TO_DIPLOMATS' | 'AUTHORIZED_BY_SPECIAL_LAW' | 'EXEMPTIONS_DGH' | 'TRANSITORY_V' | 'TOURISTIC_SERVICES' | 'TRANSITORY_XVII' | 'EXONERATION_ZONE_FREE' | 'EXONERATION_COMPLEMENTARY_SERVICES_EXPORT' | 'ORGANIZATION_MUNICIPAL_CORPORATIONS' | 'EXEMPTIONS_DGH_CONCRETE_LOCAL_TAX' | 'OTHER' — Tipo de documento de exoneración
          - `otherDocumentType` string — Campo obligatorio cuando documentType es OTHER
          - `documentNumber` string — Número del documento de exoneración
          - `article` string — Artículo del documento
          - `paragraph` string — Inciso del documento
          - `emissionDate` string, date — Fecha de emisión del documento
          - `institutionName` 'MINISTRY_OF_FINANCE' | 'MINISTRY_OF_FOREIGN_AFFAIRS_AND_WORSHIP' | 'MINISTRY_OF_AGRICULTURE_AND_LIVESTOCK' | 'MINISTRY_OF_ECONOMY_INDUSTRY_AND_COMMERCE' | 'COSTA_RICAN_RED_CROSS' | 'COSTA_RICA_FIRE_DEPARTMENT' | 'HOLY_SPIRIT_WORKS_ASSOCIATION' | 'NATIONAL_CRUSADE_FEDERATION_FOR_ELDERLY_PROTECTION' | 'HUMID_REGION_AGRICULTURE_SCHOOL' | 'CENTRAL_AMERICAN_INSTITUTE_OF_BUSINESS_ADMINISTRATION' | 'SOCIAL_PROTECTION_BOARD' | 'PUBLIC_SERVICES_REGULATORY_AUTHORITY' | 'OTHER' — Nombre de la institución emisora
          - `otherInstitutionName` string — Campo obligatorio cuando institutionName es OTHER
          - `percentage` string — Porcentaje de exoneración
    - `additionalCharges` object[] — Array de cargos adicionales para la versión 4.4 de Costa Rica.
      - `id` string — Identificador único que representa el cargo adicional en específico
      - `amount` number — Monto del cargo adicional en la moneda de la nota de débito
      - `metadata` object — Metadatos del cargo adicional. Se envía cuando el cargo es por cobro de tercero o cuando el cargo es de tipo otros.
        - `thirdParty` object — Información de tercero cuando el cargo es por cobro de tercero
          - `thirdPartyName` string — Nombre del tercero
          - `identificationNumber` string — Número de identificación del tercero
          - `identificationType` string — Tipo de identificación del tercero. Consulta el catálogo de parámetros correspondiente haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica).
          - `idThirdParty` string — Identificador del contacto en el sistema
        - `otherTypeCharge` string — Descripción del cargo cuando es de tipo otros

## Response `200`

Retorna información de una nota de crédito.

## Other responses

- `400` — Bad request

---

[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)