Factura / Boleta

Para el envío de emisiones de Facturas o Boletas debes incluir los siguientes valores en el request:

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

Request body

Nombre	Tipo	Descripción
tipoOperacion*	string	Identificador del tipo de operación que identifica al comprobante, por defecto es "010"
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"
fechaVencimiento*	string	Fecha de vencimiento del comprobante, puede ser la misma que la fecha de emisión, debe estar en formato YYYY-MM-DD
codigoTipoOperacion*	string	Código del tipo de operación, para Facturas y Boletas se envía el valor "0101"
codigoTipoDocumento*	string	Código del tipo de documento a emitir, para Facturas es "01" y para Boletas es "03"
moneda*	string	Código de la moneda
montoCredito*	decimal	Monto del crédito del documento en caso sea una Factura al crédito, de ser al contado el monto debe ser 0
formaPago*	string	Forma de pago del documento "Contado" o "Crédito"
igv*	decimal	Monto total del IGV
icbper*	decimal	Monto total del impuesto a las bolsas de plástico
cuotas	object	Listado de las cuotas de la Factura al crédito
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 cuotas

Nombre	Tipo	Descripción
numero*	string	Número de la cuota en formato "000"
importe*	decimal	Valor del importe de la cuota
fechaVencimiento*	string	Fecha de vencimiento de la cuota en formato YYYY-MM-DD

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
ubigeo*	string	Ubigeo perteneciente a la dirección del emisor
ciudad	string	Ciudad perteneciente a la dirección del emisor
distrito	string	Distrito perteneciente a la dirección del emisor
provincia	string	Provincia perteneciente a la dirección del emisor
direccion	string	Dirección específica 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
ubigeo	string	Ubigeo perteneciente a la dirección del cliente
ciudad	string	Ciudad perteneciente a la dirección del cliente
distrito	string	Distrito perteneciente a la dirección del cliente
provincia	string	Provincia perteneciente a la dirección del cliente
direccion	string	Dirección específica 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
totalSinImpuestos*	decimal	Monto total de las operaciones antes de impuestos
totalConImpuestos*	decimal	Monto total de las operaciones incluidos impuestos
totalPagar*	decimal	Monto total a pagar
totalDescuentoGlobal*	decimal	Monto total del descuento global aplicado
totalDescuentoProductos*	decimal	Suma total de los descuentos aplicados a los productos

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
montoDescuento*	decimal	Monto del descuento aplicado al producto
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 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

Factura

{
  "tipoOperacion": "010",
  "serie": "F301",
  "correlativo": "345",
  "fechaEmision": "2024-04-07",
  "horaEmision": "00:00:00",
  "fechaVencimiento": "2024-04-07",
  "codigoTipoOperacion": "0101",
  "codigoTipoDocumento": "01",
  "moneda": "PEN",
  "montoCredito": 0,
  "formaPago": "Contado",
  "igv": 9.03,
  "icbper": 0.50,
  "cuotas": [],
  "emisor": {
    "codigoTipoDocumento": "6",
    "numDocumento": "20607599727",
    "razonSocial": "INSTITUTO INTERNACIONAL DE SOFTWARE S.A.C.",
    "nombreComercial": "ACADEMIA DE SOFTWARE",
    "ubigeo": "140101",
    "ciudad": "LAMBAYEQUE",
    "distrito": "CHICLAYO",
    "provincia": "CHICLAYO",
    "direccion": "CALLE OCHO DE OCTUBRE 123",
    "sucursal": "0000"
  },
  "cliente": {
    "codigoTipoDocumento": "6",
    "numDocumento": "20605145648",
    "razonSocial": "GROINVERSIONES Y SERVICIOS AJINOR S.R.L. - AGROS",
    "ubigeo": "",
    "ciudad": "",
    "distrito": "",
    "provincia": "",
    "direccion": ""
  },
  "totales": {
    "totalOpExoneradas": 140,
    "totalOpInafectas": 270,
    "totalOpGravadas": 50.17,
    "totalImpuestos": 9.53,
    "totalSinImpuestos": 460.17,
    "totalConImpuestos": 469.70,
    "totalPagar": 459.70,
    "totalDescuentoGlobal": 0,
    "totalDescuentoProductos": 10
  },
  "productos": [
    {
      "unidades": 1,
      "codigoUnidad": "NIU",
      "nombre": "MOCHILA",
      "moneda": "PEN",
      "precioUnitario": 50,
      "precioLista": 49,
      "montoSinImpuesto": 50,
      "montoImpuestos": 9,
      "montoTotal": 50,
      "montoIcbper": 0,
      "factorIcbper": 0.50,
      "montoDescuento": 10,
      "codigoTipoPrecio": "01",
      "impuestos": [
        {
          "monto": 9,
          "idCategoria": "S",
          "porcentaje": 18,
          "codigoAfectacionIgv": "10",
          "codigoTributo": "1000",
          "nombreTributo": "IGV",
          "codigoInterTributo": "VAT"
        }
      ],
      "id": "p-001",
      "codigoClasificacion": "10191509"
    },
    {
      "unidades": 2,
      "codigoUnidad": "NIU",
      "nombre": "LIBRO",
      "moneda": "PEN",
      "precioUnitario": 70,
      "precioLista": 70,
      "montoSinImpuesto": 140,
      "montoImpuestos": 0,
      "montoTotal": 140,
      "montoIcbper": 0,
      "factorIcbper": 0.50,
      "montoDescuento": 0,
      "codigoTipoPrecio": "01",
      "impuestos": [
        {
          "monto": 0,
          "idCategoria": "E",
          "porcentaje": 18,
          "codigoAfectacionIgv": "20",
          "codigoTributo": "9997",
          "nombreTributo": "EXO",
          "codigoInterTributo": "VAT"
        }
      ],
      "id": "p-002",
      "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": "p-003",
      "codigoClasificacion": "10191509"
    },
    {
      "unidades": 1,
      "codigoUnidad": "NIU",
      "nombre": "bolsa plastica",
      "moneda": "PEN",
      "precioUnitario": 0.17,
      "precioLista": 0.70,
      "montoSinImpuesto": 0.17,
      "montoImpuestos": 0.03,
      "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": "p-004",
      "codigoClasificacion": "10191509"
    }
  ]
}

