API REST v1
API de facturación electrónica ARCA (ex AFIP) y de todo tu ERP
Creá una venta y facturala en ARCA con un solo POST en JSON. Y desde la misma API, manejá productos, precios, stock, clientes, pedidos y recibos.
Qué podés hacer con la API REST
Factura con CAE en un POST
POST /sales con el bloque invoice crea la venta y emite el comprobante en ARCA. También podés facturar una venta existente o emitir un comprobante directo, validado contra las reglas de ARCA (condición de IVA del receptor incluida).
Todo el negocio, no solo la factura
Productos con precios por lista y stock por depósito, clientes, ventas y presupuestos, pedidos y remitos, recibos, y reportes, contabilidad y tesorería de solo lectura.
Reintentos seguros
Idempotency-Key es obligatoria en las escrituras que mueven plata o stock. Misma clave y mismo cuerpo: misma respuesta, con Idempotent-Replayed: true. Vale 24 horas.
Hecha para integrar en serio
OpenAPI 3.1 en /api/v1/docs, ETag e If-Match para no pisar cambios, paginación por cursor, X-Request-Id en cada respuesta y errores application/problem+json (RFC 9457).
Claves con permisos
Scopes por recurso (products, stock, customers, sales, invoices, receipts, reports, accounting, treasury), vencimiento, IPs permitidas y rotación con período de gracia.
Cómo funciona, paso a paso
Paso 1: Creás una API key
Desde Integraciones › API, MCP y webhooks, con los scopes que necesitás. Se muestra una sola vez.
Paso 2: Mirás la especificación
En https://tu-empresa.minegon.com/api/v1/docs tenés la documentación y el OpenAPI en /api/v1/openapi.json.
Paso 3: Hacés tu primer request
Authorization: Bearer con tu clave y JSON en el cuerpo. Las escrituras llevan Idempotency-Key.
Paso 4: Escuchás los cambios
Sumá webhooks para enterarte de ventas, facturas autorizadas y cobros sin consultar a cada rato.
Crear una venta y facturarla en ARCA
Un POST /sales con el bloque invoice crea la venta, descuenta stock, registra el cobro y emite el comprobante. Si reintentás con la misma Idempotency-Key recibís la misma respuesta; con la misma externalReference, la venta existente con duplicated: true.
curl -X POST https://tu-empresa.minegon.com/api/v1/sales \
-H "Authorization: Bearer $MINEGON_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 5f1c2a8e-3b7d-4c1e-9a2b-7e0f6d4c3b21" \
-d '{
"externalReference": "pedido-1042",
"customer": { "name": "Ana", "docNumber": "27287654321" },
"items": [{ "sku": "CAS-001", "quantity": 1 }],
"payments": [{ "method": "transfer", "amount": 58000 }],
"invoice": {}
}'// La Idempotency-Key se guarda con el pedido: si la red se corta y
// reintentás, mandás LA MISMA y no se duplica la venta ni la factura.
const res = await fetch('https://tu-empresa.minegon.com/api/v1/sales', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.MINEGON_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': pedido.idempotencyKey,
},
body: JSON.stringify({
externalReference: pedido.id,
customer: { name: pedido.cliente, docNumber: pedido.cuit },
items: pedido.items.map((i) => ({ sku: i.sku, quantity: i.cantidad })),
payments: [{ method: 'transfer', amount: pedido.total }],
invoice: {}, // emisor y punto de venta por defecto de la cuenta
}),
})
if (!res.ok) throw new Error((await res.json()).detail) // RFC 9457
const { data, invoice, invoiceError } = await res.json()
console.log(data.id, invoice?.fullNumber, invoice?.cae, invoiceError)Medios de pago: cash, debit_card, credit_card, transfer, qr, mercadopago, modo, account, store_credit y other. Los precios de los ítems son opcionales: si no van, se usa la lista del cliente o el precio base.
Para quién sirve
Tienda online propia
Tu checkout crea la venta y la factura en ARCA con una llamada; el stock de Minegon queda al día.
Software de turnos, cursos o servicios
Facturás cada cobro desde tu sistema sin integrarte con el SOAP de ARCA ni manejar certificados.
Distribuidora con app de preventa
Los vendedores cargan pedidos desde su app y la API los crea como pedidos con remito.
Estudio contable o BI
Leés ventas, comprobantes, balance de sumas y saldos y movimientos de tesorería para tus tableros.
En qué planes está
Sin costo extra: viene incluida según el plan. Todos los planes se prueban 14 días gratis.
| Plan | Qué incluye | Precio mensual |
|---|---|---|
| Facturación Pro |
5.000 requests/mes (API + MCP) | $55.900 final |
| POS Cadena |
100.000 requests/mes (API + MCP) | $78.900 final |
| ERP Crecimiento |
100.000 requests/mes (API + MCP) | $133.900 + IVA |
| ERP Empresa |
500.000 requests/mes (API + MCP) | $280.900 + IVA |
Con un POS, sumando el complemento de Facturación
- POS Kiosco + Facturación Pro: API REST v1 (cuota compartida con el MCP)
- POS Comercio + Facturación Pro: API REST v1 (cuota compartida con el MCP)
Además de la cuota mensual del plan, cada clave admite hasta 120 requests por minuto (compartidos entre la API y el MCP); al pasarte, la respuesta es 429 con Retry-After.
Preguntas frecuentes sobre API REST
¿Qué es una API de factura electrónica ARCA (ex AFIP)?
Es una forma de emitir comprobantes electrónicos desde tu propio sistema: le mandás los datos de la venta en JSON y recibís el comprobante autorizado con su CAE. Minegon además guarda la venta, el cliente y el stock, así que no tenés que llevar eso aparte.
¿Cómo obtengo el CAE desde mi sistema?
Con POST /sales incluyendo invoice, POST /sales/{id}/invoice para facturar una venta que ya existe, o POST /invoices para un comprobante directo. La respuesta trae el comprobante con cae, caeExpiration y su número completo; si ARCA lo rechaza, el motivo viene en invoiceError o en el error de la respuesta.
¿Qué comprobantes puedo emitir?
Facturas, notas de débito y de crédito y recibos, según lo que habilite tu condición fiscal y tu plan (A, B, C y, en los planes que la incluyen, E). Cada comprobante se valida con las reglas vigentes de ARCA antes de pedir el CAE.
¿Además de facturar, puedo manejar stock, clientes y productos?
Sí: es la API del ERP. Creás y actualizás productos y sus precios, ajustás stock por depósito, das de alta clientes, consultás ventas y pedidos, generás remitos y registrás recibos. Reportes, contabilidad y tesorería son de solo lectura.
¿Qué límites tiene y cómo se pagina?
Cada clave admite 120 requests por minuto y la cuenta tiene una cuota mensual compartida con el MCP: Facturación Pro (5.000 requests/mes), POS Cadena (100.000 requests/mes), ERP Crecimiento (100.000 requests/mes), ERP Empresa (500.000 requests/mes). Los listados se paginan por cursor (limit hasta 100, meta.next_cursor) y los GET devuelven ETag.
¿Hay un entorno de pruebas?
No hay un sandbox separado: la API trabaja sobre tu cuenta. Para probar sin emitir comprobantes, creá ventas sin el bloque invoice o usá las lecturas. Cuando emitas, los comprobantes salen en ARCA con tu punto de venta.
Información verificada el 07/10/2026.
Probalo con tu negocio
Usá API REST 14 días gratis con tus datos. Si te trabás, una persona del equipo te ayuda a conectarlo.