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 de PointOfSales 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)

get_template_names(receipt: django_afip.models.Receipt = None)

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.