Conecta tu sistema con POS Colombia.

Todo lo que tu integración necesita

Una API pensada para conectar el POS con tu ERP, tu tienda online, un tablero propio o un agente IA — sin fricción.

Empieza en 3 pasos

De cero a tu primera venta registrada desde tu sistema, en el entorno de pruebas.

1. 1Crea una llave de prueba

   En el dashboard, entra a Configuración → API Keys y genera una llave pk_test_. El secreto se muestra una sola vez: cópialo.

2. 2Haz tu primer request

   Lista tus productos del sandbox con curl o Node:

   curl https://poscolombia.com/api/v1/products \
     -H "X-API-Key: pk_test_..."

   const res = await fetch(
     "https://poscolombia.com/api/v1/products",
     { headers: { "X-API-Key": process.env.POS_API_KEY } },
   );
   const { data } = await res.json();

3. 3Registra una venta (idempotente)

   Manda un clientReference único por intento: reintentar nunca cobra dos veces.

   await fetch("https://poscolombia.com/api/v1/orders", {
     method: "POST",
     headers: {
       "X-API-Key": process.env.POS_API_KEY,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       clientReference: crypto.randomUUID(),
       orderType: "para_llevar",
       items: [{ productId: "prod-uuid", quantity: 2 }],
       paymentMethod: "cash",
     }),
   });

Preguntas frecuentes