# Recibos de Servicios Públicos

<mark style="background-color:orange;">**POST**</mark>`https://dev.factpro.la/api/v2/documentos`

**Headers**

<table data-full-width="true"><thead><tr><th width="215">Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr><tr><td>Authorization</td><td><code>Bearer &#x3C;token></code></td></tr></tbody></table>

**Body**

<table data-full-width="true"><thead><tr><th width="370">ATRIBUTO</th><th width="413">VALOR</th><th width="128">REQUISITO</th><th>LONGUITUD</th></tr></thead><tbody><tr><td><pre class="language-json"><code class="lang-json">tipo_documento
</code></pre></td><td><p>Tipo de COMPROBANTE :</p><p>14 = Recibo servicios públicos</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 exacto</td></tr><tr><td><pre><code>tipo_servicio_publico
</code></pre></td><td>4 = internet <br>Si existe el tag, su valor no corresponde a los establecidos en el catálogo N° 56</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 exacto</td></tr><tr><td><pre><code>serie
</code></pre></td><td>Debe ingresar "S" para Recibos de Servicios Públicos </td><td><mark style="background-color:green;">Obligatorio</mark></td><td>4 exacto</td></tr><tr><td><pre><code>numero
</code></pre></td><td>Número correlativo del documento</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 8</td></tr><tr><td><pre><code>tipo_operacion
</code></pre></td><td><p>En todos los casos se utiliza por defecto: 0101</p><p>0101 = VENTA INTERNA</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>4 exacto</td></tr><tr><td><pre><code>fecha_de_emision
</code></pre></td><td>Debe ser la fecha actual. Ejemplo: 2024-05-14</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>10 exacto</td></tr><tr><td><pre><code>inicio_ciclo_de_facturacion
</code></pre></td><td>Ejemplo: 2024-05-14</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>10 exacto</td></tr><tr><td><pre><code>fin_ciclo_de_facturacion
</code></pre></td><td>Ejemplo: 2024-05-14</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>10 exacto</td></tr><tr><td><pre><code>fecha_de_vencimiento
</code></pre></td><td>Ejemplo: 2024-05-14</td><td><mark style="background-color:purple;">Opcional</mark></td><td>10 exacto</td></tr><tr><td><pre><code>hora_de_emision
</code></pre></td><td>Debe ser la hora actual 10:11:11</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td><pre><code>moneda
</code></pre></td><td><p>PEN = SOLES</p><p>USD= DÓLARES</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>3 exacto</td></tr><tr><td><pre><code>porcentaje_de_venta
</code></pre></td><td>Es el porcentaje a la venta<br>Perú / IGV : 18%<br><br>Ejemplo: 18</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 enteros</td></tr><tr><td><pre><code>enviar_automaticamente_al_cliente
</code></pre></td><td>Dirección de email<br><strong>false</strong> = No se enviara<br><strong>true</strong> = Se enviará automáticamente<br></td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td><strong>DATOS DEL CLIENTE</strong></td><td></td><td></td><td></td></tr><tr><td><pre><code>cliente_tipo_documento
</code></pre></td><td><p>6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE</p><p>1 = DNI - DOC. NACIONAL DE IDENTIDAD</p><p>4 = CARNET DE EXTRANJERÍA</p><p>7 = PASAPORTE</p><p>A = CÉDULA DIPLOMÁTICA DE IDENTIDAD</p><p>0 = NO DOMICILIADO, SIN RUC</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 exacto</td></tr><tr><td><pre><code>cliente_numero_documento
</code></pre></td><td>Ejemplo: RUC del CLIENTE, número de DNI, Etc.</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 15</td></tr><tr><td><pre><code>cliente_denomiacion
</code></pre></td><td>Razón o nombre completo del CLIENTE.</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 100</td></tr><tr><td><pre><code>codigo_pais
</code></pre></td><td>Colocar el país del CLIENTE, por ejemplo Perú = PE</td><td><mark style="background-color:purple;">Opcional</mark></td><td>2 exacto</td></tr><tr><td><pre><code>ubigeo
</code></pre></td><td>Debe ingresar número por código de Ubigeo , por ejemplo 150101</td><td><mark style="background-color:purple;">Opcional</mark></td><td>2 exacto</td></tr><tr><td><pre><code><strong>cliente_direccion
</strong></code></pre></td><td>Dirección completa  </td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 100</td></tr><tr><td><pre><code>cliente_email
</code></pre></td><td>Correo referencial</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td><pre><code>cliente_telefono
</code></pre></td><td>Teléfono referencial</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td></td><td></td><td></td><td></td></tr><tr><td><strong>TOTALES</strong></td><td></td><td></td><td></td></tr><tr><td><pre><code>total_exportacion
</code></pre></td><td><a data-footnote-ref href="#user-content-fn-1">0.00</a></td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_gravadas
</code></pre></td><td> <a data-footnote-ref href="#user-content-fn-1">0.00</a></td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_inafectas
</code></pre></td><td> 0.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_exoneradas
</code></pre></td><td> 0.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_gratuitas
</code></pre></td><td> 0.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code><strong>tota_otros_cargos
</strong></code></pre></td><td>0.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code><strong>total_tax
</strong></code></pre></td><td>18</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_venta
</code></pre></td><td> 118.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td></td><td></td><td></td><td></td></tr><tr><td><strong>ITEMS</strong></td><td></td><td></td><td></td></tr><tr><td><pre><code>unidad
</code></pre></td><td><p>Enviar las unidades de medida, por ejemplo para Unidad es = NIU<br></p><p>NIU = PRODUCTO</p><p>ZZ = SERVICIO</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 hasta 5</td></tr><tr><td><pre><code>codigo
</code></pre></td><td>Opcional, código interno del producto por ejemplo P0121</td><td><mark style="background-color:purple;">Opcional</mark></td><td>1 hasta 250</td></tr><tr><td><pre><code>descripcion
</code></pre></td><td>Nombre del producto</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 250</td></tr><tr><td><pre><code>codigo_producto_sunat
</code></pre></td><td></td><td><mark style="background-color:purple;">Opcional</mark></td><td>Hasta 8</td></tr><tr><td><pre><code>codigo_producto_gsl
</code></pre></td><td></td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td><pre><code>cantidad
</code></pre></td><td>Ejemplo: 10.00</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 12 enteros, hasta con 10 decimales</td></tr><tr><td><pre><code>valor_unitario
</code></pre></td><td>Sin IGV. Ejemplo: 50</td><td></td><td>1 hasta 12 enteros, hasta con 10 decimales</td></tr><tr><td><pre><code>precio_unitario
</code></pre></td><td>Con IGV. Ejemplo: 59</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 12 enteros, hasta con 10 decimales</td></tr><tr><td><pre><code>tipo_tax
</code></pre></td><td><p>10 = Gravado - Operación Onerosa</p><p>11 = Gravado – Retiro por premio</p><p>12 = Gravado – Retiro por donación</p><p>13 = Gravado – Retiro</p><p>14 = Gravado – Retiro por publicidad</p><p>15 = Gravado – Bonificaciones</p><p>16 = Gravado – Retiro por entrega a trabajadores</p><p>20= Exonerado - Operación Onerosa</p><p>21= Exonerado - Transferencia Gratuita</p><p>30= Inafecto - Operación Onerosa</p><p>31= Inafecto – Retiro por Bonificación</p><p>32= Inafecto – Retiro</p><p>33= Inafecto – Retiro por Muestras Médicas</p><p>34= Inafecto - Retiro por Convenio Colectivo</p><p>35= Inafecto – Retiro por premio</p><p>36= Inafecto - Retiro por publicidad</p><p>40= Exportación</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 exacto</td></tr><tr><td><pre><code>total_base_tax
</code></pre></td><td>100</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total_tax
</code></pre></td><td>18</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td><pre><code>total
</code></pre></td><td>118</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>1 hasta 12 enteros con 2 decimales</td></tr><tr><td></td><td></td><td></td><td></td></tr><tr><td><pre><code>formato_pdf
</code></pre></td><td>Puedes elegir entre  a4 o ticket para mostrar automáticamente el formato del PDF</td><td><mark style="background-color:green;">Obligatorio</mark></td><td></td></tr><tr><td><pre><code>numero_orden
</code></pre></td><td>Texto de 0 hasta 1000 caracteres.</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr><tr><td><pre><code>codigo
</code></pre></td><td>Texto de 0 hasta 1000 caracteres.</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td></tr></tbody></table>

