Requisitos previos
Para poder seguir esta guía, primero necesitarás:
- Obtener un access_token de Afip SDK
- Tener un proyecto Next.js generado con v0
- Definir el CUIT que vas a usar
- Elegir el Web Service ID, por ejemplo
wsfepara factura electrónica
1. Configuración
v0 puede generar la UI y el código de Next.js. Para Afip SDK, la parte importante es que el access token quede en una variable de entorno privada y que la llamada se haga desde un Route Handler o Server Action.
.env.local
AFIPSDK_ACCESS_TOKEN=TU_ACCESS_TOKEN
AFIPSDK_TAX_ID=20409378472
AFIPSDK_WSID=wsfe
2. Crear la integración en v0
Pedile a v0 que genere una página y una ruta backend. El componente puede ser cliente para manejar el formulario, pero la llamada a Afip SDK debe vivir en /api/afipsdk/web-service.
Prompt
Creá una app Next.js para integrar un web service de ARCA usando Afip SDK.
UI:
- Página simple con título "Consulta de Web Service ARCA".
- Formulario con CUIT, ambiente dev/prod y Web Service ID.
- Textarea para cargar el payload JSON del método que se va a ejecutar.
- Botón para ejecutar la consulta.
- Estados de loading, resultado y error.
- Validación visual si el JSON ingresado es inválido.
Backend:
- Crear un Route Handler en /api/afipsdk/web-service.
- El Route Handler debe leer process.env.AFIPSDK_ACCESS_TOKEN.
- No usar variables NEXT_PUBLIC_ para secrets.
- Primero llamar a 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 devueltos por Afip SDK para ejecutar el método del web service elegido según la documentación oficial.
- Devolver el resultado al frontend sin exponer AFIPSDK_ACCESS_TOKEN.
Variables de entorno:
- AFIPSDK_ACCESS_TOKEN: access token de Afip SDK.
- AFIPSDK_TAX_ID: CUIT por defecto, opcional.
- AFIPSDK_WSID: Web Service ID por defecto, opcional.
Reglas:
- No hardcodees credenciales.
- No expongas secrets al navegador.
- No inventes endpoints ni estructuras de respuesta.
- Usá la documentación oficial:
- 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 Route Handler creado ya podés realizar llamadas a los Web Services que necesites.
Si el Web Service que necesitás no se encuentra en la lista de la documentación, podés llamarlo siguiendo esta guía:
También podés usar las guías del blog de Afip SDK para v0:
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
Guía paso a paso
Y luego agregá el certificado y la key como variables de entorno privadas.
.env.local
AFIPSDK_CERT=-----BEGIN CERTIFICATE-----...
AFIPSDK_KEY=-----BEGIN RSA PRIVATE KEY-----...
Prompt adicional
Actualizá el Route Handler /api/afipsdk/web-service para soportar certificado propio.
Reglas:
- Leer AFIPSDK_CERT y AFIPSDK_KEY desde variables de entorno privadas.
- No usar NEXT_PUBLIC_ para cert, key ni access token.
- Al llamar a POST /api/v1/afip/auth, incluir cert y key en el body si existen.
- Mantener el frontend sin acceso a secrets.