Documentación internaPrivado

SDK POS de Cartamatic

Guía técnica para consumir @cartamatic/pos-sdk desde aplicaciones Cartamatic server-side, con referencia completa de funciones, métodos, tipos, errores, webhooks y reglas de seguridad.

Abrir documentaciónVer referencia API
server-flow.ts
const pos = createPosClient({
  provider: "toteat",
  toteat: secureConnection
});

const sales = await pos.sales.getSales({
  startDate: "2026-07-01",
  endDate: "2026-07-15"
});

Provider actual

Toteat

Adapter base implementado con endpoints de lectura, escritura y webhooks.

Ejecución

Server-side

Diseñado para route handlers, server actions, jobs y servicios internos.

Superficie

15 métodos

Catálogo, mesas, turnos, órdenes, ventas, fiscal, inventario, compras y raw.

Seguridad

Redacción

Helpers para ocultar tokens, IDs y query params sensibles de Toteat.
Flujo recomendadoVer guía
  1. 01Resolver tenant, restaurante y local autorizado
  2. 02Leer credenciales POS desde storage seguro
  3. 03Crear cliente con createPosClient
  4. 04Ejecutar método normalizado del SDK
Reglas críticasSeguridad
  • No usar NEXT_PUBLIC_* para credenciales POS
  • No importar el SDK en client components
  • No loggear URLs Toteat sin redacción
  • No usar raw.request como integración permanente