Arca.rb

Cliente Ruby para integrar webservices SOAP de AFIP y ARCA en Argentina. Soporta facturación electrónica (WSFE), factura electrónica de crédito MiPyMEs (WSFeCred), autenticación WSAA, consulta de padrón de contribuyentes, constatación de comprobantes fiscales y todos los servicios tributarios de la API de AFIP. Ideal para aplicaciones Rails que necesitan generar facturas electrónicas y comprobantes en Argentina.

• Facturación Electrónica (WSFE) - Generá facturas, notas de crédito y débito
• Factura Electrónica de Crédito MiPyMEs (WSFeCred) - FEC para PyMEs
• Comprobantes AFIP - Acceso completo a todos los webservices ARCA
• SOAP simplificado - API Ruby idiomática sobre los servicios SOAP de AFIP
• Autenticación WSAA - Manejo automático de tokens y certificados
• Producción y homologación - Ambientes configurables
• Padrón AFIP - Consulta de contribuyentes (A4, A5, A100)

• Ruby >= 3.3.4
• Clave privada y certificado de ARCA/AFIP: seguí los pasos para solicitar certificado

Agregá a tu Gemfile:

gem 'arca.rb'

Ejecutá bundle install. O instalá directamente: gem install arca.rb.

1. Obtené certificado y clave de ARCA/AFIP (ver link arriba). Vas a tener un .crt (certificado) y una clave privada (.key o .pem).

2. **Instalá la ** y requerila:

   require 'arca'

3. Elegí el ambiente: usá :development (homologación) para testing, :production para operaciones reales.

4. Creá un cliente con tu CUIT, clave y certificado, después llamá al servicio:

   ws = Arca::WSFE.new(
     env: :development,
     cuit: '20123456789',
     key: File.read('ruta/a/clave-privada.key'),
     cert: File.read('ruta/a/certificado.crt')
   )
   puts ws.cotizacion('DOL')  # cotización dólar

Opción del constructor: env: :development o env: :production (symbol o string). Por defecto es :test.

Opciones comunes del constructor: env, cuit, key, cert. Opcionales: savon (hash pasado a Savon), ta_path (WSAA), etc.

Arca::Client es el cliente SOAP base que envuelve Savon. Las clases de servicio de alto nivel (WSFE, WSAA, etc.) se construyen sobre este. Podés usarlo directamente para WSDLs custom o llamadas SOAP raw.

Constructor: Arca::Client.new(savon_options) — acepta cualquier opción de cliente Savon. Las opciones se combinan con estos defaults (necesarios para AFIP/ARCA):

Métodos:

• request(action, body = nil) — Envía un request SOAP para la action dada con body opcional. Levanta Arca::ServerError en errores SOAP/HTTP, Arca::NetworkError en timeouts (connect timeouts se marcan retriable: true).
• operations — Delegado al cliente Savon; devuelve la lista de operaciones SOAP disponibles del WSDL.

Ejemplo (WSDL custom):

client = Arca::Client.new(
  wsdl: 'https://example.afip.gov.ar/ws/MiServicio?wsdl',
  wsse_auth: ['ruta/a/cert.crt', 'ruta/a/key.pem']
)
client.operations  # => lista de operaciones
response = client.request(:mi_operacion, { key: 'valor' })

Token y sign son usados internamente por otros servicios; podés llamar WSAA directamente si lo necesitás:

wsaa = Arca::WSAA.new(env: :development, cuit: '20123456789', key: key, cert: cert)
auth = wsaa.auth  # => { token: '...', sign: '...' }

ws = Arca::WSFE.new(env: :development, cuit: '20123456789', key: key, cert: cert)
ws.dummy                    # verificación de conectividad
ws.cotizacion('DOL')        # cotización moneda
ws.tipos_comprobantes       # tipos de comprobante
ws.ptos_venta               # puntos de venta
# ... fe_comp_ultimo_autorizado, fecae_solicitar, etc.

ws = Arca::WSFeCred.new(env: :development, cuit: '20123456789', key: key, cert: cert)
ws.dummy
ws.consultar_tipos_retenciones
ws.consultar_cta_cte(id_cta_cte)
# ... aceptar_f_e_cred, rechazar_f_e_cred, etc.

ws = Arca::WSCDC.new(env: :development, cuit: '20123456789', key: key, cert: cert)
ws.dummy
ws.comprobante_constatar(
  cbte_modo: 1, 
  cuit_emisor: '...', 
  pto_vta: 1, 
  cbte_tipo: 1, 
  cbte_nro: 1, 
  cbte_fch: '20250101', 
  imp_total: 100.0, 
  cod_autorizacion: '...'
)

ws = Arca::WSRGIVA.new(env: :development, cuit: '20123456789', key: key, cert: cert)
ws.dummy
ws.consultar_constancia_por_lote(['20123456789', '20999888777'])

# Padrón A5
padron = Arca::PersonaServiceA5.new(env: :development, cuit: '20123456789', key: key, cert: cert)
padron.get_persona('20123456789')
# A4: PersonaServiceA4, A100: PersonaServiceA100 (tipos de sociedad, jurisdicciones, etc.)

ws = Arca::WSConstanciaInscripcion.new(env: :development, cuit: '20123456789', key: key, cert: cert)
ws.get_persona('20123456789')

ws = Arca::WConsDeclaracion.new(cuit: '20123456789', key: key, cert: cert, env: :development)
ws.dummy
ws.detallada_lista_declaraciones(fecha_oficializacion_desde: Date.new(2025, 1, 1))
ws.detallada_estado('identificador')

Mirá test/ para más ejemplos.

Si preferís una API REST en lugar de trabajar directamente con SOAP, probá Arca Kit — nuestro servicio hosteado (y también de código abierto y libre para te lo instales donde quieras) que cubre todos los webservices de AFIP con una API facilonga, webhooks y multi tenancy.

Usá el devcontainer: abrí este repo en tu IDE y elegí Reopen in Container. El container ejecuta bundle install y el test suite después de crearse.

Después ejecutá los tests:

bundle exec rake test

O bundle exec rake (la task default ejecuta tests).

CI: cada push corre tests en GitHub Actions. Para publicar en RubyGems se usa el action oficial rubygems/release-gem con Trusted Publishing; ver CONTRIBUTING.md para los pasos.

Si encontrás un bug o tenés una sugerencia para mejorar arca.rb, por favor abrí un issue en GitHub. Tu feedback nos ayuda a mejorar la gema para toda la comunidad.

ARCA usa licencia MIT.

Versión original de esta gem: https://github.com/eeng/afipws/