# Estructura para generar comprobantes

<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="417">VALOR</th><th width="135">REQUISITO</th><th width="128">LONGUITUD</th><th></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>01 = FACTURA ELECTRÓNICA</p><p>03 = BOLETA DE VENTA ELECTRÓNICA</p><p>07 = NOTA DE CRÉDITO</p><p>08 = NOTA DE DÉBITO</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 exacto</td><td></td></tr><tr><td><pre><code>serie
</code></pre></td><td>Debe ingresar "F" para FACTURAS y con "B" para BOLETAS DE VENTA. Para su generación debe tener en cuenta que el comprobante debe estar aceptado.</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>4 exacto</td><td></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><td></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><p>0200 = Exportación</p><p>1001 = Operación Sujeta a Detracción<br>1004 = Operación Sujeta a Detracción- Servicios de Transporte Carga<br>0401 = Ventas no domiciliados que no califican como exportación</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>4 exacto</td><td></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><td></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><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><td></td></tr><tr><td><pre><code>porcentaje_de_venta
</code></pre></td><td>Es el porcentaje a la venta<br>Perú / IGV : 18% y 10%<br><br>Ejemplo: 18</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 enteros</td><td></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><td></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><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>DATOS DEL EMISOR</strong></td><td></td><td></td><td></td><td></td></tr><tr><td><pre><code>codigo_establecimiento
</code></pre></td><td>Cada establecimiento cuenta con un código de anexo, por ejemplo la oficina principal es 0000</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>4 exacto</td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>DATOS DEL CLIENTE</strong></td><td></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><td></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><td></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><td></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><td></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><td></td></tr><tr><td><pre><code><strong>cliente_direccion
</strong></code></pre></td><td>Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 100</td><td></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><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><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>TOTALES</strong></td><td></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><td></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><td></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><td></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><td></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><td></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><td></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><td></td></tr><tr><td><pre class="language-json"><code class="lang-json">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><td><br></td></tr><tr><td><pre><code>total_retencion
</code></pre></td><td>0.0</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td><td></td></tr><tr><td><pre class="language-json"><code class="lang-json">código_retencion
</code></pre></td><td>"01" = tasa 3%<br>"02" = tasa 6%</td><td><mark style="background-color:orange;">Condicional</mark></td><td>2 exacto</td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>ITEMS</strong></td><td></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><td></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><td></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><td></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><td></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><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><td></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><td></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><td></td></tr><tr><td><pre><code>tipo_tax
</code></pre></td><td><p>10 = Gravado - Operación Onerosa</p><p>20= Exonerado - Operación Onerosa</p><p>21= Exonerado - Transferencia Gratuita</p><p>30= Inafecto - Operación Onerosa</p><p>40= Exportación</p></td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 exacto</td><td></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><td></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><td></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><td></td></tr><tr><td></td><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><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>CONDICIÓN DE PAGO</strong></td><td></td><td></td><td></td><td></td></tr><tr><td><pre><code>descripcion
</code></pre></td><td>Deberás indicas si es Contado o Crédito</td><td><mark style="background-color:orange;">Condicional</mark></td><td>7 exacto</td><td></td></tr><tr><td><pre><code>tipo
</code></pre></td><td>0= Contado y 1 = Crédito</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 exacto</td><td></td></tr><tr><td><pre><code>cuota
</code></pre></td><td><p><mark style="background-color:red;">Solo aplica si es a crédito</mark></p><p>La estructura del nombre de la cuota es: Cuota001 , si tienes mas de una cuota Cuota002 , Cuota003 ...</p></td><td><mark style="background-color:orange;">Condicional</mark></td><td>8 exacto</td><td></td></tr><tr><td><pre><code>fecha_de_pago
</code></pre></td><td><mark style="background-color:red;">Solo aplica si es a crédito</mark><br>tendrán un formato: 2024-01-03</td><td><mark style="background-color:orange;">Condicional</mark></td><td>10 exacto</td><td></td></tr><tr><td><pre><code>importe
</code></pre></td><td><mark style="background-color:red;">Solo aplica si es a crédito</mark><br>debe ir el monto de la cuota, ejemplo 50.00</td><td><mark style="background-color:orange;">Condicional</mark></td><td>1 hasta 12 enteros con 2 decimales</td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td><pre><code>forma_de_pago
</code></pre></td><td>Texto de 0 hasta 1000 caracteres.</td><td><mark style="background-color:purple;">Opcional</mark></td><td></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><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><td></td></tr><tr><td><pre><code>observaciones
</code></pre></td><td>Texto de 0 hasta 1000 caracteres.</td><td><mark style="background-color:purple;">Opcional</mark></td><td></td><td></td></tr></tbody></table>

**Body**

```json
{
  "tipo_documento": "01",
  "serie": "F001",
  "numero": "#",
  "tipo_operacion": "0101",
  "fecha_de_emision": "2024-06-25",
  "hora_de_emision": "",
  "moneda": "PEN",
  "porcentaje_de_venta": 18.00,
  "fecha_de_vencimiento": "",
  "enviar_automaticamente_al_cliente": true,
  "datos_del_emisor": {
    "codigo_establecimiento": "0000"
  },
  "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_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"
  },
  "termino_de_pago": {
    "descripcion": "Contado",
    "tipo": "0"
  },
  "metodo_de_pago": "",
  "canal_de_venta": "",
  "orden_de_compra": "",
  "almacen": "",
  "observaciones": ""
}
```

**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=",
        "qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+="
    },
    "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",
        "cdr": "https://factpro.pe/downloads/document/cdr/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/estructura-para-generar-comprobantes.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.