**Body**

```json
{
    "tipo_documento": "14",
    "tipo_servicio_publico": "1",
    "serie": "SP01",
    "numero": "#",
    "tipo_operacion": "0101",
    "fecha_de_emision": "2024-06-25",
    "inicio_ciclo_de_facturacion": "2024-06-25",
    "fin_ciclo_de_facturacion": "2024-06-25",
    "fecha_de_vencimiento": "",
    "hora_de_emision": "",
    "moneda": "PEN",
    "forma_de_pago": "",
    "numero_orden":"",
    "codigo":"",
    "porcentaje_de_venta": 18.00,
    "enviar_automaticamente_al_cliente": true,
    "cliente": {
        "cliente_tipo_documento": "6",
        "cliente_numero_documento": "20605577246",
        "cliente_denominacion": "CORPORACION VEL PERU S.A.C.",
        "codigo_pais": "",
        "ubigeo": "",
        "cliente_direccion": "Av.",
        "cliente_email": "",
        "cliente_telefono": ""
    },
    "totales": {
        "total_exportacion": 0.00,
        "total_gravadas": 100.00,
        "total_inafectas": 0.00,
        "total_exoneradas": 0.00,
        "total_gratuitas": 0.00,
        "total_otros_cargos": 0.00,
        "total_tax": 18.00,
        "total_venta": 118
    },
    "items": [
        {
            "unidad": "NIU",
            "codigo": "",
            "descripcion": "MacbookPro",
            "codigo_producto_sunat": "",
            "codigo_producto_gsl": "",
            "cantidad": 1,
            "valor_unitario": 100,
            "precio_unitario": 118,
            "tipo_tax": "10",
            "total_base_tax": 100.00,
            "total_tax": 18,
            "total": 118
        }
    ],
    "acciones": {
        "formato_pdf": "a4"
    }
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "success": true,
    "data": {
        "number": "F001-5",
        "filename": "20415963255-01-F001-5",
        "external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
        "number_to_letter": "Ciento dieciocho  con 00/100 ",
        "hash": "gLOlpznxBvvhT/BUUugMYDhQo84="
    "links": {
        "xml": "https://factpro.pe/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
        "pdf": "https://factpro.pe/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
    },
    "response": {
        "code": "0",
        "description": "La Factura numero F001-5, ha sido aceptada",
        "notes": []
    }
}
```

{% endtab %}
{% endtabs %}

[^1]:


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.factpro.la/api-facturacion-v2-pronto-dejara-de-funciona/recibos-de-servicios-publicos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.