# Documentación

Esta página contiene la documentación oficial de SimpleFact® y recursos relacionados, si necesitas ayuda adicional puedes contactarnos.

### ¿Qué es SimpleFact?

SimpleFact® es una solución de software que permite generar comprobantes electrónicos y gestionar tu negocio de forma simple y eficiente. Puede usarse desde la plataforma web o mediante API.

### ¿Cuáles son las características?

* Gestiona las ventas de tu negocio
* Emite Facturas Electrónicas
* Emite Boletas Electrónicas
* Emite Notas de crédito y Notas de Débito
* Emite Guías de Remisión Electrónicas
* Gestiona tus clientes y proveedores
* Gestiona tu inventario de productos
* Gestiona las compras de tu negocio
* Maneja múltiples roles de usuario

### ¿Cuál es costo?

SimpleFact®  ofrece 3 planes según las necesidades de tu negocio, puedes empezar por el mira más detalles de los precios en [www.simplefact.pe](https://simplefact.pe/)


# Crea una cuenta

Paso a paso para registrarte en SimpleFact.pe de forma rápida con tu número de ruc y correo electrónico.

{% hint style="info" %}
Para poder registrarte necesitas un número de RUC de Empresa o de Persona Natural con Negocio.
{% endhint %}

1. Ingresa a [www.simplefact.pe](https://simplefact.pe/)
2. Luego pulsa en el botón **Regístrate** y a continuación abrirá el formulario de registro debes ingresar tu número de ruc, razón social, tu celular, email y crear una contraseña que servirá para inicio de sesión.
3. Elige el plan adecuado y configura tu cuenta.


# Alta de Facturación Electrónica

Para emitir facturas electrónicas en producción es necesario realizar una primera configuración. Para temas de desarrollo y pruebas puedes usar la configuración por defecto proporcionada en tu cuenta.

## Requisitos

Estos son los requisitos fundamentales para el servicio de facturación electrónica.

* RUC de persona natural con negocio (RUC 10) ó RUC de persona Jurídica (RUC 20)
* Condición del RUC Habido y Activo
* Certificado Digital, puede ser obtenido gratuitamente de SUNAT o adquirido en un proveedor autorizado.

## Certificado digital

{% hint style="info" %}
Si necesita ayuda para la configuración puede contactarnos.
{% endhint %}

* Crear un usuario de Facturación en el portal SUNAT
* Subir el certificado emitido en la SUNAT ó en el proveedor OSE
* Subir el certificado en SimpleFact®&#x20;


# Crear Usuario secundario y certificado digital

Para utilizar la funcionalidad de Facturación Electrónica de SimpleShop / SimpleFact, será necesario:

1. Crear un Usuario Secundario en SUNAT
2. Descargar el Certificado Digital Tributario (CDT)
3. Verificar certificado y registrar email de facturación
4. Subir el CDT a SimpleShop / SimpleFact

### 1. Creación del Usuario Secundario

1. Ingresar a <https://e-menu.sunat.gob.pe/cl-ti-itmenu/MenuInternet.htm> e Iniciar Sesión.
2. Guiarse con la siguiente imagen para ingresar a la opción “Administración de usuarios secundarios” ![](/files/-MASSImvokiqf0O4FHsf)
3. Seleccionar “Crear Usuario”

![](/files/-MASSImwK3LC5r2bVSNb)

1. Generar el nuevo usuario, asegurando que la clave no supere los 12 caracteres.
2. Entrar a “Asignar Programas” y desplegar la opción TRIBUTARIOS, y después COMPROBANTES DE PAGO.
3. Activar las siguientes opciones: ![](/files/-MASSImxIFBCRvx9EABU)
4. Activar todas las opciones que se encuentren en las siguientes carpetas:

![](/files/-MASSImylZuBPVUpsWGN)

![](/files/-MCShgQBk2IPv3cMCJcW)

Todas las opciones en “SEE – Del Contribuyente y Envío de Documentos” y “Factura Electrónica”  y Comprobantes de contingencia, deberían quedar seleccionadas.

1. Hacer clic en “Siguiente” y finalmente, seleccionar la opción “GRABAR” para finalizar la creación del usuario secundario.
2. Tomar nota del usuario y clave del usuario secundario para luego ingresar esta información en SimpleShop / SimpleFact.

### 2. Descargar el Certificado Digital Tributario

1. Regresar al menú principal y guiarse con la siguiente imagen para ingresar a “Solicitar Certificado Digital Tributario”.![](/files/-MASSImzEJrMdyeaBRth)
2. Verificar la información, aceptar los términos y condiciones (una vez leídos) y hacer clic en Enviar Solicitud.

![](/files/-MASSIn-Z3eK3c_YrwTF)

1. Dar Aceptar\
   ![](/files/-MASSIn0WdCPg1-7qpti)
2. Visualizará el siguiente mensaje del sistema:

![](/files/-MASSIn1sdoSEeoAVsE6)

1. Ingresar al Buzón de Mensajes, abrir el último mensaje y hacer clic en el link a Reniec

![](/files/-MASSIn2bHK_8i5GiWQg)

1. Ingresar RUC y generar clave. Hacer clic en “Descargar Certificado”. Revisar que el Certificado se encuentre descargado en su PC. Normalmente, se encontrará en la carpeta “Descargas”.

![Al pulsar en descargar se descarga el certificado en formato p12 (certificado.p12)](/files/-MASSIn3qXxc5agNMkfS)

### 3. Verificar el certificado en SUNAT

Luego de haber descargado el certificado verificar que aparezca en la sección de certificados digitales.&#x20;

Marca el check de Deseo emitir a través del SEE - Del contribuyente, si no está marcado y también **registre un correo electrónico para facturación**.&#x20;

![](/files/-MCSiV2CFQ4WZZgx_jcY)

### 4. Subir el CDT a SimpleShop / SimpleFact

1. Ingresar a su panel de administración de SimpleFact:

<https://tumarca.simplefact.pe/login>

En la dirección, reemplazar “tumarca” con el nombre de la empresa o marca registrado al contratar SimpleShop / SimpleFact.

1. Ir a Configuración / Empresa\
   ![](/files/-MASSIn4vOgQRARUwifx)
2. Activar la siguiente opción:\
   ![](/files/-MASSIn5-wsXKRaOasBh)
3. Subir el CDT que se descargó anteriormente en la PC (**certficado.p12**) e ingresar la clave generada al descargar el CDT. Ingresar el Usuario SOL y la Clave SOL del usuario secundario creado. ![](/files/-MASSIn6Rzq9GmzjK-hU)
4. Ingresar el resto de la información de la empresa y “Guardar cambios”.<br>

> El tiempo de activación de SUNAT demora entre 4 y 24 Horas.


# Logo y ajustes de la factura

## Datos de la empresa

Es importante llenar la razón social, nombre comercial, teléfono y dirección de la empresa. Para ello ir a **Configuración** > **Empresa**.

![](/files/-MCSmUdGttzz78OBQ43a)

{% hint style="info" %}
&#x20;El ubigeo de la empresa se obtiene simplemente buscando el distrito en dicho campo.
{% endhint %}

No olvides subir el logotipo para la factura, de preferencia en formato horizontal. Formato de archivo .png o jpg. Ancho máximo 350 pixeles.

![](/files/-MCSmmfP67btABbjkSJt)

Después de editar los datos de tu empresa y la factura pulsamos en **guardar cambios**.


# Introducción

SimpleFact® y SimpleShop®  proporciona una API REST de Facturación Electrónica fácil de implementar en todos los lenguajes de programación.

{% hint style="info" %}
Para empezar a usar la API debes crear una cuenta en [www.simplefact.pe](https://simplefact.pe/) y obtener tu **TOKEN**.
{% endhint %}

### Endpoint

La URL Base de la API es el subdominio de tu empresa adicionado **`api/v1`** ejemplo:

```http
https://tunegocio.simplefact.pe/api/v1
```

### Autenticación

Para autenticar las solicitudes solo es necesario añadir una cabecera con Authorization a cada solicitud HTTP `Authorization Bearer Token` ejemplo de HTTP REQUEST:

```http
POST /api/v1 HTTP/1.1
Host: tunegocio.simplefact.pe
Authorization: Bearer b00131b17becc9906f5081793e79a5d74a7ab6cb007818be1e0628fdef7c8
```

Ejemplos según lenguaje de programación:

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://demo.simplefact.pe/api/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => array(
    "Accept: application/json",
    "Authorization: Bearer b00131b17becc9906f5081793e79a5d74a7ab6cb007818be1e0628fdef7c8fe2",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

{% endtab %}

{% tab title="JAVA" %}

```java
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
Request request = new Request.Builder()
  .url("https://demo.simplefact.pe/api/v1")
  .post(null)
  .addHeader("Accept", "application/json")
  .addHeader("Authorization", "Bearer b00131b17becc9906f5081793e79a5d74a7ab6cb007818be1e0628fdef7c8fe2")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();
```

{% endtab %}

{% tab title="Python" %}

```python

url = "https://demo.simplefact.pe/api/v1"

payload = ""
headers = {
    'Accept': "application/json",
    'Authorization': "Bearer b00131b17becc9906f5081793e79a5d74a7ab6cb007818be1e0628fdef7c8fe2",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
```

{% endtab %}

{% tab title="C#" %}

```csharp
var client = new RestClient("https://demo.simplefact.pe/api/v1");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer b00131b17becc9906f5081793e79a5d74a7ab6cb007818be1e0628fdef7c8fe2");
request.AddHeader("Accept", "application/json");
IRestResponse response = client.Execute(request);
```

{% endtab %}
{% endtabs %}


# Ventas

Gestiona las ventas de tu negocio, emite ventas con factura electrónica o boleta electrónica, accede a las ventas por rango de fecha, estado, etc. Soporta ventas del e-Commerce.

## Listar ventas

<mark style="color:blue;">`GET`</mark> `https://demo.simplefact.pe/v1/sales/orders`

Obtiene las ventas realizadas con el comprobante asociado, por rango de fecha.

#### Query Parameters

| Name      | Type   | Description                                                                                                                      |
| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| shortdate | string | Filtrar por rango de fecha predeterminado ejemplo: `today` : ventas de hoy`yesterday` : ventas de ayer, `month` `past_month ...` |
| to        | string | <p>Rango fecha de fin<br></p>                                                                                                    |
| pageSize  | number | Numero de resultados a mostrar, valor por defecto `10`.                                                                          |
| from      | string | <p>Rango fecha de inicio<br></p>                                                                                                 |

#### Headers

| Name           | Type   | Description                                                                                                                          |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Authentication | string | <p>Authentication token para acceder al recurso, el token es proporcionado por SimpleFact.<br>Ejemplo: <code>Bearer Token</code></p> |

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

```javascript
{
   "data":[
      {
         "id":409,
         "invoice_type_name":"Factura de Venta Electr\u00f3nica",
         "invoice_type":"01",
         "invoice_type_name_short":"F",
         "serie":"F001",
         "correlative":"141",
         "customer_name":"ACR TECHNOLGIES SAC",
         "status":"processing",
         "tax_total":"6101.69",
         "total":"40000.00",
         "date":"2020-05-06T23:27:59.000000Z",
         "date_formatted":"06\/05\/2020 18:27",
         "due_date":"-",
         "currency":"PEN",
         "currency_symbol":"S\/",
         "xml_url":"https:\/\/demo.simplefact.pe\/app\/download\/invoices\/20601643316-01-F001-141.xml",
         "pdf_url":"https:\/\/demo.simplefact.pe\/app\/download\/invoices\/20601643316-01-F001-141.pdf",
         "bill":{
            "id":276,
            "created_at":"2020-05-06 18:28:00",
            "accepted_at":"2020-05-06 18:28:00",
            "error":null,
            "message":"La Factura numero F001-141, ha sido aceptada",
            "order_id":409,
            "cdr_url":"https:\/\/demo.simplefact.pe\/app\/download\/invoices\/R-20601643316-01-F001-141.zip",
            "status":"accepted"
         },
         "void":null,
         "notes":null,
         "customer":{
            "id":2,
            "name":"ACR TECHNOLGIES SAC",
            "email":"acr@gmail.com",
            "phone":null,
            "status":"active",
            "is_company":false
         },
         "items": [],
         "origin":"api",
         "payment_method":"cash",
         "payment_status":"paid",
         "created_at_formatted":"06\/05\/2020 18:27"
      }
   ],
   "links":{
      "first":"https:\/\/demo.simplefact.pe\/api\/v1\/sales\/orders?page=1",
      "last":"https:\/\/demo.simplefact.pe\/api\/v1\/sales\/orders?page=237",
      "prev":null,
      "next":"https:\/\/demo.simplefact.pe\/api\/v1\/sales\/orders?page=2"
   },
   "meta":{
      "current_page":1,
      "from":1,
      "last_page":237,
      "path":"https:\/\/demo.simplefact.pe\/api\/v1\/sales\/orders",
      "per_page":"1",
      "to":1,
      "total":237
   }
}
```

{% endtab %}
{% endtabs %}

## Detalle de una venta

<mark style="color:blue;">`GET`</mark> `https://demo.simplefact.pe/v1/sales/orders/:id`

Muestra información de una venta y comprobante

#### Path Parameters

| Name | Type   | Description    |
| ---- | ------ | -------------- |
| id   | string | ID de la venta |

#### Headers

| Name          | Type   | Description  |
| ------------- | ------ | ------------ |
| Authorization | string | Bearer token |

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

```javascript
{
    "success": true,
    "data": {
        "id": 407,
        "invoice_type": "03",
        "invoice_type_name": "Boleta de Venta Electr\u00f3nica",
        "invoice_number": "B001-97",
        "serie": "B001",
        "correlative": "97",
        "customer": {
           
        },
        "customer_name": "Juan Perez",
        "customer_document_type": "1",
        "customer_document_number": "00000000",
        "customer_document": "DNI",
        "status": "processing",
        "tax_total": "98.24",
        "total": "644.00",
        "date": "2020-04-30T23:14:15.000000Z",
        "date_formatted": "30\/04\/2020 18:14 PM",
        "due_date": "30\/04\/2020",
        "currency": "PEN",
        "currency_symbol": "S\/",
        "items": [
            {
                "id": 2200,
                "order_id": 407,
                "product_id": 2,
                "code": "A001",
                "unity": "NIU",
                "name": "iPhone X",
                "tax_apply_code": "10",
                "qty": "1.00",
                "unit_amount_cost": "33.05",
                "has_discount": 0,
                "discount_base": "0.00",
                "discount_percent": "0.00",
                "discount_amount": "0.00",
                "amount_cost": "33.05",
                "base_amount": "33.05",
                "tax_percent": "18.00",
                "tax": "5.95",
                "tax_total": "5.95",
                "unit_amount_price": "39.00"
            },
            {
                "id": 2201,
                "order_id": 407,
                "product_id": 3,
                "code": "P001",
                "unity": "NIU",
                "name": "Televisor Samsung 20",
                "tax_apply_code": "10",
                "qty": "1.00",
                "unit_amount_cost": "29.66",
                "has_discount": 0,
                "discount_base": "0.00",
                "discount_percent": "0.00",
                "discount_amount": "0.00",
                "amount_cost": "29.66",
                "base_amount": "29.66",
                "tax_percent": "18.00",
                "tax": "5.34",
                "tax_total": "5.34",
                "unit_amount_price": "35.00"
            },
           
        ],
        "xml_url": "https:\/\/demo.simplefact.pe\/cdn\/ZXlKcGRpSTZJamRsZVVkelVHWkJhRElyZUZOSWNsZHZWSGhOYlVFOVBTSXNJblpoYkhWbElqb2ljSGhtUkdSMFNVcG9SRWRQTVd0Mk9FWTVkMVpDY3pGNGFYZFZkREZyUW5jNWIzQm5kRlZOYTFSeGVXaERUREo1YmtSNlp6bGxaR2gwZUdVM2FFcDVTU0lzSW0xaFl5STZJak0zTURRelpUWTBPV0UxWm1RM1ptRTJOVGRrWVRJM1pERmlaakU1T1RWaE5XSTJZbUprTTJVNE56ZGpNVFV5WW1abVpqVXlOelk1TnpGbE1qRXlZV1lpZlE9PQ==",
        "pdf_url": "https:\/\/demo.simplefact.pe\/cdn\/ZXlKcGRpSTZJalpIVVVsdFFsbE5kVEp3VGxCcU5YRkdXV05zYVVFOVBTSXNJblpoYkhWbElqb2liME5vTkhVMVVuWTBSMGRSVUNzNFlWSnZRVWxpYUhoR2MwTjZNalZ4Um1OelJGTldVRU5rTVROVlZIWm9NazkzZURkUVNtWkNObUl4Y0c0elVVTmtSeUlzSW0xaFl5STZJbVEzWm1ZNFpUVmtaak5pTWpka01qbG1ZVEV6TVRBMVpUZGxaV0ppTUdNeU4yWXpZV1kzT1dKbU1qUTNPRFE1TmpNNVpXWmlNVEl5TnpBeVl6ZGtaRElpZlE9PQ==",
        "pdf_url_show": false,
        "taxed_operation": "545.76",
        "unaffected_operation": "0.00",
        "exonerated_operation": "0.00",
        "free_operation": "0.00",
        "total_discount": "0.00",
        "notes": null,
        "origin": "api",
        "address": {
            "shipping": [],
            "billing": []
        },
        "metadata": null,
        "document_type_name": "DNI",
        "payment_method": "cash",
        "payment_status": "paid",
        "bill": {
            "id": 275,
            "order_id": 407,
            "xml_path": "invoices\/20601643316-03-B001-97.xml",
            "cdr_path": null,
            "pdf_path": "invoices\/20601643316-03-B001-97.pdf",
            "status": "pending",
            "error": null,
            "message": "Listo para enviar en el Resumen Diario de Boletas",
            "accepted_at": null,
            "created_at": "2020-04-30 18:14:16",
            "updated_at": "2020-04-30 18:14:16",
            "ticket": null
        },
        "transporter": null
    }
}
```

{% endtab %}
{% endtabs %}

## Anular una venta

<mark style="color:green;">`POST`</mark> `https://demo.simplefact.pe/v1/sales/orders/:id/cancel`

Anula la venta en SimpleFact® y anula comprobante de pago por SUNAT mediante el método baja de comprobante.

#### Path Parameters

| Name | Type   | Description    |
| ---- | ------ | -------------- |
| id   | number | Id de la venta |

#### Headers

| Name          | Type   | Description  |
| ------------- | ------ | ------------ |
| Authorization | string | Bearer token |

#### Request Body

| Name   | Type   | Description         |
| ------ | ------ | ------------------- |
| reason | string | Motivo de anulación |

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

```javascript
{
    "success": true, 
    "message": "Anulado correctamente",
    "data": {} //Order Resource
    
}
```

{% endtab %}
{% endtabs %}

## Crear una venta (Factura y Boleta, Nota de venta)

<mark style="color:green;">`POST`</mark> `https://demo.simplefact.pe/v1/sales/orders`

Este método permite realizar un venta con un comprobante electrónico ya sea boleta o factura.

#### Request Body

| Name                       | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| items                      | array   | <p><mark style="color:green;"><code>\[</code></mark></p><p> <mark style="color:green;"><code>{</code></mark> </p><p><mark style="color:green;"><code>"code": "SKU-411",</code></mark></p><p><mark style="color:green;"><code>"name": "FUNDA PARA IPHONE 13",</code></mark> </p><p><mark style="color:green;"><code>"qty": 2,</code></mark> </p><p><mark style="color:green;"><code>"price": 200, "tax\_percent": 18 }</code></mark> </p><p><mark style="color:green;"><code>]</code></mark></p> |
| currency                   | string  | Moneda por defecto `PEN`                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| total                      | number  | Total incluido impuestos                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| discount                   | number  | Descuento                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| tax\_total                 | number  | Total impuestos                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| subtotal                   | number  | Subtotal sin impuestos                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| due\_date                  | string  | Fecha de vencimiento                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| date                       | string  | Fecha de emisión del comprobante en formato ISO                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| invoice\_type              | string  | 01 Factura , 03 Boleta, nv = Nota de venta                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| customer\_address          | string  | Dirección del cliente                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| customer\_document\_number | string  | Numero de documento                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| customer\_document\_type   | number  | Tipo de documento 6: RUC 1: DNI                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| customer\_name             | string  | Nombre del cliente o razón social                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| notes                      | string  | Notas u observaciones                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| email\_send                | boolean | Especifica si se enviara un correo al cliente de forma automática con la factura en PDF y XML.                                                                                                                                                                                                                                                                                                                                                                                                  |
| customer\_email            | string  | Email del cliente                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| customer\_phone            | String  | Celular del cliente                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

{% tabs %}
{% tab title="200 Response Order Resource" %}

```javascript
{
    "success": true,
    "data": {
        "id": 407,
        "invoice_type": "03",
        "invoice_type_name": "Boleta de Venta Electr\u00f3nica",
        "invoice_number": "B001-97",
        "serie": "B001",
        "correlative": "97",
        "customer": {
           
        },
        "customer_name": "Juan Perez",
        "customer_document_type": "1",
        "customer_document_number": "00000000",
        "customer_document": "DNI",
        "status": "processing",
        "tax_total": "98.24",
        "total": "644.00",
        "date": "2020-04-30T23:14:15.000000Z",
        "date_formatted": "30\/04\/2020 18:14 PM",
        "due_date": "30\/04\/2020",
        "currency": "PEN",
        "currency_symbol": "S\/",
        "items": [
            {
                "id": 2200,
                "order_id": 407,
                "product_id": 2,
                "code": "A001",
                "unity": "NIU",
                "name": "Producto 1",
                "tax_apply_code": "10",
                "qty": "1.00",
                "unit_amount_cost": "33.05",
                "has_discount": 0,
                "discount_base": "0.00",
                "discount_percent": "0.00",
                "discount_amount": "0.00",
                "amount_cost": "33.05",
                "base_amount": "33.05",
                "tax_percent": "18.00",
                "tax": "5.95",
                "tax_total": "5.95",
                "unit_amount_price": "39.00"
            },

            {
                "id": 2204,
                "order_id": 407,
                "product_id": 34,
                "code": "E001",
                "unity": "ZZ",
                "name": "Producto 2",
                "tax_apply_code": "10",
                "qty": "1.00",
                "unit_amount_cost": "4.24",
                "has_discount": 0,
                "discount_base": "0.00",
                "discount_percent": "0.00",
                "discount_amount": "0.00",
                "amount_cost": "4.24",
                "base_amount": "4.24",
                "tax_percent": "18.00",
                "tax": "0.76",
                "tax_total": "0.76",
                "unit_amount_price": "5.00"
            }
        ],
        "xml_url": "https:\/\/demo.simplefact.pe\/cdn\/ZXlKcGRpSTZJamRselVHWkJhRElyZUZOSWNsZHZWSGhOYlVFOVBTSXNJblpoYkhWbElqb2ljSGhtUkdSMFNVcG9SRWRQTVd0Mk9FWTVkMVpDY3pGNGFYZFZkREZyUW5jNWIzQm5kRlZOYTFSeGVXaERUREo1YmtSNlp6bGxaR2gwZUdVM2FFcDVTU0lzSW0xaFl5STZJak0zTURRelpUWTBPV0UxWm1RM1ptRTJOVGRrWVRJM1pERmlaakU1T1RWaE5XSTJZbUprTTJVNE56ZGpNVFV5WW1abVpqVXlOelk1TnpGbE1qRXlZV1lpZlE9PQ==",
        "pdf_url": "https:\/\/demo.simplefact.pe\/cdn\/ZXlKcGRpE5kVEp3VGxCcU5YRkdXV05zYVVFOVBTSXNJblpoYkhWbElqb2liME5vTkhVMVVuWTBSMGRSVUNzNFlWSnZRVWxpYUhoR2MwTjZNalZ4Um1OelJGTldVRU5rTVROVlZIWm9NazkzZURkUVNtWkNObUl4Y0c0elVVTmtSeUlzSW0xaFl5STZJbVEzWm1ZNFpUVmtaak5pTWpka01qbG1ZVEV6TVRBMVpUZGxaV0ppTUdNeU4yWXpZV1kzT1dKbU1qUTNPRFE1TmpNNVpXWmlNVEl5TnpBeVl6ZGtaRElpZlE9PQ==",
        "pdf_url_show": false,
        "taxed_operation": "545.76",
        "unaffected_operation": "0.00",
        "exonerated_operation": "0.00",
        "free_operation": "0.00",
        "total_discount": "0.00",
        "notes": null,
        "origin": "api",
        "address": {
            "shipping": [],
            "billing": []
        },
        "metadata": null,
        "document_type_name": "DNI",
        "payment_method": "cash",
        "payment_status": "paid",
        "bill": {
            "id": 275,
            "order_id": 407,
            "xml_path": "invoices\/20601643316-03-B001-97.xml",
            "cdr_path": null,
            "pdf_path": "invoices\/20601643316-03-B001-97.pdf",
            "status": "success",
            "error": null,
            "message": "Enviado a SUNAT",
            "accepted_at": null,
            "created_at": "2020-04-30 18:14:16",
            "updated_at": "2020-04-30 18:14:16",
            "ticket": null
        },
        "transporter": null
    }
}
```

{% endtab %}
{% endtabs %}

## Actualizar Stock

<mark style="color:purple;">`PATCH`</mark> `https://demo.simplefact.pe/v1/sales/orders/id/stock`

#### Path Parameters

| Name | Type   | Description     |
| ---- | ------ | --------------- |
| id   | number | ID del producto |

#### Request Body

| Name   | Type   | Description                     |
| ------ | ------ | ------------------------------- |
| reason | string | Descripción de la operación     |
| qty    | number | Cantidad en negativo o positivo |

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

```
```

{% endtab %}
{% endtabs %}


# Nota de crédito y débito

En esta guía aprenderás a crear una nota de crédito

## Crear documento

<mark style="color:green;">`POST`</mark> `https://demo.simplefact.pe/v1/sales/orders`

Crear una nota de crédito para un comprobante electrónico emitido previamente.

#### Request Body

| Name                                                         | Type   | Description                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| modificator\_type<mark style="color:red;">\*</mark>          | string | <p>Motivo de nota de crédito: </p><p>01 =  Anulación</p><p>02 = Anulación por error en RUC</p><p>03 = Corrección por error en descripción<br>04 = Descuento Global</p><p>05 = Descuento por Item</p><p>06 = Devolución Total</p><p>07 = Devolución por Item</p><p>08 = Bonificación</p><p>09 = Disminución del valor</p><p>10 = Otros conceptos</p><p></p> |
| modificator<mark style="color:red;">\*</mark>                | string | <p>Documento al que se le aplica la nota de crédito, puede ser: </p><p>01  = Factura </p><p>03 = Boleta</p>                                                                                                                                                                                                                                                |
| modificator\_number<mark style="color:red;">\*</mark>        | string | Numero del comprobante a modificar                                                                                                                                                                                                                                                                                                                         |
| modificator\_serie<mark style="color:red;">\*</mark>         | string | Serie del comprobante a modificar                                                                                                                                                                                                                                                                                                                          |
| items<mark style="color:red;">\*</mark>                      | array  | <p><code>\[</code><br> <code>{</code> <br>  <code>"id":1,</code> <br>  <code>"qty":1,</code> <br>  <code>"price":23.6,</code> <br>  <code>"discount\_percent":0,</code><br>  <code>"tax\_percent":18</code> <br> <code>}</code><br><code>]</code></p>                                                                                                      |
| currency<mark style="color:red;">\*</mark>                   | string | Moneda por defecto `PEN`                                                                                                                                                                                                                                                                                                                                   |
| total                                                        | number | Total incluido impuestos                                                                                                                                                                                                                                                                                                                                   |
| discount                                                     | number | Descuento                                                                                                                                                                                                                                                                                                                                                  |
| tax\_total                                                   | number | Total impuestos                                                                                                                                                                                                                                                                                                                                            |
| subtotal                                                     | number | Subtotal sin impuestos                                                                                                                                                                                                                                                                                                                                     |
| due\_date                                                    | string | Fecha de vencimiento                                                                                                                                                                                                                                                                                                                                       |
| date                                                         | string | Fecha de emisión del comprobante en formato ISO                                                                                                                                                                                                                                                                                                            |
| invoice\_type<mark style="color:red;">\*</mark>              | string | 07 Nota de crédito                                                                                                                                                                                                                                                                                                                                         |
| customer\_address<mark style="color:red;">\*</mark>          | string | Dirección del cliente                                                                                                                                                                                                                                                                                                                                      |
| customer\_document\_number<mark style="color:red;">\*</mark> | string | Numero de documento                                                                                                                                                                                                                                                                                                                                        |
| customer\_document\_type<mark style="color:red;">\*</mark>   | number | Tipo de documento 6: RUC 1: DNI                                                                                                                                                                                                                                                                                                                            |
| customer\_name<mark style="color:red;">\*</mark>             | string | Nombre del cliente o razón social                                                                                                                                                                                                                                                                                                                          |

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

```
{
"success": true,
"data": {}
}
    
```

{% endtab %}
{% endtabs %}


