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
shortdate
string
Filtrar por rango de fecha predeterminado ejemplo: today : ventas de hoyyesterday : ventas de ayer, month past_month ...
to
string
Rango fecha de fin
pageSize
number
Numero de resultados a mostrar, valor por defecto 10.
from
string
Rango fecha de inicio
Headers
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
id
string
ID de la venta
Headers
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
id
number
Id de la venta
Headers
Authorization
string
Bearer token
Request Body
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
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
id
number
ID del producto
Request Body
reason
string
Descripción de la operación
qty
number
Cantidad en negativo o positivo
Última actualización
¿Te fue útil?