En esta documentación

Aprendé cómo usar Afip SDK con Replit para integrar web services de ARCA.


Requisitos previos

Para poder seguir esta guía, primero necesitarás:

1. Configuración

En Replit, guardá las credenciales en Secrets. El backend puede leerlas desde process.env, pero el frontend no debe recibirlas ni imprimirlas.

Secrets

AFIPSDK_ACCESS_TOKEN=TU_ACCESS_TOKEN
AFIPSDK_TAX_ID=20409378472
AFIPSDK_WSID=wsfe

2. Crear la integración en Replit

Pedile a Replit que use el stack actual del proyecto. Si no hay backend, conviene pedir uno simple con Node.js y Express para que la integración quede fácil de revisar.

Prompt

Integrá un web service de ARCA usando Afip SDK en este proyecto de Replit.

Usá el stack actual del proyecto. Si no hay backend, creá uno simple con Node.js y Express.

Necesito:
- Un secret llamado AFIPSDK_ACCESS_TOKEN.
- Una variable opcional AFIPSDK_TAX_ID para el CUIT por defecto.
- Una variable opcional AFIPSDK_WSID para el Web Service ID por defecto.
- Un endpoint backend /api/afipsdk/web-service.
- Una UI simple para ejecutar la consulta y ver el resultado JSON.

Endpoint backend:
- Leer AFIPSDK_ACCESS_TOKEN desde process.env.
- Recibir environment, tax_id, wsid y payload desde el frontend.
- Validar que existan AFIPSDK_ACCESS_TOKEN, tax_id y wsid.
- Hacer POST https://app.afipsdk.com/api/v1/afip/auth.
- Enviar Authorization: Bearer TU_ACCESS_TOKEN.
- Enviar body JSON con environment, tax_id y wsid.
- Usar token y sign de la respuesta para llamar al método del web service elegido según la documentación oficial.
- Devolver al frontend el resultado final.
- Devolver errores claros si falta el token, falta CUIT, falta wsid o Afip SDK responde error.

Reglas:
- No pongas el token en archivos del repo.
- No expongas secrets al frontend.
- No imprimas AFIPSDK_ACCESS_TOKEN en logs.
- No inventes campos de Afip SDK.
- Usá esta documentación:
  - https://afipsdk.com/docs/web-services/integracion/api/
  - https://afipsdk.com/docs/web-services/siguientes-pasos/web-services/
  - https://afipsdk.com/docs/web-services/siguientes-pasos/web-services/otro-web-service/
  - https://afipsdk.com/docs/web-services/catalogo/

3. Llamar al método del Web Service que necesites

Con el endpoint creado ya podés realizar llamadas a los Web Services que necesites.

Web services

Si el Web Service que necesitás no se encuentra en la lista de la documentación, podés llamarlo siguiendo esta guía:

Otro web service

También podés usar las guías del blog de Afip SDK para Replit:


Usar tu propio certificado (Opcional)

Primero, obtenemos el certificado siguiendo esta guía.

Obtener el certificado para conectar tu sistema con los web services de ARCA

Obtener el certificado para conectar tu sistema con los web services de ARCA

Guía paso a paso

Y luego agregá el certificado y la key como Secrets de Replit.

Secrets

AFIPSDK_CERT=-----BEGIN CERTIFICATE-----...
AFIPSDK_KEY=-----BEGIN RSA PRIVATE KEY-----...

Prompt adicional

Actualizá el endpoint /api/afipsdk/web-service para soportar certificado propio.

Reglas:
- Leer AFIPSDK_CERT y AFIPSDK_KEY desde process.env.
- No imprimir cert, key ni access token en logs.
- Al llamar a POST /api/v1/afip/auth, incluir cert y key en el body si existen.
- Mantener el frontend sin acceso a secrets.