-
Notifications
You must be signed in to change notification settings - Fork 0
Home
La API permite la comunicación con parte de los servicios que provee la AFIP para la gestión de comprobantes. Permite gestionar entidades con los datos necesarios para simplificar la autenticación con AFIP a través del uso de certificados y el manejo de las respuestas y errores.
Existen algunas estructuras básicas que son importantes de entender antes de integrar la API.
Una entidad en el sistema representa una persona física o jurídica en AFIP. Contiene los datos necesarios para poder hacer consultas y generar comprobantes. Cada entidad requiere al menos tener una CUIT, un certificado y una clave privada para poder realizar la conexión con la API de AFIP.
En este enlace se puede encontrar una guía sobre cómo crear entidades y generar y/o renovar sus certificados utilizando la API en entorno productivo (y en este otro en entorno de homologación o testing).
El sistema permite la creación y consulta de comprobantes. Un comprobante puede ser, por ejemplo, facturas, notas de crédito, notas de débito, o facturas de crédito electrónicas. A su vez, los comprobantes de pueden ser exportados en formato PDF. Incluso se puede obtener una previsualización de un comprobante en formato PDF sin su creación en AFIP.
En este enlace se puede encontrar una guía sobre cómo generar comprobantes utilizando la API.
La documentación oficial de AFIP puede encontrarse en este enlace.
La API permite la consulta de la información relacionada a una CUIT, ya sea que pertenezca a una persona física como a una jurídica.
Los datos estáticos permite obtener información de los parámetros que se requieren para la creación o consulta de comprobantes. Es un mapeo de los identificadores internos que requiere la API y la información que espera AFIP.
La API tiene dos roles para ser consumida en función de aquello que se quiera procesar.
En primer lugar, el rol administrador tiene capacidad de gestión de entidades: alta, consulta y modificación. El sistema cuenta con único adminstrador, el cual se autentica evaluando el header HTTP de autenticación básica contra el valor de la variable de entorno AUTH_TOKEN.
Por otra parte, toda operación de consulta de datos estáticos, y de consulta y alta de comprobantes, corresponden al rol entidad. Toda entidad registrada en el sistema cuenta con un token almacenado en base de datos que permiten autenticarla.