Consultar cotización

Detalle de una cotización: cliente, ítems con sus importes, totales, condiciones, cuentas de pago, estado y el comprobante emitido desde ella (si lo hay).

GEThttps://api.facturalo.pe/api/v3/cotizaciones/{id}

Comprobante vinculado

Cuando la cotización está CONVERTIDA, comprobante trae el comprobante emitido:

{
  "comprobante": {
    "id": "9f1c2b7e-0d4a-4b8e-9c55-1e2f3a4b5c6d",
    "tipo": "FACTURA",
    "numero": "F001-00000123",
    "fecha": "2026-11-10T16:02:11-05:00"
  }
}

Estados

Estado	Cuándo
`BORRADOR`	Recién creada. Default.
`ENVIADA`	La marcaste como enviada al cliente.
`ACEPTADA`	El cliente la aceptó.
`RECHAZADA`	El cliente no la aceptó.
`VENCIDA`	Calculado: `BORRADOR` o `ENVIADA` con `fechaVencimiento` pasada (hora Lima).
`CONVERTIDA`	Calculado: tiene un comprobante emitido vigente. Si SUNAT lo rechaza, se anula o se elimina, vuelve a `ACEPTADA` y se puede convertir otra vez.

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/mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3", {
  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,
  "data": {
    "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",
    "formaPago": "50% adelanto, saldo contra entrega",
    "tiempoEntrega": "5 días hábiles",
    "observaciones": "Precios incluyen instalación.",
    "condiciones": "Garantía de 12 meses.",
    "cuentas": [
      {
        "id": "a32ef8b1-b485-43e8-af6b-a744e01857a0",
        "tipo": "BANCO",
        "entidad": "BCP",
        "moneda": "PEN",
        "numero": "191-1234567-0-12",
        "cci": "00219100123456701254",
        "titular": "EMPRESA DEMO S.A.C.",
        "descripcion": "Cuenta corriente"
      },
      {
        "id": "a32ef8b1-cdbe-4a38-b6c7-d65261efe751",
        "tipo": "BILLETERA",
        "entidad": "YAPE",
        "moneda": "PEN",
        "numero": "987654321",
        "cci": null,
        "titular": "Juan Pérez",
        "descripcion": null
      }
    ],
    "items": [
      {
        "id": "a32eede9-5c92-4ac3-8336-945040c319f8",
        "tipo": "producto",
        "productoId": null,
        "codigo": "P-01",
        "descripcion": "Laptop 14\" Core i5",
        "unidadMedida": "NIU",
        "cantidad": 2,
        "precioUnitario": 3500.5,
        "descuento": 0,
        "tipoIgv": "10",
        "subtotal": 5933.05,
        "igv": 1067.95,
        "total": 7001
      },
      {
        "id": "a32eede9-5d10-4f2e-9a4b-2f6c1e0b7d21",
        "tipo": "servicio",
        "productoId": null,
        "codigo": null,
        "descripcion": "Instalación y configuración",
        "unidadMedida": "ZZ",
        "cantidad": 1,
        "precioUnitario": 250,
        "descuento": 50,
        "tipoIgv": "10",
        "subtotal": 169.49,
        "igv": 30.51,
        "total": 200
      },
      {
        "id": "a32eede9-5d71-4b8a-8c3e-91d2a7f04c55",
        "tipo": "producto",
        "productoId": null,
        "codigo": null,
        "descripcion": "Libro técnico",
        "unidadMedida": "NIU",
        "cantidad": 3,
        "precioUnitario": 40,
        "descuento": 0,
        "tipoIgv": "20",
        "subtotal": 120,
        "igv": 0,
        "total": 120
      }
    ]
  }
}