Billme
  • Billme
  • Primeros pasos
    • Registro
    • Navegación del menú
  • USO DE LA API
    • Registro de empresas
    • Envío de documentos
      • Factura / Boleta
      • Resumen de Boletas
      • Nota de Crédito
      • Nota de Débito
      • Guía de Remisión
      • Consulta Comprobante
      • Respuesta de consultas
    • Catálogo de códigos
Powered by GitBook
On this page
  • Request body
  • Ejemplos
  1. USO DE LA API
  2. Envío de documentos

Nota de Crédito

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

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

Request body

Nombre
Tipo
Descripción

tipoComprobante*

string

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

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 "01"

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 total del IGV

icbper*

decimal

Monto total del impuesto a las bolsas de plástico

emisor*

object

cliente*

object

totales*

object

productos*

object

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

codigoClasifiacion*

string

Código de la clasificación del producto

impuestos*

object

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": "07",
    "moneda": "PEN",
    "serie": "BN01",
    "correlativo": "1314",
    "fechaEmision": "2024-04-16",
    "horaEmision": "00:00:00",
    "codigoMotivo": "01",
    "descripcionMotivo": "modificación",
    "tipoComprobanteRef": "03",
    "serieComprobanteRef": "B002",
    "correlativoComprobanteRef": "31",
    "emisor": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20607599727",
        "razonSocial": "emisor de prueba",
        "sucursal": "0001"
    },
    "cliente": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20605145648",
        "razonSocial": "cliente de prueba"
    },
    "igv": 9.03, 
    "icbper": 0.50,
    "totales": {
        "totalOpExoneradas": 140,
        "totalOpInafectas": 270,
        "TotalOpGravadas": 50.17,
        "totalImpuestos": 9.53,
        "totalPagar": 469.70
    },
    "productos": [
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "MOCHILA",
            "moneda": "PEN",
            "precioUnitario": 50,
            "precioLista": 49,
            "montoSinImpuesto": 50,
            "montoImpuestos": 9,
            "montoTotal": 50,
            "montoIcbper": 0,
            "factorIcbper": 0,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 9,
                    "idCategoria": "S",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "10",
                    "codigoTributo": "1000",
                    "nombreTributo": "IGV",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "12",
            "codigoClasificacion": "10191509"
        },
        {
            "unidades": 2,
            "codigoUnidad": "NIU",
            "nombre": "LIBRO",
            "moneda": "PEN",
            "precioUnitario": 70,
            "precioLista": 70,
            "montoSinImpuesto": 140,
            "montoImpuestos": 0,
            "montoTotal": 140,
            "montoIcbper": 0,
            "factorIcbper": 0,
            "montoDescuento": 0,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0,
                    "idCategoria": "E",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "20",
                    "codigoTributo": "9997",
                    "nombreTributo": "EXO",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "12",
            "codigoClasificacion": "10191509"
        },
        {
            "unidades": 3,
            "codigoUnidad": "NIU",
            "nombre": "MANZANA",
            "moneda": "PEN",
            "precioUnitario": 90,
            "precioLista": 90,
            "montoSinImpuesto": 270,
            "montoImpuestos": 0,
            "montoTotal": 270,
            "montoIcbper": 0,
            "factorIcbper": 0.50,
            "montoDescuento": 0,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0,
                    "idCategoria": "O",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "30",
                    "codigoTributo": "9998",
                    "nombreTributo": "INA",
                    "codigoInterTributo": "FRE"
                }
            ],
            "id": "12",
            "codigoClasificacion": "10191509"
        },
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "BOLSA PLÁSTICA",
            "moneda": "PEN",
            "precioUnitario": 0.17,
            "precioLista": 0.70,
            "montoSinImpuesto": 0.17,
            "montoImpuestos": 0.50,
            "montoTotal": 0.17,
            "montoIcbper": 0.50,
            "factorIcbper": 0.50,
            "montoDescuento": 0,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0.53,
                    "idCategoria": "S",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "10",
                    "codigoTributo": "1000",
                    "nombreTributo": "IGV",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "12",
            "codigoClasificacion": "10191509"
        }
    ]
}

PreviousResumen de BoletasNextNota de Débito

Last updated 3 days ago

Datos del

Datos del

Detalle de los montos del comprobante

Listado de los del comprobante

Objeto del producto

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

Catálogo de códigos
emisor
cliente
totales
productos
impuestos