> For the complete documentation index, see [llms.txt](https://docs.afipsdk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.afipsdk.com/integracion/ai-builders/bolt-new.md).

# Bolt.new

### Requisitos previos

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

* [Obtener un access\_token de Afip SDK](https://app.afipsdk.com)
* 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:

{% tabs %}
{% tab title="Secrets" %}

```bash
AFIPSDK_ACCESS_TOKEN=TU_ACCESS_TOKEN
AFIPSDK_TAX_ID=20409378472
AFIPSDK_WSID=wsfe
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
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.
{% endhint %}

### 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.

{% tabs %}
{% tab title="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.
```

{% endtab %}
{% endtabs %}

### 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.

{% content-ref url="/pages/mVTz5YrKc8PCEeJKHt0W" %}
[Web services](/siguientes-pasos/web-services.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/4zlCsTNGo99FZGfrhpZn" %}
[Otro web service](/siguientes-pasos/web-services/otro-web-service.md)
{% endcontent-ref %}

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.

{% embed url="<https://afipsdk.com/docs/api-reference/introduction/>" %}

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

{% embed url="<https://afipsdk.com/blog/category/Bolt.new/>" %}

***

### Usar tu propio certificado <sup><sub>(Opcional)<sub></sup>

Primero, obtenemos el certificado siguiendo esta guía.

{% embed url="<https://afipsdk.com/blog/como-obtener-certificado-para-web-services-arca/>" fullWidth="false" %}

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

{% tabs %}
{% tab title="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.
```

{% endtab %}
{% endtabs %}