Vektra gestiona el certificado, el ticket de acceso de ARCA y la comunicación con el web service. Vos enviás un JSON y recibís el CAE cuando ARCA autoriza, con el enlace para ver y descargar el comprobante.
Arquitectura simplificada
Integrar los web services de ARCA por cuenta propia implica semanas de desarrollo y mantener la parte criptográfica y los reintentos.
El camino complejo y propenso a errores
Un JSON, y Vektra se ocupa del resto
request_id para pedir ayuda.Ejemplos para copiar
# 201: autorizada. 200: ya existía (misma referencia). 422 con "pendiente": true: ARCA no respondió;
# no la mandes con otra referencia, repetí el pedido con la misma o consultala más tarde.
curl -X POST "https://erp.vektra.digital/api/v1/facturas" \
-w "\nHTTP %{http_code}\n" \
-H "Authorization: Bearer TU_CLAVE_DE_API" \
-H "Content-Type: application/json" \
-d '{
"referencia": "pedido-1289",
"cliente": {
"documento": "38459201",
"razonSocial": "Juan Pérez",
"condicionIva": 5,
"email": "juan.perez@example.com"
},
"renglones": [
{
"descripcion": "Producto de ejemplo",
"cantidad": 1,
"precioUnitario": 150000,
"iva": 21
}
],
"autorizar": true,
"enviar": true
}'Generás la clave de API en tu cuenta de Vektra. Con autorizar: false la factura queda como borrador, y con referencia repetir el pedido devuelve la misma factura en lugar de crear otra. Si ARCA no responde, la API contesta 422 con "pendiente": true: el comprobante queda en espera y no se emite dos veces. Para probar sin valor fiscal hace falta el certificado de homologación de ARCA de tu empresa (se tramita aparte del de producción): no hay un modo de prueba sin certificado.
Funcionalidades técnicas
El comprobante autorizado lleva el QR que exige ARCA (RG 5025), y lo ves y lo descargás desde el enlace que devuelve la API.
Se descarga por API y, con enviar: true, se le manda por correo al cliente.
Mandá la cabecera Idempotency-Key (o un campo referencia propio). Si tu conexión falla y reintentás el pedido, te devuelve la misma factura sin duplicarla; con la misma clave y otro contenido responde 422, y con el punto de venta ocupado, 503 con Retry-After.
Enviás el documento del cliente: si no existe se da de alta y, con un CUIT, se completan sus datos desde el padrón de ARCA. También podés consultar el padrón, dar de alta clientes y buscar una factura por su CAE o su número.
Factura de Crédito Electrónica MiPyME cuando el punto de venta es de FCE, factura de exportación E (bienes, servicios y otros; para inscriptos, monotributistas y exentos; se prueba primero en homologación con tu certificado) y notas de crédito o de débito sobre una factura ya emitida.
Recibís avisos cuando algo cambia, firmados con HMAC, con reintentos. Una clave por sistema, que se revoca sin afectar a las demás.
Emitís facturas, notas de crédito y FCE con CAE de ARCA, consultás comprobantes y recibís avisos firmados (HMAC) cuando algo cambia. Si ya usás el ERP, la API también viene incluida en el plan Pro y Empresa y se suma al plan Pyme o superior por $ 21.900 al mes + IVA.
Para integrar y probar sin pagar: claves, documentación y 500 comprobantes por mes.
Gratis
sin vencimiento
Para probar la integración
Sin tarjeta de crédito · No vence
Para apps, tiendas online y facturación desatendida.
$29.90024.917
por mes + IVA
$ 299.000 por año: 2 meses de regalo
Sin tarjeta de crédito · Activación inmediata
Para negocios con volumen sostenido y varias sucursales.
$64.90054.083
por mes + IVA
$ 649.000 por año: 2 meses de regalo
Sin tarjeta de crédito · Activación inmediata
Para empresas con gran volumen de facturación.
$119.90099.917
por mes + IVA
$ 1.199.000 por año: 2 meses de regalo
Sin tarjeta de crédito · Activación inmediata
Para plataformas y software que facturan a gran escala.
$189.900158.250
por mes + IVA
$ 1.899.000 por año: 2 meses de regalo
Sin tarjeta de crédito · Activación inmediata
Empezás en el plan API Pruebas (gratis, no vence) y subís de plan desde Configuración → Suscripción. No hay permanencia.
La API factura con el certificado de ARCA de tu empresa, incluso para probar (la homologación de ARCA pide un certificado propio). Cada clave es de solo lectura o de lectura y escritura y actúa con los permisos de quien la creó. Cada CUIT es una empresa de Vektra, con su propia suscripción, sus claves y su certificado.
Preguntas frecuentes
Creá tu cuenta, conectá el certificado de ARCA de tu empresa y generá tu clave de API: tenés 15 días de prueba, sin tarjeta.