Boleta

{
  "tipoOperacion": "010",
  "serie": "B015",
  "correlativo": "214",
  "fechaEmision": "2024-08-23",
  "horaEmision": "00:00:00",
  "fechaVencimiento": "2024-08-23",
  "codigoTipoOperacion": "0101",
  "codigoTipoDocumento": "03",
  "moneda": "PEN",
  "montoCredito": 0,
  "formaPago": "Contado",
  "igv": 9.03,
  "icbper": 0.50,
  "emisor": {
    "codigoTipoDocumento": "6",
    "numDocumento": "20607599727",
    "razonSocial": "INSTITUTO INTERNACIONAL DE SOFTWARE S.A.C.",
    "nombreComercial": "ACADEMIA DE SOFTWARE",
    "ubigeo": "140101",
    "ciudad": "LAMBAYEQUE",
    "distrito": "CHICLAYO",
    "provincia": "CHICLAYO",
    "direccion": "CALLE OCHO DE OCTUBRE 123",
    "sucursal": "0000"
  },
  "cliente": {
    "codigoTipoDocumento": "6",
    "numDocumento": "20605145648",
    "razonSocial": "GROINVERSIONES Y SERVICIOS AJINOR S.R.L. - AGROS",
    "ubigeo": "",
    "ciudad": "",
    "distrito": "",
    "provincia": "",
    "direccion": ""
  },
  "totales": {
    "totalOpExoneradas": 140,
    "totalOpInafectas": 270,
    "totalOpGravadas": 50.17,
    "totalImpuestos": 9.53,
    "totalSinImpuestos": 460.17,
    "totalConImpuestos": 469.70,
    "totalPagar": 459.70,
    "totalDescuentoGlobal": 0,
    "totalDescuentoProductos": 10
  },
  "productos": [
    {
      "unidades": 1,
      "codigoUnidad": "NIU",
      "nombre": "MOCHILA",
      "moneda": "PEN",
      "precioUnitario": 50,
      "precioLista": 49,
      "montoSinImpuesto": 50,
      "montoImpuestos": 9,
      "montoTotal": 50,
      "montoIcbper": 0,
      "factorIcbper": 0.50,
      "montoDescuento": 10,
      "codigoTipoPrecio": "01",
      "impuestos": [
        {
          "monto": 9,
          "idCategoria": "S",
          "porcentaje": 18,
          "codigoAfectacionIgv": "10",
          "codigoTributo": "1000",
          "nombreTributo": "IGV",
          "codigoInterTributo": "VAT"
        }
      ],
      "id": "P-001",
      "codigoClasificacion": "10191509"
    },
    {
      "unidades": 2,
      "codigoUnidad": "NIU",
      "nombre": "LIBRO",
      "moneda": "PEN",
      "precioUnitario": 70,
      "precioLista": 70,
      "montoSinImpuesto": 140,
      "montoImpuestos": 0,
      "montoTotal": 140,
      "montoIcbper": 0,
      "factorIcbper": 0.50,
      "montoDescuento": 0,
      "codigoTipoPrecio": "01",
      "impuestos": [
        {
          "monto": 0,
          "idCategoria": "E",
          "porcentaje": 18,
          "codigoAfectacionIgv": "20",
          "codigoTributo": "9997",
          "nombreTributo": "EXO",
          "codigoInterTributo": "VAT"
        }
      ],
      "id": "P-002",
      "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": "P-003",
      "codigoClasificacion": "10191509"
    },
    {
      "unidades": 1,
      "codigoUnidad": "NIU",
      "nombre": "bolsa plastica",
      "moneda": "PEN",
      "precioUnitario": 0.17,
      "precioLista": 0.70,
      "montoSinImpuesto": 0.17,
      "montoImpuestos": 0.03,
      "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": "P-004",
      "codigoClasificacion": "10191509"
    }
  ]
}

