Crear o editar caja

Crea una caja (o `PUT /cajas/{id}` para editarla).

POSThttps://api.facturalo.pe/api/v3/cajas

Parámetros del body

Campo

Descripción

nombre

stringrequerido

Único por establecimiento.Ej: Caja 2

establecimientoId

stringopcional

Local de la caja. Default: el principal.

nivel

stringopcional

sin_turnos, simple (default) o arqueo.

series

objectopcional

boleta (B001), factura (F001), notaVenta (NV01). Vacío = las del local.

medios

arrayopcional

Ids de medios aceptados. null = todos los activos.

activo

booleanopcional

Una caja desactivada no recibe ventas.

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/cajas", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "nombre": "Caja 2",
    "nivel": "arqueo",
    "series": {
      "boleta": "B002",
      "factura": "F002",
      "notaVenta": "NV02"
    }
  })
});

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,
  "data": {
    "id": "7c0e4a3e-1f2b-4c5d-8e9f-001122334455",
    "nombre": "Caja 2",
    "nivel": "arqueo",
    "establecimiento": {
      "id": "11111111-2222-3333-4444-555555555555",
      "nombre": "Principal"
    },
    "series": {
      "boleta": "B002",
      "factura": "F002",
      "notaVenta": "NV02"
    },
    "medios": null,
    "activo": true,
    "turnoAbierto": null
  }
}