FJFrigo · Fiscal · menu354 y menu355 — Paraguay

Libro Compra y Libro Venta

Los dos libros fiscales paraguayos: qué entra en cada uno, cómo una línea se convierte en un documento, y por qué el mismo lanzamiento a veces aparece dos veces. Con lo que rechaza la generación y lo que es comportamiento esperado del libro.

Pantallas: Libro Compra (354) y Libro Venta (355) La pantalla solo ofrece el Libro — Hechauka y Marangatu existen en el backend, sin botón Sin regla de acceso nombrada

Bloquea

No genera el archivo. statuscode 400 con la frase de abajo.

Aviso

Comportamiento esperado del libro, que sorprende a quien verifica línea por línea.

Una línea es un DOCUMENTO

La consulta trae una línea por ítem; el libro muestra una por documento. Es la agrupación lo que explica casi toda duda de verificación.

Son libros de Paraguay

Los valores, los tipos de comprobante y el formato del RUC son los de la SET. En un tenant de otro país estas pantallas no tienen uso.

Lo que estas pantallas hacen hoy: la ventana solo genera el Libro. El combo "Listado" del sistema anterior tiene dos salidas más — Hechauka y Marangatu —, que no son un informe: son archivos de remesa con el layout de la SET (Hechauka en TAB, Marangatu en ;, sin encabezado de columna ni resúmenes, con reglas propias de RUC, de tipo de comprobante y de agrupación). Están implementadas en el backend (RelatorioLivroCompraHechauka/Marangatu y RelatorioLivroVendaHechauka/Marangatu, elegidas por el campo modo — LIVRO, HECHAUKA o MARANGATU — del pedido, misma consulta del Libro), pero la ventana no tiene el combo "Listado" y nunca envía modo: por la pantalla solo sale el Libro. Para generar un archivo hay que llamar al endpoint con modo. Fueron validadas el 16/09/2026 solo por consistencia interna (encabezado cuadrando con el detalle, en los cuatro combos y las dos monedas), sin plantilla del sistema anterior.

Los números fueron verificados contra el sistema anterior: cuatro plantillas del 01 al 05/08/2026, en los dos modos de moneda — Compra 324 de 324 líneas idénticas, Venta 1.219 de 1.219. Lo que esta verificación no cubre son las columnas de rastreo (id, tabla, timbrado, asientos) y períodos mayores a cinco días.

A

Qué es cada libro

Para quien atiende

Los dos son la lista de los documentos fiscales del período, repartidos por franja de IVA — 10%, 5% y exentas. Alimentan la liquidación y son lo que el contador verifica.

354 — Libro Compra355 — Libro Venta
Origen Compras, despachos, depósito, facturas sueltas — 20 orígenes en una UNION Ventas, cupones, transportes — 13 orígenes
De dónde sale el IVA De la columna del lanzamiento Calculado: por dentro, base ÷ 1,10 × 0,10
Líneas por documento Una Hasta dos — la venta y la retención de RENTA
Clave de la agrupación Documento + RUC + tipo de comprobante Documento + módulo de origen
Filtro de origen Tiene — el combo Origen, con las siglas de los módulos No tiene

El flete y el seguro salen de las exentas a partir del 01/09/2018 en el Libro Venta. Es una fecha fija en el sistema, y es lo que explica que la misma venta sume diferente antes y después de ella.

B

Qué rechaza la generación

Son cuatro

Pocas, porque un libro no valida un lanzamiento — lista lo que ya fue lanzado. Los rechazos son de recorte y de ausencia de dato.

Bloquea

Informe a data inicial.

Informe a data final.

A data final não pode ser anterior à inicial.

CuándoEl período no fue completado, o está invertido.

Paraguay
Bloquea

Não foram encontrados dados nessas condições.

CuándoEl recorte no devolvió ninguna línea.

