El siguiente es el manual para administradores de la aplicación Afip.
La aplicación permite conectarse de manera simple con los servidores de la Agencia Federal de Ingresos Públicos (AFIP) de la Argentina, con el fin de emitir comprobantes de pago homologados.
Son contribuyentes del Régimen General las personas humanas y jurídicas que se encuentran alcanzadas por impuestos como: Ganancias, IVA, Bienes Personales, Ganancia Mínima Presunta, entre otros impuestos nacionales.
La aplicación permite gestionar la facturación de más de un contribuyente, cada uno de ellos con sus propios puntos de venta y tipos de comprobantes.
El punto de venta es un número de cuatro dígitos que comienza en “0001” y continúa aumentando correlativamente para identificar la cantidad de sistemas de emisión de comprobantes del contribuyente.
Un contribuyente podrá emitir uno o más tipos de comprobantes, dependiendo de las caracteristicas del negocio y la transacción.
El contribuyente deberá habilitar los servicios web en el sitio de la AFIP, tanto en las pruebas, como ya en la facturación propiamente dicha.
La habilitación requiere que nuestra aplicación emita un certificado ssl con una clave pública, esto le sirve a la AFIP para asegurarse que nuestros pedidos de facturación son seguros.
Esta aplicación utiliza la librería AfipSDK, distribuida bajo la licencia MIT.
Son contribuyentes del Régimen General las personas humanas y jurídicas que se encuentran alcanzadas por impuestos como: Ganancias, IVA, Bienes Personales, Ganancia Mínima Presunta, entre otros impuestos nacionales.
En Administración > Afip > Contribuyentes se encuentra el listado completo, como así tambien, las opciones para su administración.
El formulario tiene 3 bloques:
El nombre con el cual es conocido el contribuyente. Este nombre será mostrado en el comprobante.
El número de CUIT con el que se identifica en la AFIP.
Los datos ingresados en este bloque serán opcionales. Se ponen a dispocición en la construcción del comprobante y depende del diseño para que se utilicen.
La imagen que será mostrada en la cabecera del comprobante.
Dirección fiscal declarada ante el AFIP.
La condición fiscal.
Un campo opcional para agregar cualquier otro dato relevante en el comprobante.
Fecha de inicio de actividades.
Este bloque será explicado más adelante. Contiene las configuraciones para hacer segura la conexión con los servidores de la AFIP.
El nombre del archivo donde se almacenará el certificado.
El nombre del archivo donde se almacenará la clave.
Frase de contraseña con la que se creó la clave.
En aquellos casos en que se deje de utilizar un cotribuyente y no se pueda eliminar, es posible cambiar su estado por el de Privado.
Un contribuyente puede ser eliminado siempre que no tenga un punto de venta.
Un punto de venta identifica un sistema único de emisión de comprobantes. Un contribuyente puede tener varios puntos de venta, por ejemplo, varias cajas registradoras.
Los puntos de venta se habilitan en la AFIP.
Para agregar o editar un punto de venta hay que tener en cuenta:
El número del punto de venta que deseamos disponer. Primero, deberá ser escrito como un entero. Luego, el mismo número precedido por los ceros necesarios, según indique la ley (actualmente, 5 dígitos en total).
El número que será asignado al siguiente comprobante que se emita. Este valor debe correponder con el de los servidores de la AFIP.
En aquellos casos en que se deje de utilizar un punto de venta, y no se pueda eliminar, es posible cambiar su estado por el de Privado.
Un punto de venta puede ser eliminado, siempre que no tenga un comprobantes emitidos.
Los comprobantes serán emitidos encuadrados en un tipo de comprobante.
Un contribuyente, dependiendo de las características del negocio y la transacción a realizar, podrá emitir diferentes tipos de comprobantes.
Los tipos de comprobantes que el contribuyente podrá emitir están regulados por la AFIP. La aplicación sólo va a sincronizar los tipos de comprobantes que la AFIP le habilita.
En principio, se sincronizará de forma centralizada para todos los contribuyentes.
Una vez sincronizados los tipos de comprobantes, en la base de datos propia, se prodrán agregar los siguientes datos quedarán a disposición para la construcción del comprobante.
La letra con la cual se identifica el tipo de comprobante.
El nombre del comprobante.
Los diseños permiten poner a disposición de los constribuyentes una herramienta para personalizar los comprobantes.
Básicamente, un diseño es una plantilla html, con valores de relleno que, a la hora de emitir un comprobante, serán completados por la aplicación.
Los valores de relleno que la aplicación pone a disposición son:
| VALOR | DESCRIPCIÓN | CONFIGURADO EN |
|---|---|---|
| voucher_copy | Los comprovantes se emiten por triplicado. Lo que hace este valor es ir enumerándolos. | |
|
type_letter |
La letra con la que se identifica el tipo de comprobante. | Tipo de comprobantes |
|
type_id |
El identificador del tipo de comprobante. | |
| type_name | El nombre con el que se identifica el comprobante. | Tipo de comprobantes |
| taxpayer_image | La imágen o logotipo del contribuyente. | Contribuyentes |
| taxpayer_name | La nombre del contribuyente. | Contribuyentes |
| taxpayer_code | El CUIT del contribuyente. | Contribuyentes |
| taxpayer_address | La dirección legal. | Contribuyentes |
| taxpayer_condition | La condición frente al IVA. | Contribuyentes |
| taxpayer_other | Valor opcional. Es posible utilizarlo para mostrar Ingresos brutos. | Contribuyentes |
| started_at | La fecha de inicio de actividades. | Contribuyentes |
| outlet_name | El punto de venta. | Puntos de venta |
| voucher_number | El número del comprobante. | |
| issue_date | Fecha de emisión del comprobante. | |
| due_date | Fecha de finalización. | |
| person_document | Documento del destinatario. | |
| person_name | Nombre del destinatario. | |
| person_address | Dirección del destinatario. | |
| item_code | ||
| item_description | ||
| item_quantity_unit | ||
| item_quantity | ||
| item_partial | Valor del item sin impuestos. | |
| item_tax | Valor del item con impuesto. | |
| item_amount | Valor total del item. | |
| invoice_total | ||
| voucher_code | El CAE emitido por AFIP. | |
| expires_at | Fecha de vencimiento del CAE. | |
| voucher_qr | Configuraciones | |
| afip_logo | Configuraciones |
La aplicación trae una plantilla de ejemplo, lista para ser utilizada o modificada. Podrá encontrarla en Administración > Herramientas > Herramientas > Afip layout.