Bloqueia
Informe a data inicial.
Informe a data final.
A data final não pode ser anterior à inicial.
QuandoO período não foi preenchido, ou está invertido.
Paraguai
Não gera o arquivo. statuscode 400 com a frase abaixo.
Comportamento esperado do livro, que surpreende quem confere linha a linha.
A consulta traz uma linha por item; o livro mostra uma por documento. É o agrupamento que explica quase toda dúvida de conferência.
Os valores, os tipos de comprovante e o formato do RUC são os da SET. Num tenant de outro país estas telas não têm uso.
O que estas telas fazem hoje: a janela só gera o Livro. O combo "Listado" do sistema antigo tem mais
duas saídas — Hechauka e Marangatu —, que não são relatório: são arquivos de
remessa no leiaute da SET (Hechauka em TAB, Marangatu em ;, sem cabeçalho de coluna nem resumos, com regras próprias de RUC,
de tipo de comprovante e de agrupamento). Elas estão implementadas no backend
(RelatorioLivroCompraHechauka/Marangatu e RelatorioLivroVendaHechauka/Marangatu, escolhidas pelo campo modo
— LIVRO, HECHAUKA ou MARANGATU — do pedido, mesma consulta do Livro), mas a janela não tem o combo "Listado" e nunca envia
modo: pela tela só sai o Livro. Para gerar um arquivo é preciso chamar o endpoint com modo. Foram validadas em 16/09/2026 só por consistência interna
(cabeçalho fechando com o detalhe, nos quatro combos e nas duas moedas), sem gabarito do sistema antigo.
Os números foram conferidos contra o sistema antigo: quatro gabaritos de 01 a 05/08/2026, nos dois modos de moeda — Compra 324 de 324 linhas idênticas, Venda 1.219 de 1.219. O que essa conferência não cobre são as colunas de rastreamento (id, tabela, timbrado, asientos) e períodos maiores que cinco dias.
Os dois são a lista dos documentos fiscais do período, repartidos por faixa de IVA — 10%, 5% e isentas. Eles alimentam a apuração e são o que o contador confere.
| 354 — Livro Compra | 355 — Livro Venta | |
|---|---|---|
| Origem | Compras, despachos, almoxarifado, faturas avulsas — 20 origens numa UNION | Vendas, cupons, transportes — 13 origens |
| De onde sai o IVA | Da coluna do lançamento | Calculado: por dentro, base ÷ 1,10 × 0,10 |
| Linhas por documento | Uma | Até duas — a venda e a retenção de RENTA |
| Chave do agrupamento | Documento + RUC + tipo de comprovante | Documento + módulo de origem |
| Filtro de origem | Tem — o combo Origem, com as siglas dos módulos | Não tem |
Frete e seguro saem das isentas a partir de 01/09/2018 no Livro Venta. É uma data fixa no sistema, e é o que explica a mesma venda somar diferente antes e depois dela.
Poucas, porque um livro não valida lançamento — ele lista o que já foi lançado. As recusas são de recorte e de ausência de dado.
Informe a data inicial.
Informe a data final.
A data final não pode ser anterior à inicial.
QuandoO período não foi preenchido, ou está invertido.
Não foram encontrados dados nessas condições.
QuandoO recorte não devolveu nenhuma linha.
Por que é recusa e não um arquivo vazioUm livro sem linha nenhuma não gera página, e o gerador de PDF estoura. O sistema antigo também avisa e não imprime.
Onde olharPeríodo, filial, emitente e — só no Livro Compra — o combo Origem. Restringir a origem a um módulo sem movimento no período é a causa mais comum.
Nenhuma das tabelas de origem deste relatório existe neste banco.
QuandoNenhum dos módulos da UNION tem tabela neste cliente.
Não é defeitoO schema difere por cliente: há módulos que só existem em alguns tenants. As origens ausentes são retiradas da consulta uma a uma — sem isso, a consulta inteira morreria com "Table doesn't exist" por causa de um módulo que aquele cliente não usa.
A consulta devolve uma linha por item e o livro imprime uma por documento. Quem faz essa junção é a chave do agrupamento — e ela não é a mesma nos dois livros.
A mesma factura lançada em dois módulos aparece como UMA linha
QuandoLivro Compra, com Agrupar a mesma factura de módulos diferentes ligado — e ele nasce ligado.
DesligandoA origem entra na chave e o mesmo documento vira duas linhas, uma por módulo. Medido num gabarito de cinco dias: 3 documentos das 324 linhas estavam nessa situação, e o valor do livro era a soma das duas.
Qual usarLigado é o do livro oficial. Desligado serve para achar de onde veio cada metade.
No Livro Venta, o mesmo documento pode gerar duas linhas de propósito
QuandoA venda tem retenção de RENTA: sai a linha da venda e uma linha própria da retenção.
Não é duplicidadeSão dois fatos fiscais distintos no mesmo documento.
O IVA do Livro Venta é calculado, não lido
A contaPor dentro: base ÷ 1,10 × 0,10, arredondado. No Livro Compra ele vem da coluna do lançamento.
ConsequênciaUma diferença de centavo entre o livro e o que está gravado no documento de venda é do arredondamento, não erro de lançamento.
Duas situações trocam o RUC do documento por um número fixo. Quem confere o livro pela primeira vez estranha — são do sistema antigo e estão certos.
| RUC | Significa | O que muda |
|---|---|---|
44444401-7 |
FACTURA INNOMINADA | Sai quando o emitente é pessoa física, ou o documento é nota de devolução. O critério de física é o do sistema antigo: RUC sem hífen, ou com qualquer letra |
99999901-0 |
Despacho de importação | Só no Livro Compra. Nele o valor não sai das bases de IVA: sai do valor da mercadoria do despacho, convertido pelo maior câmbio do grupo, mais o repasse |
As linhas do despacho de importação são consumidas e não somam separado
ComportamentoElas entram na linha do despacho e desaparecem como linha própria. Procurar por elas item a item no livro não as acha.
| Filtro | Livro | O que faz |
|---|---|---|
| Período | Os dois | Obrigatório |
| Filial | Os dois | Em branco = todas |
| Emitente | Os dois | Em branco = todos |
| Moeda | Os dois | Em branco = como foi lançado. Escolhendo uma, todos os valores são convertidos para ela — e a consulta muda de redação, não só o número |
| Origem | 354 | A sigla do módulo. TT = todas |
| Agrupar a mesma factura de módulos diferentes | 354 | Nasce ligado — ver a seção C |
| Sem cumplido | 355 | Troca a data que define o período: passa a valer a emissão em vez do cumprimento |
| Paisagem | Os dois | Só o PDF. Nasce ligado — o livro é largo |
"Moeda" em branco não é o mesmo que escolher a moeda local
Em brancoCada valor sai na moeda em que foi lançado — um livro com documentos em guarani e em dólar mistura as duas, e somar as colunas não faz sentido.
Escolhendo umaTudo é convertido para ela, e aí o total tem significado.
Cada livro fecha com dois resumos: um por tipo de comprovante (factura, nota de crédito, autofactura…) e outro por rubro, que é a natureza do gasto ou da receita.
Os dois resumos saem do MESMO índice, e ele é só pela descrição
ConsequênciaUm rubro e um comprovante que tenham o mesmo nome caem no mesmo registro, com o tipo do primeiro que apareceu. É como o sistema antigo se comporta, e está reproduzido.
Quando apareceRaramente — só com nomes de cadastro coincidentes.
No Livro Venta, o total do resumo aparece na coluna "Valor Flete + Seguro"
Por quêA linha de resumo do 355 foi copiada da do 354, que não tem a coluna de frete — os valores entram em sequência a partir de "Grav 10%" e o último cai uma coluna adiante.
É deslize do sistema antigo, reproduzidoCorrigi-lo aqui faria o livro novo divergir do que o contador recebe hoje.
O resumo por rubro leva total no Livro Venta e não no Livro Compra
ComportamentoNo 354 a célula do total do rubro existe e sai sempre zerada. Também é do sistema antigo.
Nenhuma. As duas telas não consultam regra de acesso nomeada — quem tem a opção no menu gera o livro, e quem não tem não vê a tela.
Não há permissão a conceder nem a retirar nestas telas
O que existeSó o acesso à opção de menu, e o recorte de filial do próprio filtro.
Ao contrário do 251Lá o tipo de grupo AEX troca as colunas por versões espelho. Aqui isso não acontece: os livros fiscais mostram o dado como está.
Toda resposta sai com HTTP 200; quem diz o que aconteceu é o
statuscode no corpo — 400 para as quatro recusas da seção B.
As mensagens do servidor são sempre em português, inclusive no tenant paraguaio, onde a tela está em espanhol. Não é defeito de tradução.
O tempo esperado, medido em agosto/2026: Livro Compra com 900 documentos em ~2,3 s; Livro Venta com 5.251 em ~9,2 s. Muito além disso, o primeiro suspeito é o período.
Ao abrir chamado sobre um valor, informe o documento e o módulo de origem — a coluna de origem está na planilha, e é por ela que se acha o lançamento.
O que está reproduzido de propósito, mesmo parecendo defeito:
· o total do resumo do Livro Venta na coluna de frete e seguro;
· o total do rubro zerado no Livro Compra;
· os dois resumos compartilhando o índice por descrição;
· a comparação de origem que trata a compra de almoxarifado como despacho — no sistema antigo
o teste é de "está contido em", e ac está contido em acd.
O que falta na tela: o combo "Listado" com as saídas Hechauka e
Marangatu. O gerador existe no backend (arquivos de remessa para a SET, escolhidos por modo), mas a janela não o oferece;
quem precisa do arquivo hoje não o obtém pela tela (no sistema antigo sim).
E um cuidado sobre a conferência já feita: os quatro gabaritos que bateram cobrem cinco dias e as colunas de valor. As colunas de rastreamento e um mês inteiro ficam para quando houver gabarito maior.
Nenhuma regra bate com essa busca. Tente um trecho menor da mensagem, ou limpe os filtros.