Conecta tu ERP con FastStock Scanner

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 sistemas

Lista de Prerequisitos

Asegú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

Resumen de Integración

Comprende cómo el scanner FastStock se integra con tu sistema ERP

Step 1
Customer Action
Step 2
Scanner Request
Step 3
API Call
Step 4
Database Query
Step 5
Display Results

Customer

Scans product barcode in store

FastStock

Scanner web application

Your API

REST API endpoint

Your ERP

Product database

🔗 API Request

Method: GET
URL: /api/product/{barcode}
Headers: Authorization, CORS

📋 Response Format

Content-Type: application/json
Required: id, title, stock
Optional: price, ecommerce_url

⚡ Performance

Response Time: <2 seconds
Caching: Recommended
Rate Limit: 100/minute

Sample Data Exchange

Request:
GET /api/product/1234567890123
Authorization: Bearer your-api-key
Accept: application/json
Response:
{
  "id": "1234567890123",
  "title": "Blue T-Shirt",
  "stock": [{
    "color": "Blue",
    "stores": [{
      "storeName": "Main Store",
      "sizes": [{"size": "M", "quantity": 5}]
    }]
  }]
}

Guía de Integración Paso a Paso

Step 1: Entendiendo el Flujo de Datos

Entendiendo el Flujo de Datos

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.

Integration Flow Diagram

Customer

Scans barcode

FastStock

Scanner App

Your ERP

API Response

Progress: 0/5 Steps Completed

Keep going! You're making great progress on your ERP integration.

0%
Complete

Referencia API

Endpoint Requerido

Tu sistema debe implementar esta estructura de endpoint:

GET /api/product/{barcode}

Formato de Respuesta

{
  "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"
}

Campos Requeridos

  • • id - Código de barras del producto
  • • title - Nombre del producto
  • • stock - Array de información de stock
  • • stock[].color - Variante de color del producto
  • • stock[].stores - Disponibilidad en tiendas
  • • stores[].storeName - Nombre de la tienda
  • • stores[].sizes - Disponibilidad de tallas

Campos Opcionales

  • • family - Categoría del producto
  • • subfamily - Subcategoría del producto
  • • refproveedor - SKU/Referencia
  • • net_price - Precio del producto
  • • ecommerce_url - Enlace a página del producto
  • • stores[].storeadress - Dirección de la tienda
  • • stores[].subcompany - Grupo de tiendas

Explorador de API

Prueba tu integración API con nuestro explorador interactivo

Prueba tu Endpoint API

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

Solicitud de Ejemplo

curl -X GET "https://your-api.com/api/product/1234567890123" \
  -H "Content-Type: application/json"

Lista de Verificación de Integración

✅ Endpoint retorna estado HTTP 200
✅ Respuesta es formato JSON válido
✅ Contiene campos requeridos: id, title, stock
✅ Array stock contiene datos de color y tiendas
✅ Headers CORS permiten acceso del dominio FastStock
✅ Autenticación funciona correctamente (si es requerida)
✅ Tiempo de respuesta es menor a 2 segundos

Resolución de Problemas

Problemas comunes y soluciones

Error de Configuración CORS

Configurar headers CORS para permitir acceso del dominio FastStock

Solución: Agregar 'https://faststock.net' a tus orígenes CORS permitidos

Fallo de Autenticación

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'

Formato de Respuesta Inválido

La respuesta no coincide con la estructura JSON requerida

Solución: Validar tu respuesta contra la especificación API anterior

Optimización de Performance

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

ERP Integration - FastStock