Turnos de caja

Turnos de caja con el arqueo del cajón en cada moneda: fondo inicial, esperado, contado, diferencia y fondo que queda en el cajón.

Cargando el índice de búsqueda…

Turnos de caja

Objetos

PosShift

  • idintegerobligatorio

    ID del registro, único entre los registros de su tipo en la tienda.

  • numberstring o nullobligatorio

    Número del turno en el registro de la caja, por ejemplo Z-0044; null en turnos anteriores a la numeración.

  • location_idintegerobligatorio

    ID del local de la tienda.

  • register_idintegerobligatorio

    ID de la caja del punto. La API no tiene catálogo de cajas: para la contabilidad, agrupá los turnos por punto.

  • statusstringobligatorio

    open — el turno está en curso; closed — se contó el cajón y el turno se cerró.

    Valores:
    openclosed
  • opened_atstring (date-time)obligatorio

    Cuándo se abrió el turno.

  • closed_atstring (date-time) o nullobligatorio

    Cuándo se cerró el turno; null mientras está abierto.

  • notesstring o nullobligatorio

    Nota de quien cerró el turno; null si no hay.

  • drawersarray de objectobligatorio

    Un cajón por cada moneda que pasó por él; primero la moneda de la tienda. El esperado del cajón es opening_float más los movimientos de su moneda con el signo de direction.

    Campos · 7
    • idintegerobligatorio

      ID del cajón: la diferencia de un cajón en moneda extranjera se asienta en el libro de movimientos de dinero con un source de tipo pos_shift_drawer y este ID.

    • currencystringobligatorio

      Moneda del cajón, código ISO 4217: los importes del cajón están en sus unidades mínimas.

      Valores:
      ARSUSDBRLCLPCOPMXNPENRUB
    • opening_floatintegerobligatorio

      Fondo inicial.

    • expectedinteger o nullobligatorio

      Cuánto debía haber en el cajón al cierre; null mientras el turno está abierto.

    • countedinteger o nullobligatorio

      Cuánto se contó al cierre; null mientras el turno está abierto.

    • differenceinteger o nullobligatorio

      Diferencia: counted menos expected — sobrante con signo positivo, faltante con signo negativo. El libro de movimientos de dinero la asienta con el turno como comprobante. null mientras el turno está abierto.

    • carried_floatinteger o nullobligatorio

      Lo que quedó en el cajón como fondo del turno siguiente; lo depositado en la caja fuerte es counted menos carried_float. null mientras está abierto y en turnos cerrados antes de llevar la caja fuerte.

  • created_atstring (date-time)obligatorio

    Cuándo se creó el registro.

  • updated_atstring (date-time)obligatorio

    Cuándo cambió el registro por última vez.

Endpoints

Turnos de caja modificados desde un momento dado: arqueo del cajón en cada moneda

get/pos-shifts

Scope: finance:read

Parámetros

Query

  • limitinteger

    Tamaño de página: hasta 250 registros; 50 por defecto.

    Mínimo:
    1
    Máximo:
    250
  • cursorstring

    Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él.

    Largo máximo:
    4096
  • updated_sincestring (date-time)

    Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor.

    Patrón:
    ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
  • include_deletedboolean

    true — devolver también los registros eliminados: los archivados con deleted_at y los borrados de la base como marcas de eliminación {id, deleted_at} en la continuación por el cursor de sincronización. Activalo para sincronizar.

Respuestas

200Éxito

application/json

  • dataarray de PosShiftobligatorio

    Registros de la página.

  • deletedarray de objectobligatorio

    Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización.

    Campos · 2
    • idintegerobligatorio

      ID del registro borrado.

    • deleted_atstring (date-time)obligatorio

      Cuándo se borró el registro.

  • next_cursorstring o nullobligatorio

    Cursor de la página siguiente; null en la última.

  • has_morebooleanobligatorio

    true si hay una página siguiente.

  • sync_cursorstring o nullobligatorio

    En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás.

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

410El cursor de sincronización supera el plazo de conservación de eliminaciones o se emitió antes de restaurar la base de datos

application/problem+json

Devuelve Problem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Errores de este endpoint

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl "https://api.saleya.app/v1/pos-shifts" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "data": [
    {
      "id": 0,
      "number": "string",
      "location_id": 0,
      "register_id": 0,
      "status": "open",
      "opened_at": "2026-01-15T12:00:00Z",
      "closed_at": "2026-01-15T12:00:00Z",
      "notes": "string",
      "drawers": [
        {
          "id": 0,
          "currency": "ARS",
          "opening_float": 0,
          "expected": 0,
          "counted": 0,
          "difference": 0,
          "carried_float": 0
        }
      ],
      "created_at": "2026-01-15T12:00:00Z",
      "updated_at": "2026-01-15T12:00:00Z"
    }
  ],
  "deleted": [
    {
      "id": 0,
      "deleted_at": "2026-01-15T12:00:00Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true,
  "sync_cursor": "string"
}

Turno de caja

get/pos-shifts/{shift}

Scope: finance:read

Parámetros

Ruta

  • shiftintegerobligatorio

    ID del turno de caja.

Respuestas

200Éxito

application/json

Devuelve PosShift

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

404El objeto no existe o no está disponible para la aplicación

application/problem+json

Devuelve Problem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl "https://api.saleya.app/v1/pos-shifts/{shift}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "id": 0,
  "number": "string",
  "location_id": 0,
  "register_id": 0,
  "status": "open",
  "opened_at": "2026-01-15T12:00:00Z",
  "closed_at": "2026-01-15T12:00:00Z",
  "notes": "string",
  "drawers": [
    {
      "id": 0,
      "currency": "ARS",
      "opening_float": 0,
      "expected": 0,
      "counted": 0,
      "difference": 0,
      "carried_float": 0
    }
  ],
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}