Guía de migración a Afip SDK ≥ v1.0

Desde antiguas versiones de Afip SDK en PHP y Node

Ivan Muñoz abr 16, 2025

AFIP

Introducción

Esta guía te muestra cómo migrar tus proyectos en PHP y Node.js desde versiones antiguas de Afip SDK a versiones v1.0 o superiores. Veremos los cambios principales en la forma de actualizar la librería, manejar certificados y configurar el entorno de producción con el nuevo sistema de token.

Resumen

• Actualiza tu dependencia de Afip SDK a la última versión.
• Cambia la forma de pasar cert y key: ahora envías el contenido de los archivos.
• Configura tu proyecto para producción agregando el access_token (uso de pago).
• Elimina afip_res y no guardes TA localmente.

1. Actualizar la librería a la última versión

PHP (Composer)

composer require afipsdk/afip.php:^1.0

Node.js (npm)

npm install @afipsdk/afip.js@^1.0

2. Manejo de certificado y clave

En versiones anteriores pasabas el nombre de los archivos y los guardaba en afip_res, pero a partir de v1.0 debes leer el contenido y pasarlo directamente.

Antes (v<1.0)

PHP

$afip = new Afip([
  'cert' => 'nombre.crt',
  'key'  => 'nombre.key'
]);

Node

const afip = new Afip({
  cert: 'nombre.crt',
  key: 'nombre.key'
});

Ahora (v≥1.0)

PHP

// Certificado (Puede estar guardado en archivos, DB, etc)
$cert = file_get_contents('./certificado.crt');

// Key (Puede estar guardado en archivos, DB, etc)
$key = file_get_contents('./key.key');

$afip = new Afip([
  'cert' => $cert,
  'key' => $key
]);

Node

const fs = require('fs');

// Certificado (Puede estar guardado en archivos, DB, etc)
const cert = fs.readFileSync('./certificado.crt', {encoding: 'utf8'});

// Key (Puede estar guardado en archivos, DB, etc)
const key = fs.readFileSync('./key.key', {encoding: 'utf8'});

const afip = new Afip({
  cert: cert,
  key: key
});

3. Configuración para ambiente de producción (uso de pago)

A partir de v1.0, usar Afip SDK en producción requiere un access_token. Sigue la guía oficial: https://docs.afipsdk.com/paso-a-paso/ir-a-produccion

4. Eliminación de afip_res y almacenamiento de TA

A partir de v1.0, ya no necesitas:

• Mantener la carpeta afip_res.
• Guardar localmente los tokens y firmas (TA).

El SDK gestiona la generación y almacenamiento temporal de estos datos.

Conclusión

Con estos pasos habrás migrado satisfactoriamente tus proyectos a la versión v1.0 o superior de Afip SDK en PHP y Node.js.

Ante cualquier duda o pregunta al respecto, pueden resolverla rápidamente dentro de la Comunidad Afip SDK. Además, puedes unirte para estar al tanto de las novedades y problemas técnicos al usar los servicios de ARCA.