Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ivanalemunioz authored Jul 29, 2023
1 parent d6c47dd commit 79b7e8c
Showing 1 changed file with 7 additions and 105 deletions.
112 changes: 7 additions & 105 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,131 +19,33 @@
<p align="center">
Librería para conectarse a los Web Services de AFIP
<br />
<a href="https://github.com/afipsdk/afip.php/wiki"><strong>Explorar documentación »</strong></a>
<a href="https://docs.afipsdk.com"><strong>Explorar documentación »</strong></a>
<br />
<br />
<a href="https://github.com/afipsdk/afip.php/issues">Reportar un bug</a>
</p>
</p>
<p align="center">
<a href="https://docs.afipsdk.com/">
<img src="https://github.com/afipsdk/afipsdk.github.io/blob/master/images/implementation.png" alt="Implementation">
</a>
</p>

<!-- TABLE OF CONTENTS -->
## Tabla de contenidos

* [Acerca del proyecto](#acerca-del-proyecto)
* [Guía de inicio](#guía-de-inicio)
* [Instalación](#instalaci%C3%B3n)
* [Como usarlo](#como-usarlo)
* [Web Services](#web-services)
* [Factura electrónica](#factura-electr%C3%B3nica)
* [Padrón alcance 4](#padr%C3%B3n-alcance-4)
* [Padrón alcance 5](#padr%C3%B3n-alcance-5)
* [Padrón alcance 10](#padr%C3%B3n-alcance-10)
* [Padrón alcance 13](#padr%C3%B3n-alcance-13)
* [Integrar otro web service](https://afipsdk.com/wiki/php/generic_web_service.html)
* [Ejemplos de uso](https://afipsdk.com/wiki/php/examples/index.html)
* [Implementación en Frameworks y Plataformas](https://afipsdk.com/wiki/php/frameworks/index.html)
* [Tutoriales para la página AFIP](https://afipsdk.com/wiki/php/tutorials/index.html)
* [Solución a errores más frecuentes](https://afipsdk.com/wiki/php/errors.html)
* [Preguntas frecuentes](https://afipsdk.com/wiki/php/faq.html)
* [Migración](#migraci%C3%B3n)
* [Proyectos relacionados](#proyectos-relacionados)
* [Licencia](#licencia)
* [Contacto](#contacto)

<!-- DOCS -->
## Documentación
[Explorar documentación](https://docs.afipsdk.com)

<!-- ABOUT THE PROJECT -->
## Acerca del proyecto
Afip SDK es la forma más rápida y simple de conectarse con los Web Services de AFIP.

Esta librería fue creada con la intención de ayudar a los programadores a usar los Web Services de AFIP sin romperse la cabeza ni perder tiempo tratando de entender la complicada documentación que AFIP provee. Ademas forma parte de [Afip SDK](https://afipsdk.com/).


<!-- START GUIDE -->
## Guía de inicio

### Instalación

#### Via Composer

```
composer require afipsdk/afip.php
```

#### Via Manual
1. Clonarlo con `git clone` o descargar el repositorio desde [aqui](https://github.com/AfipSDK/afip.php/archive/refs/heads/master.zip "Descargar repositorio").
2. Copiar el contenido de la carpeta *res* a tu aplicación.

**Importante**
* Remplazar `Afip_res/cert` por tu certificado provisto por AFIP y `Afip_res/key` por la clave generada.
* Procuren que la carpeta `Afip_res` no sea accesible desde internet ya que allí se guardara toda la informacion para acceder a los web services, **ademas esta carpeta deberá tener permisos de escritura**.

Ir a [Tutoriales para la página AFIP](https://afipsdk.com/wiki/php/tutorials/index.html) para obtener mas información de como generar la clave y certificado.

### Como usarlo

Si lo instalaste manualmente lo primero es incluir el SDK en tu aplicación
````php
include 'ruta/a/la/libreria/src/Afip.php';
````

Luego creamos una instancia de la clase Afip pasandole un Array como parámetro.
````php
$afip = new Afip(array('CUIT' => 20111111112));
````


Para más información acerca de los parámetros que se le puede pasar a la instancia new `Afip()` consulte sección [Primeros pasos](https://github.com/afipsdk/afip.php/wiki/Primeros-pasos#como-usarlo) de la documentación

Una vez realizado esto podemos comenzar a usar el SDK con los Web Services disponibles


<!-- WEB SERVICES -->
## Web Services

Si necesitas más información de cómo utilizar algún web service echa un vistazo a la [documentación completa de afip.php](https://github.com/afipsdk/afip.php/wiki)

### Factura electrónica
Podes encontrar la documentación necesaria para utilizar la [facturación electrónica](https://github.com/afipsdk/afip.php/wiki/Facturaci%C3%B3n-Electr%C3%B3nica) 👈 aquí

### Padrón alcance 4
El Servicio Web de Consulta de Padrón denominado A4 ha quedado limitado para Organismos Públicos, si lo necesitas puedes leer la documentación de [consulta al padrón de AFIP alcance 4](https://github.com/afipsdk/afip.php/wiki/Consulta-al-padron-de-AFIP-alcance-4)

### Padrón alcance 5
Quienes usaban el padrón A4 pueden utilizar este padrón en modo de remplazo, si queres saber cómo echa un vistazo a la documentación de [consulta al padrón de AFIP alcance 5](https://github.com/afipsdk/afip.php/wiki/Consulta-al-padron-de-AFIP-alcance-5)

### Padrón alcance 10
Si tenes que utilizar este web service también está disponible dentro de la librería, su documentación se encuentra en [consulta al padrón de AFIP alcance 10](https://github.com/afipsdk/afip.php/wiki/Consulta-al-padron-de-AFIP-alcance-10)

### Padrón alcance 13
Si debes consultar por el CUIT de una persona física tendrás que utilizar este web service, su documentación se encuentra disponible en la wiki de [consulta al padrón de AFIP alcance 13](https://github.com/AfipSDK/afip.php/wiki/Consulta-al-padron-de-AFIP-alcance-13)


<!-- MIGRATION -->
### Migración
¿Necesitas migrar de versión de la librería?

Pueden encontrar el tutorial correspondiente aquí 👇
- [Migrar de v0.1 a v0.5](https://github.com/afipsdk/afip.php/wiki/Migrar-de-v0.1-a-v0.5)


<!-- RELATED PROJECTS-->
### Proyectos relacionados

#### Libreria para Javascript
Si necesitas acceder los web services de AFIP en **Javascript** podes utilizar [Afip.js](https://github.com/afipsdk/afip.js)

#### Bundle para Symfony
Si necesitas utilizar los web services de Afip en _Symfony_ podes utilizar este [bundle](https://github.com/gonzakpo/afip)

Esta librería fue creada con la intención de ayudar a los programadores a usar los Web Services de AFIP sin romperse la cabeza ni perder tiempo tratando de entender la complicada documentación que AFIP provee.

<!-- LICENCE -->
### Licencia
Distribuido bajo la licencia MIT. Vea `LICENSE` para más información.


<!-- CONTACT -->
### Contacto
Afip SDK - afipsdk@gmail.com
Expand Down

0 comments on commit 79b7e8c

Please sign in to comment.