POS.Next · API de terceros (1.0.0)

Empezá a integrar

Pedile al administrador del comercio la URL de su API y una clave con el permiso de consulta que necesitás. Las URLs y credenciales de esta referencia son ejemplos.

  1. Usá HTTPS y enviá la clave en el encabezado X-API-Key.
  2. Consultá la operación correspondiente y verificá el resultado.
  3. Para catálogo y existencias, iniciá sin cursor. Repetí cada consulta con el nextCursor de la respuesta anterior hasta recibir null.

Sincronización y reintentos

  • Catálogo y existencias devuelven hasta 25 registros por defecto. Podés pedir entre 1 y 100 con pageSize.
  • Conservá tu copia anterior hasta completar todas las páginas. Al terminar, compará los identificadores para detectar bajas. Las altas posteriores al inicio del recorrido aparecen en la siguiente sincronización.
  • Ante 401, revisá si la clave está vigente. Ante 403, revisá HTTPS y el permiso requerido. Ante 429, respetá Retry-After antes de reintentar. Usá el requestId de la respuesta al reportar un problema.
  • Los importes están en pesos argentinos. Las fechas de informes corresponden a la jornada comercial de la instalación y la respuesta incluye su zona horaria y hora de corte.

Permisos por consulta

  • GET /catalog/products · catalog.read
  • GET /inventory/items · inventory.read
  • GET /sales/summary · sales.summary.read
Servers
Ejemplo. Sustituí el nombre por el de tu comercio.
https://api-comercio.example.com/api/integrations/v1