Librería Python para interactuar con los servicios web de FACe desde el lado de las Administraciones Públicas
Project description
🏛️ AAPP2FACe
AAPP2FACe es una librería Python para interactuar con los servicios web de FACe, el Punto General de Entrada de Facturas de la Administración General del Estado, desde el lado de las Administraciones Públicas Españolas.
Está diseñada para ser fácil de usar por desarrolladores y dispone de una interfaz de línea de comandos (CLI) que también le permite ser usada por usuarios finales.
Documentación: https://antmartinez68.github.io/aapp2face
Código fuente: https://github.com/antmartinez68/aapp2face
Requisitos
- Python v3.10
Instalación
Como librería
Aunque depende de cómo estés gestionando las dependencias de tu proyecto, por lo general querrás hacer:
$ pip install aapp2face
Como aplicación de línea de comandos (CLI)
Si solo pretendes usar la interfaz de línea de comandos, es recomendable instalar AAPP2FACe usando pipx:
$ pipx install aapp2face
Uso básico
Como librería
El siguiente script de ejemplo muestra cómo puedes crear los objetos necesarios para conectar con FACe y recuperar la información de las nuevas facturas que están disponibles para su descarga:
>>> from aapp2face import FACeConnection, FACeSoapClient
>>> cliente = FACeSoapClient(
... "https://se-face-webservice.redsara.es/facturasrcf2?wsdl",
... "cert.pem",
... "key.pem"
... )
>>> face = FACeConnection(cliente)
>>> nuevas_facturas = face.solicitar_nuevas_facturas()
>>> for factura in nuevas_facturas:
... print(
... factura.numero_registro,
... factura.fecha_hora_registro,
... factura.oficina_contable,
... factura.organo_gestor,
... factura.unidad_tramitadora,
... )
...
Como aplicación de línea de comandos (CLI)
La misma operación anterior puedes hacerla usando la CLI. Una vez tienes configurada la aplicación, basta con que ejecutes el siguiente comando:
$ aapp2face facturas nuevas
Número registro: 202001015624
Fecha registro: 2023-01-19 10:57:38
Oficina contable: P00000010
Órgano gestor: P00000010
Unidad tramitadora: P00000010
Número registro: 202001017112
Fecha registro: 2013-01-20 11:05:51
Oficina contable: P00000010
Órgano gestor: P00000010
Unidad tramitadora: P00000010
2 nuevas facturas disponibles
Constuir AAPP2FACe desde código fuente
AAPP2FACe usa Poetry como gestor de dependencias y empaquetado. Si quieres construirlo desde el código fuente, puede hacerlo mediante:
$ git clone https://github.com/antmartinez68/aapp2face
$ cd aapp2face
$ poetry install
$ poetry run pytest
$ poetry build
Nota: La versión inicial de este proyecto forma parte del TFG del Grado en Ingeniería Informática en UNIR de Antonio Martínez.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aapp2face-1.0.0a3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 608a976153c2f6070fb71d45004571cbc55bf8e8f57e0747c7eac8567808cb27 |
|
MD5 | 263c4b7656132655156ae87e2163c5a4 |
|
BLAKE2b-256 | a0d723efce08feedf1c14eb9bdcdbd3156200062abfafeb789cd93a14c6eedf2 |