pagarme / superbowleto

:football: A microservice to issue, register and manage boletos
MIT License
5 stars 0 forks source link

Boletos registrados, remesas #289

Closed GlauberF closed 5 years ago

GlauberF commented 6 years ago

Help

Olá, curti bastante a iniciativa e estou buscando algo, porem tenho algumas dúvidas.

1 - existe uma documentação mais elaborada 2 - consigo gerar boleto registrado 3 - consigo gerar remesa 4 - como faço para incluir um novo banco , uma documentação para isso ? com isso também posso contribuir com o projeto.

evaporei commented 6 years ago

Olá @GlauberF, tudo bom? 1 - Então, toda documentação que temos hoje é a que está no arquivo README.md. Caso tenha algo que precise e que não está claro nela ou está faltando, por favor nos diga que podemos melhorá-la :wink: . 2 - Com o projeto, você consegue sim gerar boletos registrados, basta passar os parâmetros corretos. A rota de POST em /boletos recebe o valor register, o qual define se o boleto enviado deve ou não ser registrado. 3 - O que seria uma remesa? Se for uma grande quantidade de boletos, hoje não é possível sem criar várias requisições. 4 - Hoje temos uma camada de abstração chamada provider. Para adicionar um novo banco, é necessário adicionar mais um. Por hora temos somente o Bradesco como opção.

Quanto a contribuições, temos o arquivo CONTRIBUTING.md que indica algumas regras sobre o assunto. Além disso, no próprio README.md temos algumas informações de como rodar o projeto localmente. Se estiver com dificuldade sobre algum aspecto pode perguntar por aqui mesmo. Você também pode olhar outras contribuições aqui: Pull Requests.

Muito legal o seu interesse sobre o projeto :smiley: É para isso que temos repositórios open-source como esse.

GlauberF commented 6 years ago

Perfeito, Por exemplo para o banco que hoje esta rodando Bradesco, posso fazer uso/emissão de boletos registrados e não registrados, certo ? Se sim, com isso eu vejo como foi implementado e me baseio para outros bancos.

E quando falo remessa é a questão de gerar os CNAB 400|240, obter retorno EDI,r baixa automática do boleto etc...

existe alguma coisa de autenticação hoje, tipo jwt? tem algum file, onde tem um exemplo de objeto completo que pode ser enviado via post

evaporei commented 6 years ago

Para gerar um boleto não é necessário nenhum banco. Um boleto nada mais é do que um número o qual representa uma transferência de um valor de uma conta para outra. Porém para esse boleto gerado ser válido, é necessário ter uma carteira de boletos no banco. Para gerar o número desses boletos utilizamos a nossa biblioteca node-boleto. Já para o registro de boletos é necessário uma comunicação com um banco que registra. No caso o superbowleto possui a comunicação somente com o banco Bradesco.

Lembrando que quando se emite para um banco x, deve se registrar no mesmo. Além do que a partir de 21/07/2018 todos os boletos deveriam ser registrados, segundo o cronograma da FEBRABAN.

Quando se fala de processamento de edi files o superbowleto não possui nada implementado para tal, sua responsabilidade envolve apenas o registro de boletos.

Portanto para conciliar os boletos emitidos/registrados é necessário se comunicar com uma empresa que fornece serviço de VAN (Value Added Network). Através dela conseguirá realizar a troca desses arquivos de forma segura :slightly_smiling_face:

GlauberF commented 6 years ago

Perfeito @otaviopace , agora estamos alinhados hehe, então acho que talvez eu me expressei mal. Minha dúvida/pergunta/guide é, como eu faço para criar uma nova comunicação, com outro banco ?

E segundo, verifiquei que tem auth, qual rota utilizo para registrar um novo user, para utilizar o microserviço ?

Sugestão

sou ADM da página mundo javascript, o que você acha de fazermos um hangout mais técnico/prático sobre o superbowleto , com isso alem de ter como registro um vídeo que explana melhor o ecossistema, também podemos encontrar novas pessoas para contribuir com o projeto. podendo levar a outro patamar. sobre isso, podemos conversar via linkedin: https://www.linkedin.com/in/glauber-funez/

evaporei commented 6 years ago

Para criar uma nova comunicação com um novo banco seria necessário adicionar uma nova pasta aqui com o nome do novo banco o qual irá se integrar. Eu recomendo dar uma olhada na pasta do bradesco para ter uma noção de como uma integração pode ser feita :slightly_smiling_face:

Quanto a autenticação o serviço, ela é feita por esse middleware. Ela funciona da seguinte forma: toda requisição enviada ao superbowleto precisa de um header HTTP chamado x-api-key, então ao passá-lo, será verificado se ele é o mesmo que existe em uma chave no credstash (serviço de chave e valor encriptados pela Amazon). Ou seja, fica mais ou menos assim:

superbowleto_diagrama_autenticacao

Eu topo com certeza uma call para falarmos mais sobre o projeto! Como podemos realizá-la?

GlauberF commented 6 years ago

Pefeito @otaviopace , então mandei uma solicitação no linkedin para você, vamos alinhar por lá a call/live

mariohmol commented 6 years ago

Olá!! Me tira uma dúvida? Esta comunicação de boleto a registrar, é possível ser feito direto ao banco ou temos que usar algum serviço da pagar.me para enviar?

Outra coisa, existe alguma implementação para geração de CNAB (arquivo remessa) ?

Obrigado!

GlauberF commented 6 years ago

Olá @mariohmol , respondendo suas perguntas.

mariohmol commented 6 years ago

Obrigado pela resposta! Fiquei na duvida como funciona essa comunicacao direta com o banco, alguma referencia ou doc?

Iniciei um projeto de cnab se alguem interessar em colaborar

https://github.com/mariohmol/nodejs-cnab