🧾 ARCA (AFIP) API

📡 API Endpoints

🔐 Cómo Obtener Certificados de AFIP

Requisitos Previos

• CUIT activo
• Clave fiscal nivel 3 o superior
• OpenSSL instalado (viene con Linux/Mac, para Windows usar Git Bash o WSL)

1 Generar Clave Privada y CSR

Abrí una terminal y ejecutá:

# Crear directorio para los certificados
mkdir -p ~/afip-certs && cd ~/afip-certs

# Generar clave privada (GUARDAR ESTE ARCHIVO - ES SECRETO)
openssl genrsa -out private.key 2048

# Generar CSR (Certificate Signing Request)
openssl req -new -key private.key -out request.csr \
  -subj "/C=AR/O=TU_RAZON_SOCIAL/CN=TU_NOMBRE/serialNumber=CUIT TU_CUIT"

Ejemplo real:

openssl req -new -key private.key -out request.csr \
  -subj "/C=AR/O=BAUX SRL/CN=Santiago Herzfeld/serialNumber=CUIT 20123456789"

2 Acceder a AFIP

1. Ir a www.afip.gob.ar
2. Click en "Acceso con clave fiscal"
3. Ingresar CUIT y clave fiscal

3 Administrador de Relaciones de Clave Fiscal

1. En el menú principal, buscar "Administrador de Relaciones de Clave Fiscal"
2. Click en "Adherir Servicio"
3. Buscar: "AFIP → Servicios Interactivos → Administración de Certificados Digitales"
4. Confirmar la adhesión

4 Generar Certificado

1. Volver al menú principal de AFIP
2. Entrar a "Administración de Certificados Digitales"
3. Click en "Agregar Alias / Nuevo Certificado"

Completar el formulario:

Campo	Valor
Alias	Un nombre para identificarlo (ej: facturacion-api)
Nombre del DN	Tu razón social o nombre
CUIT representado	Tu CUIT (sin guiones)
Tipo	Seleccionar "CSR"

En el campo de texto grande, pegar el contenido del archivo request.csr:

cat request.csr

5 Descargar el Certificado

1. El certificado aparecerá en la lista con estado "Activo"
2. Click en "Ver" o "Descargar"
3. Guardar como certificate.crt

6 Verificar los Archivos

# Estos dos comandos deben dar el mismo hash
openssl rsa -noout -modulus -in private.key | openssl md5
openssl x509 -noout -modulus -in certificate.crt | openssl md5

7 Habilitar Servicios Web

1. En AFIP, ir a "Administrador de Relaciones de Clave Fiscal"
2. Click en "Nueva Relación"
3. Buscar: "AFIP → WebServices → Facturación Electrónica"
4. Confirmar

8 Asociar Certificado al Servicio

1. Ir a "Administración de Certificados Digitales"
2. Buscar tu certificado
3. Click en "Relaciones"
4. Agregar relación con "ws - Factura Electrónica"

9 Usar con la API

curl -X POST https://afip.baux.ar/api/accounts \
  -H "Content-Type: application/json" \
  -d '{
    "name": "mi-empresa",
    "cuit": "20123456789",
    "certPath": "./certs/certificate.crt",
    "keyPath": "./certs/private.key",
    "businessName": "MI EMPRESA SRL",
    "address": "Av. Ejemplo 123, CABA",
    "ivaCondition": "Responsable Inscripto",
    "startDate": "01/01/2020",
    "production": false
  }'

📋 Referencias

Tipos de Comprobante

ID	Tipo	Uso
1	Factura A	Ventas a Responsable Inscripto
6	Factura B	Ventas a Consumidor Final (por RI)
11	Factura C	Ventas por Monotributista

Alícuotas de IVA

ID	Alícuota
3	0%
4	10.5%
5	21%
6	27%

Tipos de Documento

ID	Tipo
80	CUIT
86	CUIL
96	DNI
99	Consumidor Final