Generar un API Token para integrar con MTR

Si querés conectar tus propios sistemas (CRM custom, ERP propio, scripts) a MTR, generás un API Token y autenticás con él.

Crear un token

1. Andá a Configuración → API Tokens. 2. Click en + Nuevo token. 3. Completá:

• Nombre: identificá para qué lo vas a usar (ej. "Sync con Odoo").
• Permisos: qué puede hacer (lectura, escritura, ambas).
• Recursos: a qué tablas tiene acceso (clientes, productos, etc.).
• Expira: opcional. Por defecto no expira.

4. Click en Generar. 5. Copiá el token YA — solo se muestra una vez.

Usar el token

bash curl https://app.mtrpymes.com.ar/api/v1/clientes \ -H "Authorization: Bearer TU_TOKEN_AQUI"

Buenas prácticas

• Nunca lo pegues en código que va a un repo público.
• Usalo via env var en tu sistema (MTR_API_TOKEN).
• Generá tokens distintos por integración (no reutilices).
• Si sospechás que se filtró, revocá ya desde API Tokens y generá uno nuevo.

Endpoints disponibles

Documentación completa en /docs/api. Endpoints comunes:

• GET /api/v1/clientes — listar clientes.
• POST /api/v1/clientes — crear.
• GET /api/v1/productos — listar productos.
• POST /api/v1/movimientos — cargar movimientos contables.
• POST /api/v1/leads — crear leads.

Rate limits

Por token: 100 requests/min. Si superás, recibís 429 Too Many Requests. Esperá y reintentá.

Webhooks

Para recibir eventos de MTR (ej. "se creó una factura", "llegó un mensaje al bot"), configurá webhooks en Configuración → Webhooks. Te mandamos POST a tu URL con payload JSON.

Soporte para integradores

Si necesitás un endpoint que no está disponible o tenés casos complejos, escribinos. Tenemos plantillas de integración para los ERPs más comunes y podemos asistir en proyectos custom.