Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aapp2face-1.0.0a3.tar.gz (74.1 kB view details)

Uploaded Source

Built Distribution

aapp2face-1.0.0a3-py3-none-any.whl (87.7 kB view details)

Uploaded Python 3

File details

Details for the file aapp2face-1.0.0a3.tar.gz.

File metadata

  • Download URL: aapp2face-1.0.0a3.tar.gz
  • Upload date:
  • Size: 74.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.10 Linux/6.1.21-1-MANJARO

File hashes

Hashes for aapp2face-1.0.0a3.tar.gz
Algorithm Hash digest
SHA256 653353aae81dcf3887b0ea89d87f184bed18624a5e982c9cd3ed5e7bdf09c643
MD5 138b447739602d9e0d53c3735e76d7b8
BLAKE2b-256 4f9d7d9fcb120bfef181a608b2383698f942a7d32fe1f12b0dea16a243a36dd8

See more details on using hashes here.

File details

Details for the file aapp2face-1.0.0a3-py3-none-any.whl.

File metadata

  • Download URL: aapp2face-1.0.0a3-py3-none-any.whl
  • Upload date:
  • Size: 87.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.10 Linux/6.1.21-1-MANJARO

File hashes

Hashes for aapp2face-1.0.0a3-py3-none-any.whl
Algorithm Hash digest
SHA256 608a976153c2f6070fb71d45004571cbc55bf8e8f57e0747c7eac8567808cb27
MD5 263c4b7656132655156ae87e2163c5a4
BLAKE2b-256 a0d723efce08feedf1c14eb9bdcdbd3156200062abfafeb789cd93a14c6eedf2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page