Actualizar cotización

Reemplaza el contenido de la cotización (cabecera e ítems). Mismo cuerpo que Crear cotización. El número no cambia. No se puede editar una cotización CONVERTIDA (409).

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

Parámetros del request

Campo

Descripción

establecimiento

string | nullopcional

UUID del establecimiento. Si se omite, el principal.

serie

stringopcional

Serie de 4 caracteres. Default C001. El correlativo lo asigna Facturalo (siguiente de la serie).Ej: C001

fechaEmision

stringrequerido

YYYY-MM-DD.Ej: 2026-11-09

diasValidez

integer | nullopcional

Validez en días (1 a 365). Si llega, fechaVencimiento = fechaEmision + días.Ej: 15

fechaVencimiento

string | nullopcional

Válida hasta (YYYY-MM-DD). Se usa cuando no envías diasValidez.Ej: 2026-11-24

moneda

stringrequerido

PEN o USD.Ej: PEN

estado

stringopcional

BORRADOR (default), ENVIADA, ACEPTADA o RECHAZADA.Ej: BORRADOR

formaPago

string | nullopcional

Texto libre para el PDF (máx. 150).Ej: 50% adelanto, saldo contra entrega

tiempoEntrega

string | nullopcional

Texto libre para el PDF (máx. 150).Ej: 5 días hábiles

observaciones

string | nullopcional

Máx. 1000. Pasa a la factura/boleta al convertir.Ej: Precios incluyen instalación.

condiciones

string | nullopcional

Términos y condiciones (máx. 2000).Ej: Garantía de 12 meses.

cuentas

string[]opcional

UUIDs de cuentas de pago que salen en el PDF. Sin el campo: al crear, las marcadas para cotizaciones; al editar, se mantienen. [] = ninguna.

cliente

objectrequerido

Datos del cliente.

tipoDocumento

stringrequerido

Catálogo 06: 6 RUC, 1 DNI, 4 carné de extranjería, 7 pasaporte, 0 sin documento.Ej: 6

numeroDocumento

string | nullopcional

Obligatorio con RUC (11 dígitos) o DNI (8 dígitos).Ej: 20601476551

denominacion

stringrequerido

Razón social o nombre (máx. 250).Ej: CLIENTE DEMO S.A.C.

direccion

string | nullopcional

Dirección (máx. 500).Ej: AV. LIMA 123

correo

string | nullopcional

Correo del cliente.Ej: compras@cliente.pe

celular

string | nullopcional

Celular del cliente (máx. 20).Ej: 987654321

items

arrayrequerido

Entre 1 y 300 ítems, con el mismo formato que al emitir.

tipo

stringopcional

producto o servicio. Si falta, se deduce de unidadMedida (ZZ = servicio).Ej: producto

productoId

string | nullopcional

UUID reservado para el catálogo de productos y servicios (próximamente). Hoy se guarda tal cual.

unidadMedida

stringopcional

NIU, ZZ, BX, PK, KT o GLI. Si falta: NIU para producto, ZZ para servicio.Ej: NIU

codigo

string | nullopcional

Código interno del producto (máx. 100).Ej: P-01

descripcion

stringrequerido

Descripción (máx. 500).Ej: Laptop 14" Core i5

cantidad

numberrequerido

Mayor a 0.Ej: 2

precioUnitario

numberrequerido

Precio unitario con IGV, igual que al emitir.Ej: 3500.50

tipoIgv

stringopcional

Catálogo 07 (10 gravado, 20 exonerado, 30 inafecto…). Default 10.Ej: 10

descuento

numberopcional

Descuento de la línea, con IGV.Ej: 0

Si omites cuentas, se mantienen las cuentas que ya tenía la cotización. Una cuenta eliminada de la empresa que ya estaba en la cotización se conserva si sigue en cuentas.

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: "PUT",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "fechaEmision": "2026-11-09",
    "diasValidez": 15,
    "moneda": "PEN",
    "formaPago": "50% adelanto, saldo contra entrega",
    "tiempoEntrega": "5 días hábiles",
    "observaciones": "Precios incluyen instalación.",
    "condiciones": "Garantía de 12 meses.",
    "cuentas": [
      "a32ef8b1-b485-43e8-af6b-a744e01857a0",
      "a32ef8b1-cdbe-4a38-b6c7-d65261efe751"
    ],
    "cliente": {
      "tipoDocumento": "6",
      "numeroDocumento": "20601476551",
      "denominacion": "CLIENTE DEMO S.A.C.",
      "direccion": "AV. LIMA 123",
      "correo": "compras@cliente.pe"
    },
    "items": [
      {
        "tipo": "producto",
        "codigo": "P-01",
        "descripcion": "Laptop 14\" Core i5",
        "cantidad": 2,
        "precioUnitario": 3500.5,
        "tipoIgv": "10"
      },
      {
        "tipo": "servicio",
        "descripcion": "Instalación y configuración",
        "cantidad": 1,
        "precioUnitario": 250,
        "tipoIgv": "10",
        "descuento": 50
      },
      {
        "tipo": "producto",
        "descripcion": "Libro técnico",
        "cantidad": 3,
        "precioUnitario": 40,
        "tipoIgv": "20"
      }
    ]
  })
});

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": "Cotización C001-00000001 actualizada.",
  "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
      }
    ]
  }
}