Skip to main content
Este quickstart te guía desde tener una cuenta hasta hacer la primera llamada autenticada al API. Para emitir una factura de prueba end-to-end mirá el tutorial de emisión de factura.

​
1. Pre-requisitos

Antes de empezar necesitás:
  • Cuenta en el panel de e-Miti (emiti.fravelabs.com).
  • Certificado digital vigente del emisor cargado en la plataforma (obligatorio por SIFEN).
  • Punto de expedición dado de alta, configurado en ambiente Homologación para las primeras pruebas.

​
2. Generar una API key

  1. Iniciá sesión en el panel.
  2. Andá a Configuración → API Keys.
  3. Hacé clic en Crear API Key, ponele un nombre descriptivo (erp-staging, pos-tienda-1, etc.).
  4. Copiá la clave que aparece en el modal. Empieza con el prefijo emiti_k_.
La clave se muestra una sola vez. Si la perdés tenés que generar otra — la BD solo guarda el hash, no el valor original.

​
3. Autenticación

Todas las llamadas al API requieren el header Authorization con scheme ApiKey:

​
4. Verificar que la clave funciona

Llamá a GET /health. Es público (no requiere auth), pero te sirve para confirmar que tu cliente HTTP llega al API correctamente.
Response esperada:
Para confirmar que tu clave es válida, llamá a cualquier endpoint autenticado — por ejemplo, listar los departamentos del catálogo:
Si la clave es válida, recibís 200 con el listado de departamentos. Si es inválida o falta, recibís el error estándar con código AUTH_APIKEY_INVALIDA y status 401. Los códigos de establecimiento y punto de expedición se configuran en el panel (Configuración → Sucursales). Necesitarás esos códigos al emitir documentos — los valores son de 3 dígitos, por ejemplo "001".

​
5. Shape de error

Todas las respuestas de error siguen el mismo formato:
  • codigo — identificador estable, usalo para lógica de cliente. Ver Códigos de error SIFEN para la lista completa.
  • mensaje — texto en español, pensado para mostrar al usuario final.
  • request_id — incluilo cuando reportes un problema; nos permite encontrar el trace en logs.
Algunos errores incluyen un campo extra con contexto adicional (ej. codigo_sifen, cdc, errores[] para validaciones).

​
Próximos pasos

Conceptos básicos

DE, CDC, ambientes y flujo asíncrono — la base antes de emitir.

Tutorial: emitir factura

Emitir una factura completa desde cURL, con variantes (CF, contribuyente, crédito, USD).