Download the PHP package armandolazarte/phpafipws without Composer

**SDK moderno para Web Services de AFIP en PHP** [](https://github.com/armandolazarte/phpafipws/actions) [](https://packagist.org/packages/armandolazarte/phpafipws) [](https://packagist.org/packages/armandolazarte/phpafipws) [](https://packagist.org/packages/armandolazarte/phpafipws) [](https://packagist.org/packages/armandolazarte/phpafipws) [](https://github.com/armandolazarte/phpafipws)

📋 Descripción

PhpAfipWs es un SDK moderno y robusto para interactuar con los Web Services de AFIP (Administración Federal de Ingresos Públicos) de Argentina. Desarrollado con PHP 8.1+, ofrece una interfaz simple y elegante para la facturación electrónica y otros servicios de AFIP.

✨ Características

• Moderno: Desarrollado con PHP 8.1+ y tipado estricto
• Fácil de usar: API intuitiva y bien documentada
• Completo: Soporte para múltiples Web Services de AFIP
• Seguro: Manejo robusto de certificados y autenticación
• Confiable: 99 tests automatizados con Pest 4
• Mantenido: Actualizaciones regulares y soporte activo

🆕 Novedades v1.2.0

• Nueva clase GeneradorCertificados: Utilidades completas para gestión de certificados y claves
  • generarClavePrivada() - Generar claves privadas RSA con phpseclib3
  • generarCSR() - Crear Certificate Signing Requests para AFIP
  • extraerInformacionCSR() - Extraer información de CSRs existentes
  • extraerInformacionCertificado() - Analizar certificados X.509
  • crearInformacionDN() - Crear Distinguished Names válidos para AFIP
  • validarInformacionDN() - Validar estructura de Distinguished Names
• Nueva excepción CertificadoException: Manejo específico de errores de certificados
• 6 ejemplos nuevos: Guías paso a paso para generación de certificados
• Integración con phpseclib3: Soporte nativo para operaciones criptográficas
• Documentación especializada: Guía completa en docs/GeneradorCertificados.md

🔄 Novedades anteriores v1.1.2

• Nuevos métodos CAEA: 3 métodos adicionales para gestión completa de CAEA
  • informarCAEASinMovimiento() - Informar CAEA sin movimiento
  • consultarCAEASinMovimiento() - Consultar estado de CAEA sin movimiento
  • registrarComprobantesConCAEA() - Registrar comprobantes emitidos con CAEA
• Nuevos métodos de consulta: 2 métodos para información adicional
  • obtenerCotizacionMoneda() - Obtener cotización oficial de monedas
  • obtenerActividades() - Consultar actividades económicas del emisor
• Ejemplos ampliados: 24 ejemplos prácticos cubriendo 100% de los 22 métodos disponibles
• Tests actualizados: Suite de tests expandida con cobertura completa de nuevos métodos
• Documentación completa: Guías detalladas y casos de uso para todos los métodos

🚀 Instalación

Instala el paquete usando Composer:

📦 Requisitos

• PHP >= 8.1
• Extensión SOAP
• Extensión OpenSSL
• Extensión SimpleXML
• Certificado digital de AFIP
• Clave privada correspondiente

Dependencias Opcionales

• phpseclib/phpseclib:~3.0 - Para generar certificados y claves con GeneradorCertificados

🔧 Configuración Inicial

1. Obtener Certificados

Tienes dos opciones para obtener certificados:

Opción A: Generar con GeneradorCertificados (Recomendado)

Opción B: Proceso Manual

1. Genera una clave privada y CSR con herramientas externas
2. Solicita el certificado en el sitio de AFIP
3. Descarga el certificado (.crt) y guarda tu clave privada (.key)

2. Estructura de Carpetas

💻 Uso Básico

Inicialización

Facturación Electrónica

Método Simplificado (Recomendado)

Método Manual (Control Total)

🛠️ Web Services y Utilidades Disponibles

Web Services AFIP

• FacturacionElectronica: Facturación electrónica (WSFE)
• PadronAlcanceCuatro: Padrón A4
• PadronAlcanceCinco: Padrón A5
• ConstanciaInscripcion: Constancia de inscripción
• PadronAlcanceDiez: Padrón A10
• PadronAlcanceTrece: Padrón A13

Utilidades de Certificados

• GeneradorCertificados: Generación y gestión de certificados digitales
  • Generación de claves privadas RSA
  • Creación de Certificate Signing Requests (CSR)
  • Extracción de información de certificados y CSRs
  • Validación de Distinguished Names
  • Utilidades de archivos para certificados

📚 Ejemplos

El directorio ejemplos/ contiene 30 ejemplos completos que cubren 100% de los métodos disponibles:

Facturación Electrónica

• Facturas A, B y C con ejemplos detallados
• Notas de crédito A, B y C
• Gestión completa de CAEA (Código de Autorización Electrónico Anticipado)
• Consulta de información de comprobantes

Consultas de Parámetros

• Tipos de comprobantes, documentos y monedas
• Tipos de concepto y alícuotas de IVA
• Condiciones de IVA del receptor
• Puntos de venta habilitados
• Tipos de datos opcionales (CVU, CBU, Email, etc.)
• Tipos de tributos (Nacionales, Provinciales, Municipales)

Métodos Avanzados

• Gestión CAEA completa: Solicitar, consultar, informar sin movimiento y registrar comprobantes
• Cotizaciones de moneda: Obtener cotizaciones oficiales de AFIP para facturación en moneda extranjera
• Actividades económicas: Consultar actividades habilitadas del emisor
• Nuevos métodos simplificados v1.1.0: Autorización automática y consultas directas
• Estado del servidor y diagnósticos: Verificación de disponibilidad de servicios
• Demostración completa: Ejemplos de todos los métodos disponibles

Generación de Certificados

• Generación de claves privadas: Crear claves RSA con diferentes tamaños y frases secretas
• Creación de CSRs: Generar Certificate Signing Requests válidos para AFIP
• Gestión de Distinguished Names: Crear y validar información DN
• Análisis de certificados: Extraer información de certificados X.509 existentes
• Flujo completo: Proceso paso a paso desde clave privada hasta certificado final

Todos los ejemplos incluyen:

• ✅ Código funcional sin warnings
• ✅ Explicaciones detalladas de uso
• ✅ Validaciones y mejores prácticas
• ✅ Funciones helper reutilizables
• ✅ Manejo robusto de errores

🔍 Métodos Útiles

Información del SDK

Generación de Certificados

Facturación Electrónica - Métodos Principales

Consultas de Parámetros

Consultas de Padrón

⚙️ Configuración Avanzada

Carpeta WSDL Personalizada

Manejo de Excepciones SOAP

🚨 Manejo de Errores

El SDK utiliza excepciones específicas para diferentes tipos de errores con información contextual detallada:

Información Contextual

Todas las excepciones incluyen:

• Timestamp: Momento exacto del error
• ID único: Para tracking y debugging
• Contexto: Información específica del error
• Códigos estructurados: Para manejo programático

🧪 Testing

PhpAfipWs incluye una suite completa de tests usando Pest 4 para garantizar la calidad y confiabilidad del código.

Ejecutar Tests

Cobertura de Tests

• ✅ 99 tests con 295 assertions
• ✅ Tests unitarios para todas las clases principales
• ✅ Tests de integración para flujos completos
• ✅ Validación de configuraciones y excepciones
• ✅ Manejo de errores y casos edge
• ✅ Cobertura 100% de métodos de Facturación Electrónica
• ✅ 34 tests específicos para FacturacionElectronica con 111 assertions
• ✅ Tests de casos de uso reales basados en ejemplos

Estructura de Tests

Calidad de Código

🔧 Desarrollo

Configuración del Entorno de Desarrollo

Debugging

Para debugging detallado, puedes acceder a información contextual de las excepciones:

🙏 Agradecimientos

Este proyecto está basado en el excelente trabajo de AfipSDK/afip.php. Agradecemos enormemente a sus contribuidores por sentar las bases que hicieron posible este SDK moderno.

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)
3. Escribe tests para tu código (composer test:unit)
4. Verifica la calidad (composer quality)
5. Commit tus cambios (git commit -am 'Agrega nueva funcionalidad')
6. Push a la rama (git push origin feature/nueva-funcionalidad)
7. Abre un Pull Request

Guías para Contribuir

• Tests: Todo código nuevo debe incluir tests
• Estilo: Seguir PSR-12 y las reglas de PHP CS Fixer
• Tipos: Usar tipado estricto en todo el código
• Documentación: Actualizar README y docstrings según corresponda

📄 Licencia

Este proyecto está bajo la Licencia MIT.

👨‍💻 Autor

Armando Lazarte