Cerrar turno

Cierra el turno. En nivel `arqueo` el efectivo contado es obligatorio y queda la diferencia con lo esperado.

POSThttps://api.facturalo.pe/api/v3/cajas/{id}/cerrar

Parámetros del body

Campo

Descripción

contado

objectopcional

{ idDelMedio: monto } contado al cerrar.

billetes

objectopcional

Opcional: { "100": 3, "50": 2, "0.5": 4 } (informativo).

nota

stringopcional

Hasta 250 caracteres.

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/cerrar", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "contado": {
      "a1b2c3d4-0000-4000-8000-000000000001": 915.5
    },
    "billetes": {
      "5": 1,
      "10": 1,
      "50": 4,
      "100": 3,
      "200": 2,
      "0.5": 1
    },
    "nota": "Faltó sencillo"
  })
});

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": "cerrado",
    "automatico": false,
    "montoApertura": 100,
    "abiertoEn": "2026-11-10T08:00:12-05:00",
    "abiertoPor": "Ana Pérez",
    "cerradoEn": "2026-11-10T20:02:40-05:00",
    "cerradoPor": "Ana Pérez",
    "cierre": {
      "medios": [
        {
          "medioId": "a1b2c3d4-0000-4000-8000-000000000001",
          "nombre": "Efectivo",
          "efectivo": true,
          "esperado": 918,
          "contado": 915.5,
          "diferencia": -2.5
        },
        {
          "medioId": "a1b2c3d4-0000-4000-8000-000000000002",
          "nombre": "Yape",
          "efectivo": false,
          "esperado": 312,
          "contado": null,
          "diferencia": null
        }
      ],
      "billetes": {
        "5": 1,
        "10": 1,
        "50": 4,
        "100": 3,
        "200": 2,
        "0.5": 1
      }
    },
    "diferencia": -2.5,
    "notaCierre": "Faltó sencillo",
    "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
      }
    }
  }
}