Bolt.new

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

Requisitos previos

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

• Obtener un access_token de Afip SDK

• Tener un proyecto creado en Bolt.new

• Definir el CUIT que vas a usar

• Elegir el Web Service ID, por ejemplo wsfe para factura electrónica

1. Configuración

En Bolt.new, primero pedí que detecte el stack del proyecto. Después indicá que la integración debe vivir en backend, server routes, API routes o serverless functions.

Configurá estas variables como secrets privados del proyecto:

Secrets

AFIPSDK_ACCESS_TOKEN=TU_ACCESS_TOKEN
AFIPSDK_TAX_ID=20409378472
AFIPSDK_WSID=wsfe

Si el builder intenta llamar a Afip SDK directamente desde el frontend, pedile que mueva esa lógica a una ruta backend antes de seguir.

2. Crear la integración en Bolt.new

Usá este prompt para que Bolt.new detecte el stack y cree una ruta backend compatible con el proyecto.

Prompt

Agregá una integración con un web service de ARCA usando Afip SDK a esta app de Bolt.new.

Primero detectá el stack del proyecto y explicá brevemente dónde vas a ubicar la ruta backend. Después implementá la integración siguiendo estas reglas:

Funcionalidad:
- Crear una pantalla mínima para probar el web service.
- La pantalla debe permitir configurar CUIT, ambiente dev/prod, Web Service ID y payload JSON.
- El frontend solo puede llamar a nuestro backend, nunca a Afip SDK directamente con el token.
- El backend debe leer AFIPSDK_ACCESS_TOKEN desde secrets o variables de entorno.
- Para obtener el Ticket de Acceso, 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 para llamar al método del web service elegido según la documentación oficial.
- Mostrar errores de configuración y errores de la API.

Reglas:
- No inventes endpoints, campos ni respuestas.
- No hardcodees credenciales.
- No imprimas AFIPSDK_ACCESS_TOKEN en logs.
- Usá la documentación oficial antes de escribir código:
  - https://docs.afipsdk.com/integracion/api
  - https://docs.afipsdk.com/siguientes-pasos/web-services/
  - https://docs.afipsdk.com/siguientes-pasos/web-services/otro-web-service
  - https://afipsdk.com/docs/api-reference/introduction/

Si el proyecto no tiene backend, creá una función serverless o route handler compatible con el framework actual.

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

Con la ruta backend creada 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

Podés usar la referencia de la API para obtener ejemplos de cómo usar los métodos de todos los web services de ARCA.

Referencia de APIafipsdk.com

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

https://afipsdk.com/blog/category/Bolt.new/afipsdk.com

---

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 ARCAafipsdk.com

Y luego pedile a Bolt.new que lea el certificado y la key desde secrets privados.

Prompt adicional

Actualizá la integración de Afip SDK para soportar certificado propio.

Reglas:
- Leer AFIPSDK_CERT y AFIPSDK_KEY desde secrets privados.
- No enviar cert, key ni AFIPSDK_ACCESS_TOKEN al frontend.
- Al llamar a POST /api/v1/afip/auth, incluir cert y key en el body si existen.
- Mantener la misma ruta backend que ya creaste para la integración.