> For the complete documentation index, see [llms.txt](https://quinodevelop.gitbook.io/billme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quinodevelop.gitbook.io/billme/uso-de-la-api/markdown/nota-de-debito.md).

# Nota de Débito

Para el envío de emisiones de Notas de Débito debes incluir los siguientes valores en el request:

<mark style="color:green;">**`POST`**</mark> `https://www.api.billmeperu.com/api/v1/Emission/EnviarNotaDebito`

### Request body

<table><thead><tr><th width="277">Nombre</th><th width="138">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>tipoComprobante<mark style="color:red;">*</mark></td><td>string</td><td>Identificador del tipo de comprobante, por defecto es "08"</td></tr><tr><td>serie<mark style="color:red;">*</mark> </td><td>string</td><td>Código de serie del comprobante</td></tr><tr><td>correlativo<mark style="color:red;">*</mark> </td><td>string</td><td>Número correlativo del comprobante</td></tr><tr><td>fechaEmision<mark style="color:red;">*</mark> </td><td>string</td><td>Fecha en la que se realiza la emisión, debe estar en formato YYYY-MM-DD</td></tr><tr><td>horaEmision<mark style="color:red;">*</mark> </td><td>string</td><td>Hora en la que se realiza la emisión, si lo desea puede ser por defecto "00:00:00"</td></tr><tr><td>codigoMotivo<mark style="color:red;">*</mark> </td><td>string</td><td>Código del tipo de nota, por defecto es "02"</td></tr><tr><td>descripcionMotivo<mark style="color:red;">*</mark> </td><td>string</td><td>texto descriptivo de la razón de la nota de crédito</td></tr><tr><td>moneda<mark style="color:red;">*</mark> </td><td>string</td><td>Código de la moneda</td></tr><tr><td>tipoComprobanteRef<mark style="color:red;">*</mark> </td><td>string</td><td>Código del comprobante al que se le aplica la nota de crédito, para Facturas es "01" y para Boletas es "03"</td></tr><tr><td>serieComprobanteRef<mark style="color:red;">*</mark></td><td>string</td><td>Serie del comprobante al que se le aplica la nota de crédito</td></tr><tr><td>correlativoComprobanteRef<mark style="color:red;">*</mark></td><td>string</td><td>Número correlativo del comprobante al que se le aplica la nota de crédito</td></tr><tr><td>igv<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del IGV aplicado al documento</td></tr><tr><td>icbper<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del impuesto a las bolsas de plástico en caso aplique</td></tr><tr><td>emisor<mark style="color:red;">*</mark> </td><td>object</td><td>Datos del <a href="#objeto-emisor">emisor</a></td></tr><tr><td>cliente<mark style="color:red;">*</mark> </td><td>object</td><td>Datos del <a href="#objeto-cliente">cliente</a></td></tr><tr><td>totales<mark style="color:red;">*</mark></td><td>object</td><td>Detalle de los montos <a href="#objeto-totales">totales</a> del comprobante</td></tr><tr><td>productos<mark style="color:red;">*</mark></td><td>object</td><td>Listado de los <a href="#objeto-productos">productos</a> del comprobante</td></tr></tbody></table>

#### Objeto `emisor`

<table><thead><tr><th width="231">Nombre</th><th width="139">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de documento del emisor, para RUC el código es "6"</td></tr><tr><td>numDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Número de documento del emisor</td></tr><tr><td>razonSocial<mark style="color:red;">*</mark></td><td>string</td><td>Razón social del emisor</td></tr><tr><td>sucursal<mark style="color:red;">*</mark></td><td>string</td><td>Código de sucursal desde donde se emite el comprobante, por defecto es "0000"</td></tr></tbody></table>

#### Objeto `cliente`

<table><thead><tr><th width="231">Nombre</th><th width="142">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de documento (RUC, DNI, etc)</td></tr><tr><td>numDocumento<mark style="color:red;">*</mark></td><td>string</td><td>Número de documento del cliente</td></tr><tr><td>razonSocial<mark style="color:red;">*</mark></td><td>string</td><td>Razón Social o Nombre del cliente</td></tr></tbody></table>

#### Objeto `totales`

<table><thead><tr><th width="246">Nombre</th><th width="141">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>totalOpExoneradas<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones exoneradas de impuestos</td></tr><tr><td>totalOpInafectas<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones inafectas a impuestos</td></tr><tr><td>totalOpGravadas<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones gravadas de impuestos</td></tr><tr><td>totalImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de impuestos</td></tr><tr><td>totalPagar<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total a pagar</td></tr></tbody></table>

#### Objeto `productos`

<table><thead><tr><th width="249">Nombre</th><th width="136">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>unidades<mark style="color:red;">*</mark></td><td>decimal</td><td>Cantidad de unidades del producto</td></tr><tr><td>codigoUnidad<mark style="color:red;">*</mark></td><td>string</td><td>Código de la unidad del producto</td></tr><tr><td>nombre<mark style="color:red;">*</mark></td><td>string</td><td>Nombre del producto</td></tr><tr><td>moneda<mark style="color:red;">*</mark></td><td>string</td><td>Código de la moneda del producto</td></tr><tr><td>precioUnitario<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del precio unitario del producto</td></tr><tr><td>precioLista<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto de lista interno del producto</td></tr><tr><td>montoSinImpuesto<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto antes de impuestos del producto</td></tr><tr><td>montoImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto de los impuestos aplicados al producto</td></tr><tr><td>montoTotal<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total del producto incluido impuestos</td></tr><tr><td>montoIcbper<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del impuesto a las bolsas plásticas aplicado al producto, en caso no aplique puede ser 0</td></tr><tr><td>factorIcbper<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del impuesto a las bolsas plásticas aplicado al producto, siempre debe ser mayor a 0 en caso se aplique el impuesto</td></tr><tr><td>codigoTipoPrecio<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de precio del producto, por defecto puede ser "01"</td></tr><tr><td>id<mark style="color:red;">*</mark></td><td>string</td><td>Código identificador del producto</td></tr><tr><td>impuestos<mark style="color:red;">*</mark></td><td>object</td><td>Objeto <a href="#objeto-impuestos">impuestos</a> del producto</td></tr></tbody></table>

#### Objeto `impuestos`&#x20;

<table><thead><tr><th width="248">Nombre</th><th width="136">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>monto<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total del impuesto aplicado</td></tr><tr><td>idCategoria<mark style="color:red;">*</mark></td><td>string</td><td>Id de la categoría del impuesto</td></tr><tr><td>porcentaje<mark style="color:red;">*</mark></td><td>decimal</td><td>Porcentaje del impuesto aplicado</td></tr><tr><td>codigoAfectacionIgv<mark style="color:red;">*</mark></td><td>string</td><td>Código de la afectación del IGV asociado al impuesto</td></tr><tr><td>codigoTributo<mark style="color:red;">*</mark></td><td>string</td><td>Código del tributo asociado al impuesto</td></tr><tr><td>nombreTributo<mark style="color:red;">*</mark></td><td>string</td><td>Nombre del tributo</td></tr><tr><td>codigoInterTributo<mark style="color:red;">*</mark></td><td>string</td><td>Código internacional del tributo</td></tr></tbody></table>

### Ejemplos

```json
{
    "tipoComprobante": "08",
    "moneda": "PEN",
    "serie": "BN04",
    "correlativo": "4523",
    "fechaEmision": "2024-04-16",
    "horaEmision": "00:00:00",
    "codigoMotivo": "02",
    "descripcionMotivo": "aumento en precio",
    "tipoComprobanteRef": "03",
    "serieComprobanteRef": "B002",
    "correlativoComprobanteRef": "31",
    "igv": 9.03,
    "icbper": 0.30,
    "emisor": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20607599727",
        "razonSocial": "emisor de prueba",
        "sucursal": "0000"
    },
    "cliente": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20605145648",
        "razonSocial": "cliente de prueba"
    },
    "totales": {
        "TotalOpGravadas": 50.17,
        "TotalOpExoneradas": 140,
        "TotalOpInafectas": 270,
        "totalImpuestos": 9.33,
        "totalPagar": 469.50
    },
    "productos": [
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "mochila",
            "moneda": "PEN",
            "precioUnitario": 50,
            "precioLista": 59,
            "montoSinImpuesto": 50,
            "montoImpuestos": 9,
            "montoTotal": 50,
            "montoIcbper": 0,
            "factorIcbper": 0.30,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 9,
                    "idCategoria": "S",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "10",
                    "codigoTributo": "1000",
                    "nombreTributo": "IGV",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "17"
        },
        {
            "unidades": 2,
            "codigoUnidad": "NIU",
            "nombre": "libro",
            "moneda": "PEN",
            "precioUnitario": 70,
            "precioLista": 70,
            "montoSinImpuesto": 140,
            "montoImpuestos": 0,
            "montoTotal": 140,
            "montoIcbper": 0,
            "factorIcbper": 0.30,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0,
                    "idCategoria": "E",
                    "porcentaje": 0,
                    "codigoAfectacionIgv": "20",
                    "codigoTributo": "9997",
                    "nombreTributo": "EXO",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "10"
        },
        {
            "unidades": 3,
            "codigoUnidad": "NIU",
            "nombre": "manzana",
            "moneda": "PEN",
            "precioUnitario": 90,
            "precioLista": 90,
            "montoSinImpuesto": 270,
            "montoImpuestos": 0,
            "montoTotal": 270,
            "montoIcbper": 0,
            "factorIcbper": 0.30,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0,
                    "idCategoria": "E",
                    "porcentaje": 0,
                    "codigoAfectacionIgv": "30",
                    "codigoTributo": "9998",
                    "nombreTributo": "INA",
                    "codigoInterTributo": "FRE"
                }
            ],
            "id": "11"
        },
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "bolsa",
            "moneda": "PEN",
            "precioUnitario": 0.17,
            "precioLista": 0.50,
            "montoSinImpuesto": 0.17,
            "montoImpuestos": 0.03,
            "montoTotal": 0.17,
            "montoIcbper": 0.30,
            "factorIcbper": 0.30,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0.33,
                    "idCategoria": "S",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "10",
                    "codigoTributo": "1000",
                    "nombreTributo": "IGV",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "12"
        }
    ]
}
```

{% hint style="info" %}
Los tipos de códigos los puedes encontrar en la sección "[Catálogo de códigos](/billme/uso-de-la-api/catalogo-de-codigos.md)"
{% endhint %}