# Inicio

{% hint style="warning" %}
**DISCLAIMER:** [**APISUNAT.com**](https://apisunat.com/) es un servicio privado. **No es operado por SUNAT**.
{% endhint %}

[**APISUNAT**](https://apisunat.com/) es un **servicio de facturación electrónica en la nube** que genera, firma, envía y almacena tus comprobantes y sus respectivas CDR. Dejándote como única tarea enviarnos el contenido en formato **JSON** a través de nuestra **API REST**.

{% hint style="success" %}
**Ya no necesitas saber programar.** Ahora también puedes enviar tus comprobantes manualmente desde nuestro [portal web](https://apisunat.com/) sin usar la **API REST**.
{% endhint %}

1. [**Tipos de Documentos**](#tipos-de-documentos)
2. [**Definiciones**](#definiciones)
3. [**Flujo en Producción y Desarrollo**](#flujo-en-produccion-y-desarrollo)

### 1. Tipos de Documentos <a href="#tipos-de-documentos" id="tipos-de-documentos"></a>

Actualmente puedes enviar los siguientes documentos:

| Código | Nombre del Documento             |
| -----: | -------------------------------- |
|     01 | Factura                          |
|     03 | Boleta de Venta                  |
|     04 | Liquidación de Compra            |
|     07 | Nota de Crédito                  |
|     08 | Nota de Débito                   |
|     09 | Guía de Remisión - Remitente     |
|     31 | Guía de Remisión - Transportista |
|     RA | Comunicación de Baja             |
|     RR | Reversión                        |

{% hint style="info" %}
[**SUNAT**](https://cpe.sunat.gob.pe/sistema_emision/see_contribuyente#item-5) permite el envío de otros documentos como **Comprobantes de percepción, retención, etc**. Los cuales agregaremos próximamente.
{% endhint %}

### 2. Definiciones <a href="#definiciones" id="definiciones"></a>

* **CPE:** Comprobante de Pago Electrónico
* **GRE**: Guía de Remisión Electrónica
* **XML**: Archivo firmado que contiene la información del CPE
* **CDR**: "Constancia De Recepción" que emite la SUNAT al recibir un CPE
* **PDF**: Representación gráfica del XML
* **CDT**: Certificado Digital Tributario. Archivo necesario para firmar el XML
* **OSE:** "Operador de Servicios Electrónicos". Son empresas autorizadas para validar los comprobantes. Reemplazando la función de la SUNAT.
* **PSE**: "Proveedor de Servicios Electrónicos". Son empresas autorizadas para firmar (con su propio CDT) los CPE de otras empresas.
* **SEE - Del Contribuyente**: "Sistema de Emisión Electrónica" (como [APISUNAT.com](https://apisunat.com)) mediante el cual cualquier contribuyente puede enviar sus CPE directamente a la SUNAT
* **Usuario Secundario**: Debe ser creado en la web de la SUNAT y asignarle los permisos respectivos
* **DESARROLLO:** Es el ***"modo de pruebas"***. Tus comprobantes no se envían a SUNAT.
* **PRODUCCIÓN:** Es **"la vida real"**. Tus comprobantes se informan a SUNAT y tienen valor legal.

### 3. Flujo en Desarrollo y Producción <a href="#flujo-en-produccion-y-desarrollo" id="flujo-en-produccion-y-desarrollo"></a>

|                                            | Desarrollo | Producción |
| -----------------------------------------: | :--------: | :--------: |
| Emisión (se crea, firma y almacena el XML) |     ✔️     |     ✔️     |
|                Validación del XML **(\*)** |     ✔️     |     ✔️     |
|                     Información a la SUNAT |      ❌     |     ✔️     |
|         Recepción y almacenamiento del CDR |     ✔️     |     ✔️     |

{% hint style="warning" %}
**(\*)** La validación en ambos casos es hecha por SUNAT. Esta puede tener diferencias en desarrollo y producción. En el caso de desarrollo, por ejemplo, no se valida la firma.
{% endhint %}

* **Emisión:** Es el proceso de generar el archivo XML. Si está correctamente estructurado, el documento quedará en estado **`PENDIENTE`** hasta recibir la respuesta de la SUNAT.
* **Validación:** Unos instantes después SUNAT valida el XML. En este paso nos devuelve uno de tres estados posibles:
  * **`EXCEPCION`** cuando se rechaza el documento y no tiene ningún valor. Como si nunca lo hubieras enviado.
  * **`RECHAZADO`** cuando se rechaza pero la numeración queda usada. Ya no puedes usar la misma **serie-número**.
  * **`ACEPTADO`** cuando es aceptado. En este caso puede haber alguna observación pero igual es válido.
* **Información:** Si el documento es **RECHAZADO** o **ACEPTADO**, este se considera informado. SUNAT retornará un CDR (Constancia De Recepción) que debes almacenar junto al XML por lo que indique la norma.

{% hint style="info" %}
No te preocupes que nosotros almacenamos los archivos XML y CDR por ti. Podrás verlos y descargarlos en cualquier momento desde nuestro [**Portal Web**](https://apisunat.com/).
{% endhint %}

{% hint style="warning" %}
Si ves un documento en estado **PENDIENTE** por más tiempo de lo normal, posiblemente sea por fallas en los servidores de SUNAT. Nosotros volvemos a enviar los documentos cada cierto tiempo hasta recibir una respuesta.
{% endhint %}

{% hint style="warning" %}
Si activas la opción de "**Informar mediante** **OSE**" el flujo es exactamente el mismo pero el OSE reemplaza a la SUNAT.
{% endhint %}