> 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/factura-detraccion.md).

# Factura Detracción

Para el envío de emisiones de Facturas con detracción debes incluir los siguientes valores en el request:

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

### Request body

<table><thead><tr><th width="223">Nombre</th><th width="138">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>tipoOperacion<mark style="color:red;">*</mark></td><td>string</td><td>Identificador del tipo de operación que identifica al comprobante, por defecto es "010"</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>fechaVencimiento<mark style="color:red;">*</mark> </td><td>string</td><td>Fecha de vencimiento del comprobante, puede ser la misma que la fecha de emisión, debe estar en formato YYYY-MM-DD</td></tr><tr><td>codigoTipoOperacion<mark style="color:red;">*</mark> </td><td>string</td><td>Código del tipo de operación, para Facturas con detracción se envía el valor "1001"</td></tr><tr><td>codigoTipoDocumento<mark style="color:red;">*</mark> </td><td>string</td><td>Código del tipo de documento a emitir, para Facturas es "01"</td></tr><tr><td>moneda<mark style="color:red;">*</mark> </td><td>string</td><td>Código de la moneda</td></tr><tr><td>montoCredito<mark style="color:red;">*</mark> </td><td>decimal</td><td>Monto del crédito del documento en caso sea una Factura al crédito, de ser al contado el monto debe ser 0</td></tr><tr><td>formaPago<mark style="color:red;">*</mark> </td><td>string</td><td>Forma de pago del documento "Contado" o "Crédito"</td></tr><tr><td>igv<mark style="color:red;">*</mark> </td><td>decimal</td><td>Monto total del IGV</td></tr><tr><td>icbper<mark style="color:red;">*</mark> </td><td>decimal</td><td>Monto total del impuesto a las bolsas de plástico</td></tr><tr><td>cuotas</td><td>object</td><td>Listado de las <a href="#objeto-cuotas">cuotas</a> de la Factura al crédito</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>detraccion<mark style="color:red;">*</mark> </td><td>object</td><td>Datos de la <a href="#objeto-detraccion">detracción</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 `cuotas`

<table><thead><tr><th width="230">Nombre</th><th width="138">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>numero<mark style="color:red;">*</mark></td><td>string</td><td>Número de la cuota en formato "000"</td></tr><tr><td>importe<mark style="color:red;">*</mark></td><td>decimal</td><td>Valor del importe de la cuota</td></tr><tr><td>fechaVencimiento<mark style="color:red;">*</mark></td><td>string</td><td>Fecha de vencimiento de la cuota en formato YYYY-MM-DD</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>ubigeo<mark style="color:red;">*</mark></td><td>string</td><td>Ubigeo perteneciente a la dirección del emisor</td></tr><tr><td>ciudad</td><td>string</td><td>Ciudad perteneciente a la dirección del emisor</td></tr><tr><td>distrito</td><td>string</td><td>Distrito perteneciente a la dirección del emisor</td></tr><tr><td>provincia</td><td>string</td><td>Provincia perteneciente a la dirección del emisor</td></tr><tr><td>direccion</td><td>string</td><td>Dirección específica del emisor</td></tr><tr><td>sucursal</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><tr><td>ubigeo</td><td>string</td><td>Ubigeo perteneciente a la dirección del cliente</td></tr><tr><td>ciudad</td><td>string</td><td>Ciudad perteneciente a la dirección del cliente</td></tr><tr><td>distrito</td><td>string</td><td>Distrito perteneciente a la dirección del cliente</td></tr><tr><td>provincia</td><td>string</td><td>Provincia perteneciente a la dirección del cliente</td></tr><tr><td>direccion</td><td>string</td><td>Dirección específica del cliente</td></tr></tbody></table>

#### Objeto detraccion

<table><thead><tr><th width="246">Nombre</th><th width="141">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>codigoMedioPago<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de <a href="/pages/UgciTjHoBWbwCbi3G2ZJ#tipo-de-medio-de-pago">medio de pago</a> utilizado en la detracción</td></tr><tr><td>cuentaBancaria<mark style="color:red;">*</mark></td><td>string</td><td>Número de cuenta del Banco de la Nación utilizada en la detracción</td></tr><tr><td>codigoBienServicio<mark style="color:red;">*</mark></td><td>string</td><td>Código del tipo de <a href="/pages/UgciTjHoBWbwCbi3G2ZJ#tipo-de-bien-o-servicio">bien o servicio</a></td></tr><tr><td>porcentaje<mark style="color:red;">*</mark></td><td>decimal</td><td>Porcentaje del total de la factura utilizado para la detracción</td></tr><tr><td>monto<mark style="color:red;">*</mark></td><td>decimal</td><td>Cantidad del monto total de la factura utilizado para la detracción</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>totalSinImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones antes de impuestos</td></tr><tr><td>totalConImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones incluidos impuestos</td></tr><tr><td>totalPagar<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total a pagar</td></tr><tr><td>totalDescuentoGlobal<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total del descuento global aplicado</td></tr><tr><td>totalDescuentoProductos<mark style="color:red;">*</mark></td><td>decimal</td><td>Suma total de los descuentos aplicados a los productos</td></tr></tbody></table>

<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>totalSinImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones antes de impuestos</td></tr><tr><td>totalConImpuestos<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total de las operaciones incluidos impuestos</td></tr><tr><td>totalPagar<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total a pagar</td></tr><tr><td>totalDescuentoGlobal<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto total del descuento global aplicado</td></tr><tr><td>totalDescuentoProductos<mark style="color:red;">*</mark></td><td>decimal</td><td>Suma total de los descuentos aplicados a los productos</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>montoDescuento<mark style="color:red;">*</mark></td><td>decimal</td><td>Monto del descuento aplicado al producto</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>codigoClasifiacion<mark style="color:red;">*</mark></td><td>string</td><td>Código de la clasificación 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

#### Factura con detracción

```json
{
  "tipoOperacion": "010",
  "serie": "F014",
  "correlativo": "521",
  "fechaEmision": "2024-12-13",
  "horaEmision": "00:00:00",
  "fechaVencimiento": "2024-12-13",
  "codigoTipoOperacion": "1001",
  "codigoTipoDocumento": "01",
  "moneda": "PEN",
  "montoCredito": 0,
  "formaPago": "Contado",
  "igv": 9.03,
  "icbper": 0,
  "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": "AGROINVERSIONES Y SERVICIOS AJINOR S.R.L. - AGROS",
    "ubigeo": "",
    "ciudad": "",
    "distrito": "",
    "provincia": "",
    "direccion": ""
  },
  "detraccion": {
    "codigoMedioPago": "001",
    "cuentaBancaria": "0004-3342343243",
    "codigoBienServicio": "014",
    "porcentaje": 10,
    "monto": 5.9
  },
  "totales": {
    "totalOpExoneradas": 0,
    "totalOpInafectas": 0,
    "totalOpGravadas": 50,
    "totalImpuestos": 9,
    "totalSinImpuestos": 50,
    "totalConImpuestos": 59,
    "totalPagar": 59,
    "totalDescuentoGlobal": 0,
    "totalDescuentoProductos": 0
  },
  "productos": [
    {
      "unidades": 1,
      "codigoUnidad": "NIU",
      "nombre": "MOCHILA",
      "moneda": "PEN",
      "precioUnitario": 50,
      "precioLista": 59,
      "montoSinImpuesto": 50,
      "montoImpuestos": 9,
      "montoTotal": 50,
      "montoIcbper": 0,
      "factorIcbper": 0.50,
      "montoDescuento": 0,
      "codigoTipoPrecio": "01",
      "impuestos": [
        {
          "monto": 9,
          "idCategoria": "S",
          "porcentaje": 18,
          "codigoAfectacionIgv": "10",
          "codigoTributo": "1000",
          "nombreTributo": "IGV",
          "codigoInterTributo": "VAT"
        }
      ],
      "id": "p-001",
      "codigoClasificacion": "10191509"
    }
  ]
}
```

{% 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 %}