Nota de Débito

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

POST https://www.api.billmeperu.com/api/v1/Emission/EnviarNotaDebito

Request body

Nombre
Tipo
Descripción

tipoComprobante*

string

Identificador del tipo de comprobante, por defecto es "08"

serie*

string

Código de serie del comprobante

correlativo*

string

Número correlativo del comprobante

fechaEmision*

string

Fecha en la que se realiza la emisión, debe estar en formato YYYY-MM-DD

horaEmision*

string

Hora en la que se realiza la emisión, si lo desea puede ser por defecto "00:00:00"

codigoMotivo*

string

Código del tipo de nota, por defecto es "02"

descripcionMotivo*

string

texto descriptivo de la razón de la nota de crédito

moneda*

string

Código de la moneda

tipoComprobanteRef*

string

Código del comprobante al que se le aplica la nota de crédito, para Facturas es "01" y para Boletas es "03"

serieComprobanteRef*

string

Serie del comprobante al que se le aplica la nota de crédito

correlativoComprobanteRef*

string

Número correlativo del comprobante al que se le aplica la nota de crédito

igv*

decimal

Monto del IGV aplicado al documento

icbper*

decimal

Monto del impuesto a las bolsas de plástico en caso aplique

emisor*

object

Datos del emisor

cliente*

object

Datos del cliente

totales*

object

Detalle de los montos totales del comprobante

productos*

object

Listado de los productos del comprobante

Objeto emisor

Nombre
Tipo
Descripción

codigoTipoDocumento*

string

Código del tipo de documento del emisor, para RUC el código es "6"

numDocumento*

string

Número de documento del emisor

razonSocial*

string

Razón social del emisor

sucursal*

string

Código de sucursal desde donde se emite el comprobante, por defecto es "0000"

Objeto cliente

Nombre
Tipo
Descripción

codigoTipoDocumento*

string

Código del tipo de documento (RUC, DNI, etc)

numDocumento*

string

Número de documento del cliente

razonSocial*

string

Razón Social o Nombre del cliente

Objeto totales

Nombre
Tipo
Descripción

totalOpExoneradas*

decimal

Monto total de las operaciones exoneradas de impuestos

totalOpInafectas*

decimal

Monto total de las operaciones inafectas a impuestos

totalOpGravadas*

decimal

Monto total de las operaciones gravadas de impuestos

totalImpuestos*

decimal

Monto total de impuestos

totalPagar*

decimal

Monto total a pagar

Objeto productos

Nombre
Tipo
Descripción

unidades*

decimal

Cantidad de unidades del producto

codigoUnidad*

string

Código de la unidad del producto

nombre*

string

Nombre del producto

moneda*

string

Código de la moneda del producto

precioUnitario*

decimal

Monto del precio unitario del producto

precioLista*

decimal

Monto de lista interno del producto

montoSinImpuesto*

decimal

Monto antes de impuestos del producto

montoImpuestos*

decimal

Monto de los impuestos aplicados al producto

montoTotal*

decimal

Monto total del producto incluido impuestos

montoIcbper*

decimal

Monto del impuesto a las bolsas plásticas aplicado al producto, en caso no aplique puede ser 0

factorIcbper*

decimal

Monto del impuesto a las bolsas plásticas aplicado al producto, siempre debe ser mayor a 0 en caso se aplique el impuesto

codigoTipoPrecio*

string

Código del tipo de precio del producto, por defecto puede ser "01"

id*

string

Código identificador del producto

impuestos*

object

Objeto impuestos del producto

Objeto impuestos

Nombre
Tipo
Descripción

monto*

decimal

Monto total del impuesto aplicado

idCategoria*

string

Id de la categoría del impuesto

porcentaje*

decimal

Porcentaje del impuesto aplicado

codigoAfectacionIgv*

string

Código de la afectación del IGV asociado al impuesto

codigoTributo*

string

Código del tributo asociado al impuesto

nombreTributo*

string

Nombre del tributo

codigoInterTributo*

string

Código interno del tributo

Ejemplos

{
    "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"
        }
    ]
}

Los tipos de códigos los puedes encontrar en la sección "Catálogo de códigos"

Last updated