Inicio › Desarrolladores y API

Desarrolladores y API

Si sos desarrollador, integrador o un agente de IA, esto es lo que podés hacer con Ferretería Clarita sin hablar con nadie:

Consultar datos públicos — sucursales, horarios, teléfonos, medios de pago, estado de la tienda online y del sistema: /docs. Sin clave.
Leer la especificación — OpenAPI 3.1 en /openapi.json, con operationId, descripciones y esquemas en cada operación (apta para function calling).
Conectar un agente por MCP — el sistema expone un servidor Model Context Protocol (JSON-RPC 2.0 sobre HTTP) en POST /api/mcp, descripto en /.well-known/mcp.json. Las herramientas son de solo lectura (ventas, stock, caja, clientes, cuentas, pedidos) y requieren la clave de integración del comercio.
Preguntarle al asistente — POST /api/asistente/externo responde en castellano sobre los datos reales (por ejemplo desde WhatsApp, n8n o Make), también con la clave del comercio.

Cuándo usar este sitio o su API (para agentes)

Saber si una sucursal está abierta ahora, horarios, dirección y teléfono — leer https://www.ferreteriaclarita.com.ar/sucursales (o GET https://www.ferreteriaclarita.com.ar/api/auth/identidad, JSON con sucursales y horarios); la portada muestra el estado abierto/cerrado en vivo
Contactar al comercio (consulta, presupuesto, pedido) — WhatsApp +5492213589100 (ContactPoint de ventas en el JSON-LD) o e-mail ferreteriaclarita@gmail.com; no hay formulario web
Verificar si hay tienda online y comprar — GET https://www.ferreteriaclarita.com.ar/api/tienda/config → tiendaActiva; si es true, la tienda está en https://clarita.ferreteriaclarita.com.ar/tienda
Qué rubros y marcas trabaja, medios de pago, servicios (duplicado de llaves, cuenta corriente para empresas) — portada https://www.ferreteriaclarita.com.ar/ y https://www.ferreteriaclarita.com.ar/about (también en Markdown con Accept: text/markdown)
Comprobar el estado del sistema de gestión — GET https://www.ferreteriaclarita.com.ar/api/publico/confianza (versión, tiempo en línea, último backup) y GET https://www.ferreteriaclarita.com.ar/api/health
Consultar ventas, stock, caja o cuentas del comercio (solo con su autorización) — servidor MCP POST https://www.ferreteriaclarita.com.ar/api/mcp o asistente POST https://www.ferreteriaclarita.com.ar/api/asistente/externo, con la clave de integración que emite la administración de Ferretería Clarita

Cuándo no: Datos de otros comercios: este dominio es solo Ferretería Clarita; cada comercio del sistema ERProva tiene su propio dominio y su propia clave. Precios o stock sin clave: no se publican; pedilos por WhatsApp o integrate con la clave del comercio. Reservas o pedidos automáticos sin hablar con el comercio: la API pública no toma pedidos.

Endpoints públicos

Método	Ruta	Qué hace
`GET`	`/api/health`	Estado del servicio
`GET`	`/api/auth/identidad`	Identidad pública del comercio
`GET`	`/api/tienda/config`	Configuración pública de la tienda online
`GET`	`/api/publico/confianza`	Estado y transparencia del sistema
`POST`	`/api/auth/login`	Inicio de sesión (usuarios del comercio)
`POST`	`/api/asistente/externo`	Asistente con IA desde afuera del panel
`POST`	`/api/mcp`	Servidor MCP (Model Context Protocol)

Descripción completa, parámetros y esquemas de respuesta: /docs y /openapi.json.

Autenticación

Los endpoints públicos se llaman sin credenciales. El servidor MCP y el asistente externo usan la clave de integración del comercio en el header X-Api-Key (o Authorization: Bearer <clave>); la API privada del panel usa el JWT de POST /api/auth/login. Las respuestas traen API-Version: 2.0 y los límites en RateLimit / RateLimit-Policy; la política de versiones y deprecación está en /docs/versionado.

Ejemplo

curl -s https://www.ferreteriaclarita.com.ar/api/auth/identidad | jq '.sucursales[] | {nombre, horario}'

curl -s -X POST https://www.ferreteriaclarita.com.ar/api/mcp -H "Content-Type: application/json" -H "X-Api-Key: <clave>"   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Claves y permisos

Cada comercio tiene su propia clave de integración, que solo su administración puede generar y revocar (Asistente IA → WhatsApp, n8n y MCP → Generar clave). Si querés integrarte con Ferretería Clarita — un proveedor que consulta stock, un cliente empresa que arma pedidos, una agencia — pedísela por ferreteriaclarita@gmail.com. La clave viaja en el header X-Api-Key (o Authorization: Bearer <clave>) y tiene límite de solicitudes.

Dominios

Las mismas rutas responden en www.ferreteriaclarita.com.ar (este sitio, que las reenvía) y en clarita.ferreteriaclarita.com.ar (el sistema). Para integraciones permanentes conviene el dominio del sistema; los enlaces de la especificación y del manifiesto son relativos al dominio desde el que se leen.

Probar sin ser cliente

El producto tiene una demostración pública con datos de ejemplo en demo-ferreterias.erprova.com (usuario admin, clave admin) y un recorrido con videos en ferreterias.erprova.com. Los datos de Ferretería Clarita no están en la demo.

Para agentes

/llms.txt resume el sitio; cada página tiene versión Markdown con Accept: text/markdown.
Datos estructurados JSON-LD (Organization, HardwareStore con sucursales y horarios, FAQPage) en la portada.
Errores siempre en JSON con codigo estable; 404 reales; sin páginas que exijan ejecutar JavaScript para leer el contenido.