Cloudflare Workers

Aprendé cómo usar Afip SDK con Cloudflare Workers.

Requisitos previos

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

• Obtener un access_token de Afip SDK

• Tener instalado Wrangler CLI

1. Instalación

Creá un nuevo Worker con Wrangler e instalá la librería de Afip SDK.

Terminal

npm create cloudflare@latest afipsdk
cd afipsdk
npm install @afipsdk/afip.js

Agregá el access token de AfipSDK como secreto del Worker.

Terminal

wrangler secret put AFIPSDK_ACCESS_TOKEN

Luego modificá el archivo worker-configuration.d.ts.

Terminal

interface Env {
		AFIPSDK_ACCESS_TOKEN: string;
		//AFIP_CERT: string;
		//AFIP_KEY: string;
	}

2. Crear una instancia de la clase Afip

Para usar los Web Services de ARCA 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.

src/index.ts

import Afip from '@afipsdk/afip.js';

let afip: Afip;

export default {
	async fetch(request: Request, env: Env): Promise<Response> {
		if (!afip) {
			afip = new Afip({
				CUIT: 20409378472,
				access_token: env.AFIPSDK_ACCESS_TOKEN,
			});
		}

		// Tu llamada de afipSDK aqui
	},
};

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

Con la instancia creada ya podés realizar las 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

---

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

Para agregar los secrets primero debemos obtener el valor de .cert y .key en base64 (guardalo ya que se nos pedirá luego). 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

Asignar el valor obtenido en su correspondiente secret:

Terminal

wrangler secret put AFIP_CERT
wrangler secret put AFIP_KEY

Luego los leemos desde el parámetro env en la función:

src/index.ts

import Afip from '@afipsdk/afip.js';

let afip: Afip;

export default {
	async fetch(request: Request, env: Env): Promise<Response> {
		if (!afip) {
			// Certificado y Key almacenados como secrets del Worker
			afip = new Afip({
				cert: atob(env.AFIP_CERT),
				key: atob(env.AFIP_KEY),
				CUIT: 20111111112,
				access_token: env.AFIPSDK_ACCESS_TOKEN, // Obtenido de https://app.afipsdk.com
			});
		}
	},
};