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

GET 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 hoyyesterday : ventas de ayer, month past_month ...

string

Rango fecha de fin

pageSize

number

Numero de resultados a mostrar, valor por defecto 10.

from

string

Rango fecha de inicio

Headers

Name

Type

Description

Authentication

string

Authentication token para acceder al recurso, el token es proporcionado por SimpleFact. Ejemplo: Bearer Token

{
   "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":"[email protected]",
            "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
   }
}

Detalle de una venta

GET https://demo.simplefact.pe/v1/sales/orders/:id

Muestra información de una venta y comprobante

Path Parameters

Name

Type

Description

string

ID de la venta

Headers

Name

Type

Description

Authorization

string

Bearer token

{
    "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
    }
}

Anular una venta

POST 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

number

Id de la venta

Headers

Name

Type

Description

Authorization

string

Bearer token

Request Body

Name

Type

Description

reason

string

Motivo de anulación

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

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

POST 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

[

{

"code": "SKU-411",

"name": "FUNDA PARA IPHONE 13",

"qty": 2,

"price": 200, "tax_percent": 18 }

]

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

{
    "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
    }
}

Actualizar Stock

PATCH https://demo.simplefact.pe/v1/sales/orders/id/stock

Path Parameters

Name

Type

Description

number

ID del producto

Request Body

Name

Type

Description

reason

string

Descripción de la operación

qty

number

Cantidad en negativo o positivo

AnteriorIntroducción SiguienteNota de crédito y débito

Última actualización hace 2 años

hashtagListar ventas

hashtagQuery Parameters

hashtagHeaders

hashtagDetalle de una venta

hashtagPath Parameters

hashtagHeaders

hashtagAnular una venta

hashtagPath Parameters

hashtagHeaders

hashtagRequest Body

hashtagCrear una venta (Factura y Boleta, Nota de venta)

hashtagRequest Body

hashtagActualizar Stock

hashtagPath Parameters

hashtagRequest Body

Listar ventas

Query Parameters

Headers

Detalle de una venta

Path Parameters

Headers

Anular una venta

Path Parameters

Headers

Request Body

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

Request Body

Actualizar Stock

Path Parameters

Request Body