Por qué es un rechazo y no un archivo vacíoUn libro sin ninguna línea no genera página, y el generador de PDF revienta. El sistema anterior también avisa y no imprime.

Dónde mirarPeríodo, sucursal, emisor y — solo en el Libro Compra — el combo Origen. Restringir el origen a un módulo sin movimiento en el período es la causa más común.

Paraguay
Bloquea

Nenhuma das tabelas de origem deste relatório existe neste banco.

CuándoNinguno de los módulos de la UNION tiene tabla en este cliente.

No es un defectoEl schema difiere por cliente: hay módulos que solo existen en algunos tenants. Los orígenes ausentes se retiran de la consulta uno por uno — sin eso, la consulta entera fallaría con "Table doesn't exist" por causa de un módulo que ese cliente no usa.

Paraguay
C

Cómo una línea se convierte en un documento

Es aquí donde la verificación suele tropezar

La consulta devuelve una línea por ítem y el libro imprime una por documento. Quien hace esa unión es la clave de la agrupación — y no es la misma en los dos libros.

Aviso

A mesma factura lançada em dois módulos aparece como UMA linha

CuándoLibro Compra, con Agrupar la misma factura de módulos diferentes activado — y nace activado.

DesactivandoEl origen entra en la clave y el mismo documento se convierte en dos líneas, una por módulo. Medido en una plantilla de cinco días: 3 documentos de las 324 líneas estaban en esa situación, y el valor del libro era la suma de las dos.

Cuál usarActivado es el del libro oficial. Desactivado sirve para encontrar de dónde vino cada mitad.

Paraguay
Aviso

No Livro Venta, o mesmo documento pode gerar duas linhas de propósito

CuándoLa venta tiene retención de RENTA: sale la línea de la venta y una línea propia de la retención.

No es duplicidadSon dos hechos fiscales distintos en el mismo documento.

Paraguay
Aviso

O IVA do Livro Venta é calculado, não lido

La cuentaPor dentro: base ÷ 1,10 × 0,10, redondeado. En el Libro Compra viene de la columna del lanzamiento.

ConsecuenciaUna diferencia de centavo entre el libro y lo que está grabado en el documento de venta es del redondeo, no un error de lanzamiento.

Paraguay
D

Los RUC especiales

Dos números que no son de nadie

Dos situaciones cambian el RUC del documento por un número fijo. Quien verifica el libro por primera vez se extraña — son del sistema anterior y son correctos.

RUCSignificaQué cambia
44444401-7 FACTURA INNOMINADA Sale cuando el emisor es persona física, o el documento es nota de devolución. El criterio de física es el del sistema anterior: RUC sin guión, o con cualquier letra
99999901-0 Despacho de importación Solo en el Libro Compra. En él el valor no sale de las bases de IVA: sale del valor de la mercadería del despacho, convertido por el mayor cambio del grupo, más el traspaso
Aviso

As linhas do despacho de importação são consumidas e não somam separado

ComportamientoEntran en la línea del despacho y desaparecen como línea propia. Buscarlas ítem por ítem en el libro no las encuentra.

Paraguay
E

Los filtros y qué hace cada uno

Panel de Opciones
FiltroLibroQué hace
PeríodoLos dosObligatorio
SucursalLos dosEn blanco = todas
EmisorLos dosEn blanco = todos
MonedaLos dosEn blanco = como fue lanzado. Al elegir una, todos los valores se convierten a ella — y la consulta cambia de redacción, no solo el número
Origen354La sigla del módulo. TT = todas
Agrupar la misma factura de módulos diferentes354Nace activado — ver la sección C
Sin cumplido355Cambia la fecha que define el período: pasa a valer la emisión en vez del cumplimiento
ApaisadoLos dosSolo el PDF. Nace activado — el libro es ancho
Aviso

"Moeda" em branco não é o mesmo que escolher a moeda local

En blancoCada valor sale en la moneda en que fue lanzado — un libro con documentos en guaraníes y en dólares mezcla las dos, y sumar las columnas no tiene sentido.

Eligiendo unaTodo se convierte a ella, y ahí el total tiene significado.

Paraguay
F

Los dos resúmenes del pie

Por comprobante y por rubro

Cada libro cierra con dos resúmenes: uno por tipo de comprobante (factura, nota de crédito, autofactura…) y otro por rubro, que es la naturaleza del gasto o del ingreso.

Aviso

Os dois resumos saem do MESMO índice, e ele é só pela descrição

ConsecuenciaUn rubro y un comprobante que tengan el mismo nombre caen en el mismo registro, con el tipo del primero que apareció. Es como se comporta el sistema anterior, y está reproducido.

Cuándo apareceRaras veces — solo con nombres de catastro coincidentes.

Paraguay
Aviso

No Livro Venta, o total do resumo aparece na coluna "Valor Flete + Seguro"

Por quéLa línea de resumen del 355 fue copiada de la del 354, que no tiene la columna de flete — los valores entran en secuencia a partir de "Grav 10%" y el último cae una columna más adelante.

Es un desliz del sistema anterior, reproducidoCorregirlo aquí haría que el libro nuevo diverja de lo que el contador recibe hoy.

Paraguay
Aviso

O resumo por rubro leva total no Livro Venta e não no Livro Compra

ComportamientoEn el 354 la celda del total del rubro existe y sale siempre en cero. También es del sistema anterior.

Paraguay
G

Permisos

Mantenimiento › Acceso de los Grupos (444)

Ninguno. Las dos pantallas no consultan regla de acceso nombrada — quien tiene la opción en el menú genera el libro, y quien no la tiene no ve la pantalla.

Aviso

Não há permissão a conceder nem a retirar nestas telas

Lo que existeSolo el acceso a la opción de menú, y el recorte de sucursal del propio filtro.

A diferencia del 251Allí el tipo de grupo AEX cambia las columnas por versiones espejo. Aquí eso no ocurre: los libros fiscales muestran el dato como está.

Paraguay
H

Cómo llega el error a la pantalla

Para que el QA reproduzca y reporte

Toda respuesta sale con HTTP 200; quien dice qué pasó es el statuscode en el cuerpo — 400 para los cuatro rechazos de la sección B.

Los mensajes del servidor están siempre en portugués, incluso en el tenant paraguayo, donde la pantalla está en español. No es un defecto de traducción.

El tiempo esperado, medido en agosto/2026: Libro Compra con 900 documentos en ~2,3 s; Libro Venta con 5.251 en ~9,2 s. Mucho más allá de eso, el primer sospechoso es el período.

Al abrir un ticket de soporte sobre un valor, informe el documento y el módulo de origen — la columna de origen está en la planilla, y por ella se encuentra el lanzamiento.

I

Diferencias y deslices reproducidos

Esperados — no abrir un ticket

Lo que está reproducido a propósito, aunque parezca un defecto:

· el total del resumen del Libro Venta en la columna de flete y seguro;
· el total del rubro en cero en el Libro Compra;
· los dos resúmenes compartiendo el índice por descripción;
· la comparación de origen que trata la compra de depósito como despacho — en el sistema anterior la prueba es de "está contenido en", y ac está contenido en acd.

Lo que falta en la pantalla: el combo "Listado" con las salidas Hechauka y Marangatu. El generador existe en el backend (archivos de remesa para la SET, elegidos por modo), pero la ventana no lo ofrece; quien necesita el archivo hoy no lo obtiene por la pantalla (en el sistema anterior sí).

Y un cuidado sobre la verificación ya hecha: las cuatro plantillas que coincidieron cubren cinco días y las columnas de valor. Las columnas de rastreo y un mes entero quedan para cuando haya una plantilla mayor.

Ninguna regla coincide con esa búsqueda. Intente un fragmento más corto del mensaje, o limpie los filtros.