Factura al crédito

{
    "tipoOperacion": "010",
    "serie": "F001",
    "correlativo": "250",
    "fechaEmision": "2024-04-07",
    "horaEmision": "00:00:00",
    "fechaVencimiento": "2024-04-07",
    "codigoTipoOperacion": "0101",
    "codigoTipoDocumento": "01",
    "moneda": "PEN",
    "montoCredito": 200,
    "formaPago": "Credito",
    "igv": 9.03,
    "icbper": 0.50,
    "cuotas": [
        {
            "numero": "001",
            "importe": 150,
            "fechaVencimiento": "2024-06-04"
        },
        {
            "numero": "002",
            "importe": 50,
            "fechaVencimiento": "2024-07-04"
        }
    ],
    "emisor": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20607599727",
        "razonSocial": "INSTITUTO INTERNACIONAL DE SOFTWARE S.A.C.",
        "nombreComercial": "ACADEMIA DE SOFTWARE",
        "ubigeo": "140101",
        "ciudad": "LAMBAYEQUE",
        "distrito": "CHICLAYO",
        "provincia": "CHICLAYO",
        "direccion": "CALLE OCHO DE OCTUBRE 123",
        "sucursal": "0000"
    },
    "cliente": {
        "codigoTipoDocumento": "6",
        "numDocumento": "20605145648",
        "razonSocial": "GROINVERSIONES Y SERVICIOS AJINOR S.R.L. - AGROS",
        "ubigeo": "",
        "ciudad": "",
        "distrito": "",
        "provincia": "",
        "direccion": ""
    },
    "totales": {
        "totalOpExoneradas": 140,
        "totalOpInafectas": 270,
        "totalOpGravadas": 50.17,
        "totalImpuestos": 9.53,
        "totalSinImpuestos": 460.17,
        "totalConImpuestos": 469.70,
        "totalPagar": 459.70,
        "totalDescuentoGlobal": 0,
        "totalDescuentoProductos": 10
    },
    "productos": [
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "MOCHILA",
            "moneda": "PEN",
            "precioUnitario": 50,
            "precioLista": 49,
            "montoSinImpuesto": 50,
            "montoImpuestos": 9,
            "montoTotal": 50,
            "montoIcbper": 0,
            "factorIcbper": 0.50,
            "montoDescuento": 10,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 9,
                    "idCategoria": "S",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "10",
                    "codigoTributo": "1000",
                    "nombreTributo": "IGV",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "dasdada",
            "codigoClasificacion": "10191509"
        },
        {
            "unidades": 2,
            "codigoUnidad": "NIU",
            "nombre": "LIBRO",
            "moneda": "PEN",
            "precioUnitario": 70,
            "precioLista": 70,
            "montoSinImpuesto": 140,
            "montoImpuestos": 0,
            "montoTotal": 140,
            "montoIcbper": 0,
            "factorIcbper": 0.50,
            "montoDescuento": 0,
            "codigoTipoPrecio": "01",
            "impuestos": [
                {
                    "monto": 0,
                    "idCategoria": "E",
                    "porcentaje": 18,
                    "codigoAfectacionIgv": "20",
                    "codigoTributo": "9997",
                    "nombreTributo": "EXO",
                    "codigoInterTributo": "VAT"
                }
            ],
            "id": "efsefer",
            "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": "efsefer",
            "codigoClasificacion": "10191509"
        },
        {
            "unidades": 1,
            "codigoUnidad": "NIU",
            "nombre": "bolsa plastica",
            "moneda": "PEN",
            "precioUnitario": 0.17,
            "precioLista": 0.70,
            "montoSinImpuesto": 0.17,
            "montoImpuestos": 0.03,
            "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": "fergerg",
            "codigoClasificacion": "10191509"
        }
    ]
}

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