Listar cotizaciones

Cotizaciones de la empresa y el entorno del token, de la más reciente a la más antigua. Las filas no traen ítems: usa Consultar cotización para el detalle.

GEThttps://api.facturalo.pe/api/v3/cotizaciones

Query

Campo

Descripción

estado

stringopcional

BORRADOR, ENVIADA, ACEPTADA, RECHAZADA, VENCIDA o CONVERTIDA.Ej: ENVIADA

buscar

stringopcional

Número (C001-12), RUC/DNI o nombre del cliente.Ej: C001-1

fecha_inicio

stringopcional

Fecha de emisión desde (YYYY-MM-DD).Ej: 2026-11-01

fecha_fin

stringopcional

Fecha de emisión hasta (YYYY-MM-DD).Ej: 2026-11-30

establecimiento

stringopcional

UUID del establecimiento.Ej: 11111111-2222-3333-4444-555555555555

page

integeropcional

Página. Default 1.Ej: 1

limite

integeropcional

Filas por página (1 a 100). Default 20.Ej: 20

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/cotizaciones", {
  method: "GET",
  headers: {
    "Authorization": "sk_test_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Cotizaciones obtenidas correctamente.",
  "data": {
    "entorno": "demo",
    "paginacion": {
      "total": 1,
      "limite": 20,
      "pagina": 1,
      "paginas": 1
    },
    "cotizaciones": [
      {
        "id": "a32eede9-59df-4d65-829e-ab7b9331ecec",
        "serie": "C001",
        "correlativo": 1,
        "numero": "C001-00000001",
        "fechaEmision": "2026-11-09",
        "fechaVencimiento": "2026-11-24",
        "diasValidez": 15,
        "moneda": "PEN",
        "estado": "BORRADOR",
        "cliente": {
          "tipoDocumento": "6",
          "numeroDocumento": "20601476551",
          "denominacion": "CLIENTE DEMO S.A.C.",
          "direccion": "AV. LIMA 123",
          "correo": "compras@cliente.pe",
          "celular": null
        },
        "totales": {
          "gravada": 6102.54,
          "exonerada": 120,
          "descuento": 50,
          "igv": 1098.46,
          "total": 7321
        },
        "establecimiento": {
          "id": "11111111-2222-3333-4444-555555555555",
          "nombre": "PRINCIPAL"
        },
        "comprobante": null,
        "origen": "api",
        "enlaces": {
          "pdf": "https://api.facturalo.pe/api/v3/cotizaciones/a32eede9-59df-4d65-829e-ab7b9331ecec.pdf"
        },
        "creado": "2026-11-09T10:15:02-05:00",
        "actualizado": "2026-11-09T10:15:02-05:00"
      }
    ]
  }
}