API v1 · OpenAPI 3.1

La API de Vektra, documentada y con claves de prueba

Facturación electrónica con ARCA, clientes, catálogo, pedidos de tienda, servicio técnico y entregas. La referencia se genera desde los mismos esquemas con que el servidor valida cada pedido.

Documentación interactiva Descargar openapi.json

Claves de prueba (sandbox)

Una clave erp_test_… valida el pedido con las mismas reglas que producción y devuelve una factura simulada, con un CAE que empieza con 99. No llega a ARCA ni a tu contabilidad, no manda correos y se borra a los 7 días. Todo lo que no sea facturas responde 403. No reemplaza la homologación: para probar contra ARCA se usa tu certificado.

Reintentos sin duplicar

Mandá la cabecera Idempotency-Key (o una referencia): si reintentás tras un corte, recibís la misma factura en lugar de una nueva. Funciona igual en producción y en el sandbox.

Errores que se pueden programar

Todo error trae code, el campo que falló y un request_id para soporte. Cada respuesta informa el cupo restante de pedidos por minuto en X-RateLimit-*.

Ejemplo: simular una factura con una clave de prueba

POST /api/v1/facturas

curl -X POST "$VEKTRA_URL/api/v1/facturas" \
  -H "Authorization: Bearer $VEKTRA_CLAVE_PRUEBA" \
  -H "Idempotency-Key: orden-10492" \
  -H "Content-Type: application/json" \
  -d '{
  "cliente": {
    "documento": "30999176522",
    "razonSocial": "Clínica del Litoral S.A.",
    "condicionIva": 1
  },
  "renglones": [
    {
      "descripcion": "Abono mensual",
      "cantidad": 1,
      "precioUnitario": 1000,
      "iva": 21
    }
  ]
}'

VEKTRA_URL es la dirección de tu instalación y VEKTRA_CLAVE_PRUEBA una clave creada en Configuración → Integraciones con entorno «Sandbox». Respuesta (resumida):

{
  "estado": "autorizado",
  "sandbox": true,
  "entorno": "sandbox",
  "letra": "A",
  "tipo": 1,
  "puntoVenta": 1,
  "numero": 1,
  "neto": "1000.00",
  "iva": "210.00",
  "total": "1210.00",
  "cae": "99…",
  "enviada": false,
  "ignorados": []
}