Impresiones¶
Originalmente django-afip no soportaba generación de PDFs o comprobantes a imprimir, dado que esto lo hacían sistemas externos.
Eventualmente esto cambió, y la generación de PDFs se integró a esta librería, pero la integración no está al 100%, por lo cual la mayoría del código para generar los PDF es opcional.
Actualmente soportamos generar PDFs para comprobantes y esto está respaldado principalmente por tres clases. Sólo necesitás usar estas clases si estás generando los PDF con esta librería, y podés ignorarlas si estás generándolos de otra forma:
ReceiptPDF
: Contiene metadatos individuales de cada comprobante. Los datos dePointOfSales
también se copian acá, dado que en caso de que cambie, por ejemplo, el domicilio del contribuyente, no debería cambiar el domicilio en comprobantes pasados.ReceiptEntry
: Representa una línea del detalle de un comprobante.
Primero deberías generar los ReceiptEntry
para tu comprobante y después
generar el ReceiptPDF
. Esto último lo podés hacer usando el helper
create_for_receipt()
.
Los archivos PDF en sí son generados la primera vez que guardes una instancia
de ReceiptPDF
(mediante un hook pre_save
). Podés regenerar el PDF
usando ReceiptPDF.save_pdf()
.
Códigos QR¶
Los PDF incluyen el código QR que es requerido desde Marzo 2021.
Actualmente cualquier QR redirige a la documentación del AFIP (includo lo de sus ejemplos y otra implementaciones). Esto parece ser porque AFIP nunca terminó de implementar su parte, y está fuera de nuestro control.
Exponiendo comprobantes¶
Vistas¶
Los comprobantes pueden exponerse mediante una vista. Requirre el pk del comprobante, así que la registración de la URL debería ser algo como:
path(
"receipts/pdf/<int:pk>",
views.ReceiptPDFView.as_view(),
name="receipt_view",
),
Esto usa django_renderpdf, y es una subclase de PDFView
.
Recomendamos generalmente usar una subclase de ReceiptPDFView
, que tenga
alguna forma de autenticación y autorizacion.
-
class
django_afip.views.
ReceiptPDFView
(**kwargs)[source]¶ -
get_template_names
(receipt: django_afip.models.Receipt = None)[source]¶ Return the templates use to render the Receipt PDF.
Template discovery tries to find any of the below receipts:
receipts/{taxpayer}/pos_{point_of_sales}/code_{code}.html receipts/{taxpayer}/code_{code}.html receipts/code_{code}.html receipts/{code}.html
To override, for example, the “Factura C” template for point of sales 0002 for Taxpayer 20-32964233-0, use:
receipts/20329642330/pos_2/code_6.html
-
receipt
¶ Returns the receipt.
Returns the same in-memory instance during the whole request.
-
Templates¶
Los templates para las vistas son buscados en
templates/receipts/code_X.html
, dónde X es el código del tipo de
comprobante (ReceiptType
). Si querés overridear el predetermindo,
simplemente incluí en tu projecto un template con el mismo nombre/path, y
asegurate de que te projecte esté listado antes que django_afip
en
INSTALLED_APPS
.
También podés exponer los archivos generados
Note that you may also expose receipts as plain Django media files. The URL will be relative or absolute depending on your media files configuration.
>>> printable = ReceiptPDF.objects.last()
>>> printable.pdf_file
<FieldFile: receipts/790bc4f648e844bda7149ac517fdcf65.pdf>
>>> printable.pdf_file.url
'/media/receipts/790bc4f648e844bda7149ac517fdcf65.pdf'
Los templates provistos siguen las indicaciones de la RG1415, que regula que campos deben contener y dónde debe estar ubicado cada dato.