Habilita la verificación de stock en tiempo real integrando tu base de datos de productos con nuestro sistema scanner
Para desarrolladores backend e integradores de sistemasAsegúrate de tener estos requisitos antes de comenzar
Base de datos de productos o sistema ERP existente
Capacidades de desarrollo de API REST
Códigos de barras de productos en tu sistema
Datos de inventario por tienda/ubicación
Entorno de desarrollo o staging
Comprende cómo el scanner FastStock se integra con tu sistema ERP
Scans product barcode in store
Scanner web application
REST API endpoint
Product database
GET /api/product/1234567890123 Authorization: Bearer your-api-key Accept: application/json
{
"id": "1234567890123",
"title": "Blue T-Shirt",
"stock": [{
"color": "Blue",
"stores": [{
"storeName": "Main Store",
"sizes": [{"size": "M", "quantity": 5}]
}]
}]
}Aprende cómo el scanner consulta tu sistema y el ciclo completo de request/response
Cuando un cliente escanea un código de barras, FastStock envía una petición a tu endpoint API. Tu sistema responde con información del producto y stock, que se muestra en la app scanner.
Customer
Scans barcode
FastStock
Scanner App
Your ERP
API Response
Configura la estructura de endpoint requerida en tu sistema
Tu sistema necesita proveer un endpoint GET en `/api/product/[barcode]` que retorne información de producto y stock en el formato especificado.
// Express.js example
app.get('/api/product/:barcode', async (req, res) => {
const { barcode } = req.params;
// Authenticate request
const apiKey = req.headers.authorization?.replace('Bearer ', '');
if (!validateApiKey(apiKey)) {
return res.status(401).json({ error: 'Unauthorized' });
}
// Query your database
const product = await db.getProductByBarcode(barcode);
if (!product) {
return res.status(404).json({ error: 'Product not found' });
}
// Return formatted response
res.json(formatProductResponse(product));
});Estructura tu respuesta API según los requisitos de FastStock
Tu API debe retornar datos JSON con campos específicos para información de producto, niveles de stock y ubicaciones de tiendas.
Your API endpoint should return a JSON response in this exact format:
{
"id": "1234567890123",
"title": "Product Name",
"family": "Category",
"subfamily": "Subcategory",
"refproveedor": "SKU123",
"net_price": 29.99,
"stock": [
{
"color": "Blue",
"stores": [
{
"storeName": "Main Store",
"storeadress": "123 Main Street",
"subcompany": "MAIN",
"sizes": [
{
"size": "M",
"quantity": 5
},
{
"size": "L",
"quantity": 3
}
]
}
]
}
],
"ecommerce_url": "https://yourstore.com/product/item-slug"
}Note: Use the API Explorer below to test your endpoint and validate the response format automatically.
Configura acceso seguro a tus endpoints API
Implementa autenticación con API key y configura CORS para permitir acceso del scanner FastStock.
const cors = require('cors');
app.use(cors({
origin: 'https://faststock.net',
credentials: true
}));Header set Access-Control-Allow-Origin "https://faststock.net" Header set Access-Control-Allow-Methods "GET" Header set Access-Control-Allow-Headers "Authorization"
Valida tu implementación con nuestras herramientas de testing
Usa nuestro explorador de API para probar tus endpoints y asegurar que retornan el formato de datos correcto.
Use our API Explorer below to test your endpoint and ensure it returns the correct format.
Keep going! You're making great progress on your ERP integration.
Tu sistema debe implementar esta estructura de endpoint:
GET /api/product/{barcode}{
"id": "1234567890123",
"title": "Product Name",
"family": "Category",
"subfamily": "Subcategory",
"refproveedor": "SKU123",
"net_price": 29.99,
"stock": [
{
"color": "Blue",
"stores": [
{
"storeName": "Main Store",
"storeadress": "123 Main Street",
"subcompany": "MAIN",
"sizes": [
{
"size": "M",
"quantity": 5
}
]
}
]
}
],
"ecommerce_url": "https://yourstore.com/product/item-slug"
}Prueba tu integración API con nuestro explorador interactivo
Ingresa los detalles de tu endpoint API abajo para probar la integración con FastStock.
Usa __BARCODE__ como marcador de posición para el parámetro barcode
curl -X GET "https://your-api.com/api/product/1234567890123" \ -H "Content-Type: application/json"
Problemas comunes y soluciones
Configurar headers CORS para permitir acceso del dominio FastStock
Solución: Agregar 'https://faststock.net' a tus orígenes CORS permitidos
La autenticación de API key no funciona correctamente
Solución: Asegurar que la API key se envía en el header Authorization: 'Bearer tu-api-key'
La respuesta no coincide con la estructura JSON requerida
Solución: Validar tu respuesta contra la especificación API anterior
Las respuestas API son muy lentas para los requerimientos del scanner
Solución: Implementar caché e indexación de base de datos en el campo barcode