Skip to main content
GET
/
api
/
ventas
Listar Ventas
curl --request GET \
  --url https://api.example.com/api/ventas
{
  "success": true,
  "ventas": [
    {
      "id_venta": 123,
      "id_tido": 123,
      "serie": "<string>",
      "numero": 123,
      "fecha_emision": "<string>",
      "cliente": {
        "documento": "<string>",
        "datos": "<string>"
      },
      "tipo_documento": {
        "abreviatura": "<string>"
      },
      "subtotal": 123,
      "igv": 123,
      "total": 123,
      "tipo_moneda": "<string>",
      "id_tipo_pago": 123,
      "metodo_pago": {},
      "voucher": {},
      "estado": "<string>",
      "estado_sunat": "<string>",
      "nombre_xml": {},
      "cdr_url": {},
      "afecta_stock": true,
      "stock_real_descontado": true
    }
  ],
  "message": "<string>"
}

​
Endpoint

GET /api/ventas

​
Autenticación

Requiere token de autenticación Bearer en el header: 
Authorization: Bearer {token}

​
Permisos Requeridos

  • ventas.view

​
Descripción

Retorna todas las ventas (facturas, boletas, notas de venta) de la empresa del usuario autenticado, ordenadas por fecha de emisión y número descendente. Incluye relaciones con cliente, tipo de documento y pagos.

​
Respuesta Exitosa

​
success
boolean
Indica si la operación fue exitosa
​
ventas
array
Array de objetos de venta

​
Ejemplo de Respuesta

{
  "success": true,
  "ventas": [
    {
      "id_venta": 125,
      "id_tido": 2,
      "serie": "F001",
      "numero": 348,
      "fecha_emision": "2024-03-15",
      "cliente": {
        "documento": "20612706702",
        "datos": "SANTO DOMINGO SAC"
      },
      "tipo_documento": {
        "abreviatura": "FAC"
      },
      "subtotal": 847.46,
      "igv": 152.54,
      "total": 1000.00,
      "tipo_moneda": "PEN",
      "id_tipo_pago": 1,
      "metodo_pago": 1,
      "voucher": null,
      "estado": "1",
      "estado_sunat": "1",
      "nombre_xml": "20612706702-01-F001-00000348",
      "cdr_url": "sunat/cdr/20612706702/R-20612706702-01-F001-00000348.zip",
      "afecta_stock": true,
      "stock_real_descontado": false
    },
    {
      "id_venta": 124,
      "id_tido": 1,
      "serie": "B001",
      "numero": 892,
      "fecha_emision": "2024-03-14",
      "cliente": {
        "documento": "12345678",
        "datos": "JUAN PEREZ LOPEZ"
      },
      "tipo_documento": {
        "abreviatura": "BOL"
      },
      "subtotal": 254.24,
      "igv": 45.76,
      "total": 300.00,
      "tipo_moneda": "PEN",
      "id_tipo_pago": 1,
      "metodo_pago": 2,
      "voucher": "vouchers/voucher_124_1710432156.jpg",
      "estado": "1",
      "estado_sunat": "0",
      "nombre_xml": null,
      "cdr_url": null,
      "afecta_stock": true,
      "stock_real_descontado": false
    }
  ]
}

​
Errores

​
success
boolean
false en caso de error
​
message
string
Mensaje descriptivo del error

​
Respuesta de Error 500

{
  "success": false,
  "message": "Error al cargar las ventas"
}

​
Filtrado por Empresa

El endpoint automáticamente filtra las ventas por id_empresa del usuario autenticado. Solo se retornan ventas de la empresa asociada al token.

​
Relaciones Cargadas

El endpoint utiliza eager loading para optimizar consultas:
  • cliente - Información completa del cliente
  • tipoDocumento - Tipo de documento SUNAT
  • pagos - Pagos asociados a la venta (se retorna el primero)

​
Código de Referencia

Ver implementación en app/Http/Controllers/VentasController.php:23 método index()

​
Ejemplo de Solicitud

curl -X GET "https://facturacion.santodomingo.pe/api/ventas" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGc..."

Build docs developers (and LLMs) love

Get started for freeTalk to us