nfscan / nfscan

NFScan is a free, open-source software, available to non-profit organizations to receive donations effectively.

nfscan

NFScan is a free, open-source software, available to non-profit organizations to receive donations effectively.

What's new in this version

• Create Cloudformation templates to allow easy deploy by anyone with an AWS account.
• Access AWS resources using IAM roles instead of hardcoded accessKeys and secretKeys.
• Remove references to BasicCredentials since we're gonna use AWSCredentialsChain for that.
• Parameterize backend username and password.
• Upgrade AWS sdk to 1.11.44.

Looking for older versions changes? Please take a look at CHANGELOGS.md

Setting up development environment

Walkthrough in Portuguese

Public API

Once you've set up your development enviroment you can make calls to nfscan's public API to process or donate receipts. We've created a wiki page containing all requests you should use in order to integrate with whatever app/site of yours.

Mobile

We've made an open source app for iOS that integrates with nfscan. You may use it as a reference model or even as a white label product. That's up to you.

Awards

[Bronze] :: Cannes Lions - Cyber Category	[Estrela Verde] :: CCSP - Ação beneficiente	[Grand Prix] :: B9 2015

Contributing

You're encouraged to contribute to nfscan. Fork the code from https://github.com/nfscan/nfscan and submit pull requests.

Make sure you're following the contributing guidelines for this project.

nfscan's Issues

Arquivo para Envio a Secretaria de Fazenda

Oi Boa Tarde,
Primeiro gostaria de parabenizar vocês pela Iniciativa.
Eu estou desenvolvendo um aplicativo para Doação de Notas Fiscais para Entidades Sociais e gostaria, se possível, da ajuda de vocês no sentido de me compartilhar o código de geração do arquivo para envio das NF a secretaria da fazenda.
Olhei as informações no GitHub mas não consegui encontrar essa parte do código.
Muito Obrigado e novamente parabéns.
Carlos.

Utilizar banco de dados localmente

Pergunta feita por Thiago Alves Gomes e colocada aqui para fins de documentação e referencias futuras:

Bom dia, Paulo. Tudo bem?

Tenho o objetivo de desenvolver um aplicativo para a instituição filantrópica na qual trabalho, com a finalidade de otimizar o moroso processo de obtenção de notas fiscais doadas.

Quando fui aprender mais sobre o aplicativo, me deparei com um artigo da wiki de vocês (https://github.com/nfscan/nfscan/wiki/Develpment-environment---%5BPortuguese%5D) que demonstra como criar um ambiente de testes utilizando o AWS da Amazon, criando a base de dados lá.

Porém eu tenho a preferência de criar o banco de dados localmente. Existe também um tutorial de como criar ambientes de teste com banco de dados local? Caso não, existem outros locais com informações sobre desenvolvimento utilizando NFScan?

Agradeço muito desde já.

Como melhorar a qualidade da imagem?

Oi Bom dia,
Parabéns pelo trabalho de vcs.
Estou desenvolvendo um sistema de OCR para plataforma Android usando Tesseract, mas os resultados do OCR não são satisfatórios.
Vcs poderiam compartilhar (quando mais detalhado melhor) que tipos de tratamentos de Imagem e os SW que foram usados antes de efetivamente usarem o OCR?

Obrigado,
Carlos.

IAM Role com erro na ARN

Olá, no tuto de instalação você coloca o recurso do SQS como sendo

{
...
"Resource": [
                "arn:aws:sqs:us-east-1:0000000:DES-NFSCAN-OCR-PROCESS-IN",
                "arn:aws:sqs:us-east-1:0000000:DES-NFSCAN-OCR-PROCESS-OUT"
            ]
...
}

Os 0's não funcionam.
2 soluções

A primeira é usar o *

"Resource": [
                "arn:aws:sqs:us-east-1:*:DES-NFSCAN-OCR-PROCESS-IN",
                "arn:aws:sqs:us-east-1:*:DES-NFSCAN-OCR-PROCESS-OUT"
            ]

A segunda é indicar como se procura o ARN

Isso vale também para as tabelas do Dynamo

Abraços,

Porcentagem de acertos?

Bom dia.

Parabéns pelo trabalho.

Estou tentando fazer uma implementação para a ONG Adote um Gatinho, mas tenho notado nos meus testes que em uma porcentagem muito alta de notas que eu escaneio (mais de 50%) os dados não são reconhecidos ou reconhecidos de forma errônea.

Exemplo, ao usar essa imagem teste de vocês ele identifica o COO como 001253 ao invés de 001440...

Queria saber se isso é esperado, qual porcentagem de acertos vocês têm observado normalmente?

Define the contributing guidelines

As the interest of developers are growing on nfscan, it seems only fair that we have a document that lists what it takes to write a code to be accepted in a Pull Request.

Create a installation template using CloudFormation

Documentação para desenvolvedores

Pergunta feita por Natany da Silva Lima e colocada aqui para fins de documentação e referencias futuras:

Boa tarde,

Gostaria de ajudar a multiplicar para outras entidades o modelo do sistema de vocês já que é open-source, além de com minha rede de contatos e amigos da área tentar ajudar da forma que podem no projeto de vocês.

Gostaria de saber, não fiz ainda o download mas no repositório para download tem documentação a respeito para desenvolvedores?

Tratamento quando a foto do cupom está meio torta

Pergunta feita por Tulio Faria e colocada aqui para fins de documentação e referencias futuras:

Boa noite Paulo,
primeiramente parabéns pelo projeto! Ficou muito legal, e principalmente útil!

Estive fazendo uns testes fazendo a captura de cupons fiscais, utilizando as mesmas libs que vocês usaram...

Vocês chegaram a fazer algum tratamento quando a foto do cupom está meio torta?

Abraços,

Tulio Faria

AWS Region no aws-context.xml

Olá

Uma melhoria seria parametrizar a região usada.

Eu usei Virgínia para desenvolver e o server está configurado para São Paulo.

Modifiquei assim o arquivo aws-context.xml:

<property name="endpoint" value="https://sqs.${aws.region}.amazonaws.com"  />

E no application-prop-des.properties coloquei a propriedade

aws.region=us-east-1