Skip to main content
Lê o conteúdo de um documento da fatura em PDF ou XLSX e entrega o texto ao assistente. A leitura acontece no servidor da Pipo. O assistente não precisa abrir nenhum link. A ferramenta reconhece o formato pelo conteúdo do arquivo. Use o fatura_id de listar_faturas e o documento_id de listar_documentos_fatura. Cada chamada confere de novo a empresa, a fatura e o arquivo.
  • PDF: devolve o texto de até 5 páginas por chamada. Uma página longa pode vir em mais de uma parte.
  • XLSX: devolve a lista de abas e as células de uma aba, com o endereço (por exemplo, B7), o valor e o formato. Células com zero também aparecem. Cada chamada traz até 200 células.
Fórmulas de planilha não são recalculadas. A ferramenta mostra só o último resultado salvo no arquivo. Esse resultado pode estar desatualizado ou faltar. A ferramenta também não soma subtotais. Confira os totais no arquivo original antes de usar o número.
O conteúdo do documento não confirma pagamento, quitação nem saldo devedor. Em PDF, a extração pode perder o desenho das tabelas.

​
O que a ferramenta não lê

  • Arquivos com mais de 10 MiB.
  • Páginas digitalizadas (imagem sem texto). Não há OCR. A resposta avisa quando uma página não tem texto.
  • Planilhas no formato XLS antigo, arquivos ZIP e arquivos protegidos por senha.
  • Planilhas com macros. A ferramenta também não abre os links da planilha.
  • PDF com mais de 10 000 páginas. XLSX com mais de 100 abas ou mais de 200 000 células em uma aba.
Nesses casos, baixe o original com obter_documento_fatura. Se a leitura estiver ocupada, tente de novo em instantes.
A ferramenta oculta textos com o padrão de CPF e de e-mail. Isso não é uma anonimização completa: nomes e outros dados pessoais podem continuar no texto. A Pipo não guarda o arquivo nem o texto lido.

​
Parâmetros

Não misture os parâmetros: em um PDF, não use os parâmetros de aba e célula; em um XLSX, não use os parâmetros de página.
Cada resposta tem até 64 KiB. Quando o documento continua, a resposta traz next_uri. Use ler_pagina_faturamento com o next_uri até o fim do documento. A continuação termina o trecho atual antes de passar para a próxima página ou aba.

​
Exemplos de perguntas

  • “O que diz o demonstrativo da fatura de setembro?”
  • “Quais valores aparecem na planilha de demonstrativo desta fatura?”
  • “Qual a data de vencimento escrita no boleto desta fatura?”