> For the complete documentation index, see [llms.txt](https://docs.factpro.la/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.factpro.la/api-facturacion-v3/estructura-para-generar-facturas.md).

# Estructura para generar facturas

<mark style="background-color:orange;">**POST**</mark>`https://api.factpro.la/api/v3/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><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>fecha_de_emision
</code></pre></td><td>Opcional<br>Debe ser la fecha actual. Ejemplo: 2024-05-14</td><td><mark style="background-color:purple;">Opcional</mark></td><td>10 exacto</td><td></td></tr><tr><td><p></p><pre><code><a data-footnote-ref href="#user-content-fn-1">moneda</a>
</code></pre></td><td><p>Opcional , por defecto siempre sera en MONEDA "PEN"<br>PEN = SOLES</p><p>USD= DÓLARES</p></td><td><mark style="background-color:purple;">Opcional</mark></td><td>3 exacto</td><td></td></tr><tr><td><pre><code>tipo_operacion
</code></pre></td><td><p>En todos los casos se utiliza por defecto: 1<br></p><p>1= Venta interna</p><p>2= Exportación</p><p>3= Operación Sujeta a Detracción<br>4= Operación Sujeta a Detracción- Servicios de Transporte Carga<br>5= 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>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 CLIENTE</strong></td><td></td><td></td><td></td><td></td></tr><tr><td><pre><code>cliente_tipo_documento
</code></pre></td><td>1=Otros<br>2=DNI<br>3=CE<br>4=RUC<br>5=Pasaporte</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>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>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>precio
</code></pre></td><td>Ejemplo: 100</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>incluye_tax
</code></pre></td><td>Si el precio que utilizas en tu app no incluye impuesto debes de colocar: false<br><br>Si el precio que envias ya incluye el impuesto, puedes enviarnos como : true o no es necesario enviar esta variable</td><td><mark style="background-color:purple;">Opcional</mark></td><td>4 hasta 5</td><td></td></tr><tr><td><pre><code>tipo_tax
</code></pre></td><td>1=Gravado - Operación Onerosa<br>20=Exonerado - Operación Onerosa<br>21=Exonerado – Transferencia Gratuita<br>30=Inafecto - Operación Onerosa<br>40=Exportación de bienes o servicios</td><td><mark style="background-color:green;">Obligatorio</mark></td><td>2 exacto</td><td></td></tr><tr><td><p></p><pre class="language-postman_json"><code class="lang-postman_json">descuento
</code></pre></td><td>Ejemplo: 5</td><td><mark style="background-color:purple;">Opcional</mark></td><td>1 hasta 12 enteros, hasta con 10 decimales</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>tipo_de_condicion
</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>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>monto
</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><strong>OTROS CAMPOS</strong></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><pre><code>numero_orden
</code></pre></td><td>Texto de 0 hasta 20 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
{
  "serie": "F100",
  "numero": "#",  
  "tipo_operacion": "1",
  "cliente": {
    "cliente_tipo_documento": "4",
    "cliente_numero_documento": "20605577241",
    "cliente_denominacion": "CORPORACION VEL PERU S.A.C.",
    "cliente_direccion": "Av.",
    "cliente_email": "laverioa@gmail.com",
    "cliente_telefono": ""
  },
  "items": [
    {
      "unidad": "NIU",
      "codigo": "",
      "descripcion": "PC 3434",
      "cantidad": 1,
      "precio": 100,
      "tipo_tax": "1",
      "descuento": 0.00
    }
  ],
  "condicion_de_pago": [
        {
        "tipo_de_condicion": "0",
        "forma_de_pago":"0",
        "monto": 0
        }
    ],
    "observaciones": "",
    "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=",
        "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]: