Requisitos previos
Para poder seguir esta guía, primero necesitarás:
- Obtener un access_token de Afip SDK
- Tener instalado Supabase CLI
Básicos
Para usar los Web Services de ARCA, vamos a utilizar la API de Afip SDK.
En la documentación de la API podés consultar todos los parámetros del endpoint.
1. Instalación
Creá una nueva funcion en tu proyecto con el comando
supabase functions new afipSDK
Agregá el access token de AfipSDK como secreto de tu proyecto.
Terminal
supabase secrets set AFIPSDK_ACCESS_TOKEN=TU_ACCESS_TOKEN
2. Obtener el Ticket de Acceso (TA)
Antes de llamar a los Web Services de ARCA, necesitás un ticket de acceso (TA), también llamado Token Authorization.
Este TA expira tras un tiempo, pero no tenés que preocuparte por renovarlo: Afip SDK lo cachea y solicita uno nuevo automáticamente si es necesario. Solo llamá a la API y Afip SDK te devuelve el TA correspondiente.
Para obtener el TA se necesita un certificado digital, pero con Afip SDK podés empezar en modo desarrollo usando el CUIT 20-40937847-2 sin necesidad de uno.
Si preferís usar tu propio certificado, al final te mostramos cómo.
supabase/functions/afipSDK/index.ts
const accessToken = Deno.env.get('AFIPSDK_ACCESS_TOKEN');
Deno.serve(async (_req: Request) => {
const authResponse = await fetch('https://app.afipsdk.com/api/v1/afip/auth', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
environment: 'dev',
tax_id: '20409378472', // CUIT a utilizar
wsid: 'wsfe',
}),
});
const { token, sign } = await authResponse.json();
// Tu llamada al Web Service aqui
});
token y sign corresponden el TA que nos da ARCA. Debemos enviar estos datos en el body de cada solicitud a los Web Services. En el manual de cada Web Service verás dónde colocarlos.
3. Llamar al método del Web Service que necesites
Con el TA ya podés realizar las llamadas a los Web Services que necesites.
Es similar al código para obtener el TA, pero debés cambiar la URL y el body de la request.
Podés encontrar las URLs y los body correspondientes en las pestañas API de la documentación de cada Web Service.
Si el Web Service que necesitás no se encuentra en la lista de la documentación, podés llamarlo siguiendo esta guía:
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
Agregá los secrets desde la terminal de Git Bash:
Git Bash
supabase secrets set AFIP_CERT="$(base64 -w 0 certificado.crt)"
supabase secrets set AFIP_KEY="$(base64 -w 0 key.key)"
Para probar en local deberás crear un archivo .env.local dentro de la carpeta functions y pegar el contenido del .cert y .key en base64.
En la consola ejecutaremos este comando para copiar el valor al portapapeles:
Git Bash
base64 -w 0 afip-cert.crt | clip
base64 -w 0 afip-key.key | clip
Linux
base64 -w 0 afip-cert.crt | xclip -selection clipboard
base64 -w 0 afip-key.key | xclip -selection clipboard
Y luego los leemos desde las variables de entorno en la función:
supabase/functions/afipSDK/index.ts
// Certificado y Key almacenados como secrets del proyecto en formato base64
const cert = atob(Deno.env.get('AFIP_CERT'));
const key = atob(Deno.env.get('AFIP_KEY'));
const accessToken = Deno.env.get('AFIPSDK_ACCESS_TOKEN');
const authResponse = await fetch('https://app.afipsdk.com/api/v1/afip/auth', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
environment: 'dev',
tax_id: '20409378472', // CUIT del certificado
wsid: 'wsfe',
cert,
key,
}),
});