# 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]: