Saltar al contenido principal

Facturas provisionales

Las facturas provisionales (pre-facturas) le permiten anticipar el documento de venta antes de la factura definitiva. Este tutorial explica cómo imprimir y descargar sus facturas provisionales y las mejoras recientes en su presentación.

Impresión y descarga en PDF​

Desde la página de detalles de una factura provisional:

  1. Seleccione una plantilla de impresión.
  2. Haga click en "Imprimir" para ver la vista previa, o use la opción para descargar el PDF.

facturas-provisionales-imprimir

https://app.zauru.com/sales/provisional_invoices/:id

Mensaje de factura anulada (VOIDED)​

Si la factura provisional ha sido anulada, la impresión y el PDF ahora muestran automáticamente un mensaje de "ANULADO" (VOIDED), de modo que el documento impreso refleje claramente su estado.

facturas-provisionales-anulada

https://app.zauru.com/sales/provisional_invoices/:id

Mejoras recientes en la impresión​

  • Descarga en PDF con el servicio de facturas: la descarga del PDF de la factura provisional ahora utiliza el mismo servicio de generación de PDF que las facturas definitivas, lo que mejora la fidelidad y el formato del archivo.
  • Numeración de renglones en plantillas: las plantillas de impresión ahora disponen de una variable de conteo (count) que permite numerar los renglones de detalle en sus diseños personalizados.
  • Corrección de la validación de anulación: se corrigió la lógica que determina si una factura provisional está anulada al imprimir, asegurando que el mensaje de anulación se muestre correctamente.

Representación electrónica (FEL Guatemala)​

En la facturación electrónica de Guatemala, las facturas provisionales ahora tratan todos sus renglones como bienes en su representación electrónica (campo BienOServicio = B), independientemente del tipo de ítem.

API (llamadas desde sistemas externos)​

Listar facturas provisionales​

Devuelve hasta 100 facturas provisionales no anuladas de la entidad.

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/sales/provisional_invoices.json

Esto devolverá un JSON similar a este:

[
  {
    "id": 1,
    "zid": 2,
    "invoice_number": null,
    "date": "2026-08-10",
    "issued_at": "2026-08-10T15:20:31.000Z",
    "agency_id": 4,
    "payee_id": 5,
    "seller_id": 6,
    "currency_id": 1,
    "exchange_rate": 1.0,
    "subtotal": "1250.0",
    "total": "1250.0",
    "taxable": false,
    "excempt": true,
    "foreign": true,
    "reference": "PRE-FACTURA-001",
    "memo": "",
    "voided": false,
    "provisional_invoice_details_count": 2,
    "created_at": "2026-08-10T15:20:31.000Z",
    "updated_at": "2026-08-10T15:20:31.000Z"
  }
]

Consultar la respuesta certificada de una factura provisional​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/sales/provisional_invoices/1/external_storage_certified_response.json

Consultar la respuesta certificada de anulación de una factura provisional​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/sales/provisional_invoices/1/external_storage_certified_response_for_voiding.json

¿Le fue útil esta guía?