Turno actual (reporte X)

El turno abierto con su resumen en vivo: por medio de pago (ventas, devoluciones, ingresos, egresos y lo esperado; el efectivo suma la apertura) y totales. `null` si la caja está cerrada.

GEThttps://api.facturalo.pe/api/v3/cajas/{id}/turno

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/mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3/turno", {
  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": "9d1b2c3d-4e5f-4a6b-8c7d-112233445566",
    "cajaId": "7c0e4a3e-1f2b-4c5d-8e9f-001122334455",
    "numero": 12,
    "estado": "abierto",
    "automatico": false,
    "montoApertura": 100,
    "abiertoEn": "2026-11-10T08:00:12-05:00",
    "abiertoPor": "Ana Pérez",
    "cerradoEn": null,
    "cerradoPor": null,
    "cierre": null,
    "diferencia": null,
    "notaCierre": null,
    "resumen": {
      "apertura": 100,
      "medios": [
        {
          "id": "a1b2c3d4-0000-4000-8000-000000000001",
          "nombre": "Efectivo",
          "tipo": "efectivo",
          "efectivo": true,
          "ventas": 850.5,
          "devoluciones": -20,
          "ingresos": 0,
          "egresos": -12.5,
          "neto": 818,
          "esperado": 918,
          "operaciones": 41
        },
        {
          "id": "a1b2c3d4-0000-4000-8000-000000000002",
          "nombre": "Yape",
          "tipo": "billetera",
          "efectivo": false,
          "ventas": 312,
          "devoluciones": 0,
          "ingresos": 0,
          "egresos": 0,
          "neto": 312,
          "esperado": 312,
          "operaciones": 18
        }
      ],
      "totales": {
        "ventas": 1162.5,
        "devoluciones": -20,
        "ingresos": 0,
        "egresos": -12.5,
        "neto": 1130,
        "documentos": 57,
        "boletas": 50,
        "facturas": 3,
        "notasVenta": 4
      }
    }
  }
}