Emitir nota de venta

Emite una nota de venta: descuenta stock de los productos del catálogo y registra el cobro en la caja.

POSThttps://api.facturalo.pe/api/v3/notas-venta

Parámetros del body

Campo

Descripción

caja

stringopcional

Caja donde se cobra (con turno abierto, salvo sin_turnos).

cliente

objectopcional

tipoDocumento (0, 1, 6…), numeroDocumento, nombre. Default: clientes varios.

items[].productoId

stringopcional

Variante del catálogo (id, SKU o código de barras).

items[].descripcion

stringopcional

Obligatoria si no hay productoId.

items[].cantidad

numberrequerido

items[].precioUnitario

numberopcional

Con IGV. Default: el precio del catálogo.

items[].series

arrayopcional

Series / IMEI si el producto las controla.

pagos

arrayopcional

Igual que al emitir: medio, monto, recibido.

serie

stringopcional

Default: la de la caja o NV01.

formaPago

stringopcional

CONTADO (default) o CREDITO. Al crédito el cliente necesita DNI o RUC; sin pagos no entra dinero a la caja y la deuda va a cuentas por cobrar.

cuotas

arrayopcional

Al crédito: [{fecha, monto}] (YYYY-MM-DD); deben sumar el total. Sin cuotas, una sola a 30 días.

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/notas-venta", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "caja": "7c0e4a3e-1f2b-4c5d-8e9f-001122334455",
    "items": [
      {
        "productoId": "POS-GASEOSA-500",
        "cantidad": 2
      }
    ],
    "pagos": [
      {
        "medio": "efectivo",
        "monto": 7,
        "recibido": 10
      }
    ]
  })
});

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

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

201Created

{
  "success": true,
  "message": "Nota de venta emitida.",
  "data": {
    "id": "3c4d5e6f-7a8b-4c9d-8e0f-a1b2c3d4e5f6",
    "serie": "NV01",
    "numero": 3,
    "documento": "NV01-00000003",
    "fecha": "2026-11-10",
    "moneda": "PEN",
    "cliente": {
      "tipoDocumento": "0",
      "numeroDocumento": null,
      "nombre": "CLIENTES VARIOS"
    },
    "total": 7,
    "estado": "emitida",
    "comprobanteId": null,
    "cajaId": "7c0e4a3e-1f2b-4c5d-8e9f-001122334455",
    "observaciones": null,
    "items": [
      {
        "productoId": "a32fc76c-49f8-48c9-933f-62d3e8da007d",
        "descripcion": "Gaseosa 500 ml",
        "unidadMedida": "NIU",
        "cantidad": 2,
        "precioUnitario": 3.5,
        "total": 7,
        "series": []
      }
    ],
    "creado": "2026-11-10T11:15:02-05:00",
    "enlaces": {
      "pdfTicket": "https://api.facturalo.pe/api/v3/notas-venta/3c4d5e6f-7a8b-4c9d-8e0f-a1b2c3d4e5f6.ticket.pdf",
      "pdf": "https://api.facturalo.pe/api/v3/notas-venta/3c4d5e6f-7a8b-4c9d-8e0f-a1b2c3d4e5f6.pdf"
    }
  }
}