---
title: "Editar nota débito cliente"
method: PUT
path: "/income-debit-notes/{id}"
tags: ["Notas Débito cliente"]
---

# Editar nota débito cliente

`PUT /income-debit-notes/{id}`

Endpoint que permite editar una nota débito cliente en la aplicación. Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos. Se retorna la nota débito cliente que se ha modificado.

## Path parameters

- `id` string, required

## Request body

- union
  - object
    - `date` string — Fecha de creación de la nota de debito. Formato yyyy-MM-dd
    - `dueDate` string — 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 — 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' — 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 — 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).
    - `items` object[] — 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 — Fecha de creación de la nota de debito. Formato yyyy-MM-dd
    - `dueDate` string — 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 — 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' — Para Costa Rica versión 4.4, indica el método de pago de la nota de débito.
    - `type` string — 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 débito cliente.

## Other responses

- `400` — unresolved $ref

---

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