Eduardo_Montanhole

Olá Desenvolvedor! Hoje vamos esclarecer algumas diferenças entre Web Service e API que é algo que gera muita duvida por serem de certa forma bastante semelhantes. O que é uma API? API (Application Programming Interface) – Nada mais é que uma interface entre dois programas diferentes que os permite se comunicarem. Portanto, uma API é uma forma que terceiros disponibilizam para que possamos possamos consumir um determinado serviço através de sua interface sem nos preocuparmos com a implementação. As API's podem utilizar qualquer meio de comunicação para iniciar a interação entre as aplicações, como por exemplo as chamadas de sistema (System Calls) são invocados usando interrupções da API do kernel Linux. Web Services – Trata-se de interfaces projetadas para se comunicar via rede. É uma API que usa obrigatoriamente a rede. Tipicamente, HTTP é o protocolo mais comumente usado para a comunicação. Web Services também usam SOAP, REST e XML-RPC como meio de comunicação. Quando uma API precisa enviar dados através de rede, estamos falando de Web Services. Sendo assim podemos afirmar que todos os Web Services são API, mas nem todas as API são Web Service. Web Services podem não executar todas as tarefas que uma API normalmente realiza (ou pode realizar). Um serviço Web utiliza apenas três estilos de comunicação: SOAP, REST e XML-RPC enquanto que a API pode usar qualquer estilo de comunicação. Um Web Service sempre precisa de uma rede para o seu funcionamento enquanto uma API não precisa. Uma API facilita a interface direta com um aplicativo enquanto que um Web Service é uma aplicação.

Olá Desenvolvedor! Venho hoje apresentar o primeiro banco digital homologado pela Tecnospeed para REGISTRO E CONSULTA de boletos, o banco INTER! Atualmente a demanda pelos serviços de bancos digitais vem crescendo exponencialmente por se tratar de uma opção aos bancos tradicionais, oferecendo taxas e serviços diferenciados. Com isso trabalhamos intensamente nas homologações dos bancos digitais e o BANCO INTER foi escolhido como a primeira instituição a fazer parte de nosso portfólio, a atual homologação utiliza o registro via API Bancária, também conhecido como REGISTRO INSTANTÂNEO, tornando assim desnecessária a utilização de ARQUIVOS DE REMESA/RETORNO conforme o sistema tradicional de envio. COMO SOLICITAR O SERVIÇO DE COBRANÇA JUNTO AO BANCO INTER? Para começar a utilizar o registro instantâneo do Banco Inter, é necessário possuir um certificado digital emitido pelo próprio Banco, e ter uma conta ativa no mesmo. O certificado digital deverá ser emitido através da conta digital do cedente acessand:o https://contadigitalpj.bancointer.com.br/ Em nossa documentação técnica, temos um seção que explica o passo a passo da liberação no sistema do Banco Inter: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/4411173251991-Utilizando-o-registro-via-Web-Service-Bancário-com-o-Banco-Inter Toda a liberação da API, e geração do certificado digital é feita pelo sistema online do Banco Inter, sem necessidade de apoio da área técnica do banco. É comum que periodicamente o banco altere o layout de seu sistema, mas de modo geral, é necessário acessar o sistema do banco, fazer a liberação da API e na sequência baixar o certificado digital que será gerado juntamente com as chaves de uso da API. Como fazer o registro dos títulos? Após as devidas liberações no site do banco, você precisa fazer o download da documentação técnica e integrar o seu sistema com a API do banco. É importante ressaltar que este trabalho é bastante técnico, e é necessário seguir detalhadamente o que a documentação do banco solicita, para evitar erros de autenticação e falhas na emissão. O processo de emissão basicamente consiste em: Autenticar a API; Fazer o registro dos títulos; Gerar a impressão; Efetuar a consulta de situação. E todas estas funcionalidades estarão disponíveis na documentação para que você providencie a integração com seu sistema. COMO REGISTRAR BOLETOS NO BANCO INTER UTILIZANDO O PLUGBOLETO? Conforme adiantamos no começo deste post, a Tecnospeed integrou o Banco Inter em sua API de emissão de boletos! Portanto, o PlugBoleto já conta com este novo banco disponível para nossos clientes. Deste modo, para utilizar o registro no banco Inter via PlugBoleto, é necessário apenas fazer as liberações com o banco, configurar as informações da conta e certificado no PlugBoleto, e se integrar conosco. E caso você já utilize o PlugBoleto, porém emitindo por outro banco, poderá utilizar o nosso layout padronizado de emissão. Ou seja, a mesma integração feita para bancos tradicionais será a base para o Banco Inter, diminuindo muito o esforço de desenvolvimento de sua equipe! Então, passaremos um pouco mais de detalhes sobre esta configuração: O primeiro passo é cadastrar a conta na área do cedente: Após cadastrar a conta é necessário cadastrarmos o convenio da conta e ativar o a opção de REGISTRO INSTANTÂNEO: E por fim basta cadastrar o certificado disponibilizado pelo banco na aba "MEUS DADOS". E PRONTO! O cedente já esta apto a REGISTRAR e CONSULTAR boletos junto ao banco INTER em nossa api PlugBoletos Caso tenha qualquer dúvida sobre este processo de emissão ou queira conhecer melhor os nossos serviços fique a vontade para comentar abaixo, será um prazer te atender!

Ola Desenvolvedor! Hoje explicaremos sobre a propriedade “user-agent” no PHI, que nada mais é que um parâmetro necessário para o envio de algumas requisições HTTP/HTTPS, como por exemplo, necessário na integração de sistemas escritos em PHP com nossas APIs do Pix, Plugboleto e Pagamentos. O que é o User-agent? O cabeçalho de requisição "User-Agent" é uma cadeia de caracteres característica que permite aos servidores e pares de rede identificar a aplicação, sistema operacional, fornecedor, e/ou versão do agente de usuário requisitante. Por padrão, a configuração user_agent no php.ini é utilizada pois no .ini ficam registradas as configurações, e ele possui diretivas de como o PHP deve ser comportar quanto a uso de memória, caminhos, módulos instalados e seus próprias configurações, quais partes do PHP podem ser usados e como serão, limites de uso diversos, etc. Exemplo de definição do parâmetro A informação de User-Agent é enviada ao servidor que recepcionará a REQUISIÇÃO via cabeçalho conforme informado acima e poderá ser acessado como: $_SERVER["HTTP_USER_AGENT"] O valor deste cabeçalho será algo como: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36 OPR/46.0.2597.57 Feita esta definição, a requisição HTTP tende a não gerar mais falhas na integração com mensagens de erro relacionadas ao user-agent. Porém, caso persista o erro fique a vontade para comentar neste post, será um prazer ajudar!

Ola Desenvolvedor! Já se perguntou qual a diferença entre protocolo HTTP E HTTPS? Vamos explicar de forma bem simples quais as principais diferenças entre as duas formas de envio de requisições. Protocolo HTTP O protocolo de transferência de hipertexto (HTTP – HyperText Transfer Protocol) é o protocolo padrão para a Web, o HTTP especifica, entre outras informações, como serão feitas as requisições. No entanto, como o HTTP é um protocolo baseado em texto, portanto, toda a informação transmitida é enviada em texto, com isso cria-se uma facilidade na interceptação de manipulação dos dados enviados, considerando o contexto apresentado, quando é disparado uma REQUISIÇÃO utilizando o protocolo HTTP os dados enviados estão os dados estão suscetíveis a serem inteceptados/fraudados com muita facilidade. Metodos de requisições utilizados: O protocolo HTTP utiliza métodos de requisições predefinidos que informam ao servidor qual tarefa ele deve executar no recurso desejado: GET requisição de um recurso POST adiciona/cria um recurso PUT modifica diretamente um recurso DELETE remove um recurso específico PATCH modifica parcialmente um recurso Protocolo HTTPS Via de regra o HTTPS é definido como HTTP Seguro que nada mais é que um HTTP com o SSL (Secure Sockets Layer) ou seu sucessor, o TLS (Transport Layer Security). TLS ou SSL são camadas de segurança que fornecem confidencialidade e integridade às REQUISIÇÕES. Basicamente o HTTPS criptografa e descriptografa as requisições do usuário bem como as respostas do servidor. O uso do HTTPS protege contra ataques conhecidos que visam interceptar essas requisições e sequestrar dados sensíveis. O que é o SSL SSL é a abreviação de Secure Sockets Layer, nada mais é que uma ferramenta de encriptação de páginas antes de serem transmitidas pela internet autentifica as partes envolvidas. É muito utilizada para pagamentos online com cartão de crédito. Diversas versões dos protocolos de segurança estão em uso generalizado em navegação na web, serviços de e-mail, mensagens instantâneas e VoIP. Qual o protocolo utilizado nos produtos TECNOSPEED? Em nossos produtos temos disponível as duas formas de envio de requisições, pelo fato de que em nossa base de clientes ainda existem Software Houses que utilizam linguagens antigas que não tem suporte ao protocolo HTTPS, porem recomendamos fortemente que utilizem envios HTTPS pelos motivos de segurança que abordamos acima.

Olá desenvolvedor! Neste post iremos disponibilizar à você algumas informações adicionais referentes ao MOVIMENTO: Entrada rejeitada, Beneficiário não cadastrado ou possui CGC/CIC inválido. Esta rejeição será retornada quando o cedente que está tentando efetuar o registro do título não está devidamente cadastrado na base de dados bancária , ou mesmo por alguma divergência nos dados de cedente declarados. Pode também estar relacionado a algum problema com o CGC-Cadastro Geral de Contribuintes ou CIC - Cartão de Identificação do Contribuinte que foi substituído pelo Cadastro de Pessoa Física “CPF”. Como corrigir: Para corrigir o erro acima basta entrar em contato com o banco e realizar o alinhamento das informações enviadas no boleto com base nos dados cadastrados junto ao banco, caso as informações enviadas no boleto realmente estejam corretas então a origem do problema deve estar relacionada ao cadastro do CGC ou CIC, para resolução desta situação deve ser feita a consulta junto aos órgãos governamentais responsáveis para regularização dos dados. Como corrigir nas soluções Tecnospeed: Em nossa plataforma, identifique a conta que foi previamente cadastrada , e realize a conferência de acordo com os dados fornecidos pelo banco, para assim realizar a nova tentativa de registro. Caso tenha qualquer dúvida sobre o cenário explicado ou se quiser conhecer nossas soluções voltadas à automatização na geração de boletos, estaremos sempre à disposição, será um prazer ajudar!

Olá desenvolvedor! Hoje falaremos a respeito de um tipo de arquivo disponibilizado pela CEF, chamado de retorno de "Pré-Crítica". Atualmente o único banco que utiliza esse tipo de serviço é a CEF, vamos então explicar de forma bem sucinta qual a finalidade deste arquivo. O que é o retornos Pré-Critica? Esse arquivo nada mais é do que um retorno preliminar que o banco disponibiliza e que a principio serve para informar ao cedente de que a remessa enviada foi recebida e sua estrutura foi aceita, ou seja, não existem erros estruturais na remessa enviada. Porem o recebimento desse retorno não quer dizer que a as instruções contidas na remessa serão acatadas pelo banco essa confirmação só será confirmada com a disponibilização do arquivo de retorno final por parte do banco.

Olá Desenvolvedor! Hoje abordaremos uma das principais informações contidas em um boleto de cobrança bancaria que trata-se do NOSSO NUMERO, que nada mais é que um campo numérico que identifica o documento bancário como único . Essa informação é disponibilizada também nos extratos bancários quando o boleto é LIQUIDADO pelo sacado, portanto cada titulo deve ter seu próprio número. Algumas instituições bancarias definem uma faixa de nosso numero a ser utilizada pelo cedente, porém em sua grande maioria deixa essa informação livre a critério do beneficiário. RECOMENDAÇÕES QUANTO A IMPLEMENTAÇÃO DO CAMPO Quando abordamos o Nosso Número com uma ótica de desenvolvedor devemos tomar alguns cuidados em sua implementação pois trata-se da identificação do titulo. As instituições bancarias não especificam que a numeração contida no campo deve ser "SEQUENCIAL" mas sim que não deve se repetir, pois caso ocorra tal situação o boleto será rejeitado. Recomendamos que mesmo não sendo obrigatório a utilização de um sequencial seja implementado em sua solução dessa forma pois assim facilita-se o gerenciamento da numeração, além do melhor aproveitamento da faixa numérica utilizada.

Olá Desenvolvedor ! Hoje abordaremos a utilização/envio de remessas de alteração de boletos bancários, pois ainda existe bastante duvida a respeito da utilização dessa funcionalidade. Então abordaremos de forma clara, possível como se dá a utilização das remessas de alteração. As remessas de alteração são uma alternativa para correção ou até mesmo baixa de títulos que já encontram-se como registrados junto as instituições bancárias, vale salientar que para boletos em qualquer outra situação não é indicado que sejam enviadas remessas dessa natureza. Quando trata-se de uma REMESSA DE BAIXA geralmente os bancos aplicam um tarifa em sua utilização, já as REMESSAS DE ALTERAÇÃO DE DADOS via de regra não tem custos em sua utilização (mas isso pode variar de banco para banco). Tipos de alteração disponíveis: As alterações disponíveis para utilização de acordo com o manual da FEBRABAN V10.7 são: Pedido de Baixa Concessão de Abatimento Cancelamento de Abatimento Alteração de Vencimento Concessão de Desconto Cancelamento de Desconto Confirmação de Repactuação Alteração de Outros Dados Alteração de Dados do Comprador Alteração de Dados do Título Remessas de alteração mais utilizadas atualmente: É possível dentre as alterações disponíveis elencar as mais utilizadas, em outras palavras as remessas que são indispensáveis para serem implantadas em sua solução, e são elas : Pedido de Baixa Concessão de Abatimento Cancelamento de Abatimento Alteração de Vencimento Alteração de Outros Dados Como a Tecnospeed trabalha com remessas de alteração? Em nossa API PlugBoletos trabalhamos com remessas de alteração de forma muito simplificada, onde para gerar remessas de baixa é necessário apenas informar a identificação do titulo no body da requisição e para os demais tipos de alteração é informado a identificação do titulo juntamente com os dados a serem alterados então montamos o arquivo e o disponibilizamos na resposta da requisição pronto para o envio ao banco. É importante lembrar que as remessas de alteração também estão incluídas no processo de TRANSMISSÃO AUTOMATICA (VAN), ou seja, as remessas de alteração são enviadas automaticamente quando o cedente possui a VAN bancária ativa em seu convenio.

Olá desenvolvedor! Neste post iremos disponibilizar à você algumas informações adicionais referentes a mensagem de erro: “(640) OPERACAO NAO PERMITIDA - CEDENTE INFORMADO NAO POSSUI AUTORIZACAO PARA UTILIZAR SERVICO WEBSERVICE”, apresentado pelo WebService bancário da Caixa. Este erro será apresentado quando o cedente que disparou a requisição de REGISTRO via WEBSERVICE ainda não finalizou o processo de ativação do registro via WS junto ao banco , ou seja, não possui liberação do banco para registrar via WebService, ou mesmo por alguma divergência nos dados de cedente declarados na requisição com os dados cadastrados no banco. Mensagem de erro A mensagem de erro “OPERACAO NAO PERMITIDA - CEDENTE INFORMADO NAO POSSUI AUTORIZACAO PARA UTILIZAR SERVICO WEBSERVICE” ocorre quando os dados de cedente enviados na requisição de registro possui divergências no cadastro junto ao banco ou o mesmo não possui a liberação para utilização do WEBSERVICE. Como corrigir: Para corrigir o erro acima basta entrar em contato com o banco, e realizar o alinhamento das informações enviadas na requisição junto aos dados cadastrados no banco caso os dados estejam corretos deve-se conferir junto ao gerente se a conta do cedente realmente possui a liberação para utilização do WEBSERVICE. Como corrigir nas soluções Tecnospeed: Em nossa plataforma, identifique a conta que foi previamente cadastrada , e realize a conferencia de acordo com os dados fornecidos pelo banco, verifique se a opção de “registro instantâneo” está selecionada no respectivo convênio do cedente, e dê inicio nas emissões com este novo serviço. Motivos para utilizar o WebService O recurso da transmissão instantânea (WebService) é um método de comunicação direta com as APIs dos bancos, tendo assim uma resposta instantânea sobre a situação de seu boleto, ou seja, já no momento da emissão é feita uma comunicação com os servidores bancários, e os boletos já são autorizados ou rejeitados, permitindo assim que os clientes façam o pagamento logo após a emissão dos títulos, sem precisar aguardar o dia útil padrão de processamento de remessas, pois este serviço não utiliza o arquivo de remessa para o registro do boleto. Caso queira conhecer como fazer a configuração no ambiente da Tecnospeed, clique aqui e conheça nossos produtos! Caso tenha qualquer dúvida sobre o cenário explicado ou se quiser conhecer nossas soluções voltadas a automatização na geração de boletos, estaremos sempre à disposição, será um prazer ajudar!

Bom dia Josselir! Poderia ser um pouco mais especifico em que ponto esta com duvidas? Pois varia de banco para banco e também qual a rota que necessita utilizar. Att.

Bom dia Jairo! O novo certificado ja foi homologado pelo banco?

Bom dia Jairo! Quanto tempo após o upload do certificado tentou emitir o boleto?

Bom dia Jairo! Como não houve mais interações nesse post irei fecha-lo, porem estamos a disposição caso haja qualquer duvida! Att.

Bom dia Marcelo! Estou fazendo o envio do arquivo via e-mail nesse momento. Att.

Ola @jairo! Verifiquei que seu post ficou sem resposta peço desculpas por isso, quero saber se ja conseguiu resolver essa questão caso nao tenha conseguido, vamos seguir com o atendimento. Aguardo seu retorno. Att.

Ola @Madson Martins O método de autenticação para receber o webhook é personalizável. Fica a critério do cliente analisar o que é melhor para ele. Pode ser Bearer, Basic, ou até não ter autenticação. No momento do cadastro da configuração do webhook, é possível informar quais headers o webhook enviará. Durante a configuração do webhook, você pode passar o parâmetro Authorization e informar o Bearer ou Basic Token, por exemplo, necessário para acessar sua aplicação. Qualquer duvida fico a disposição para te auxiliar. Att.

Olá desenvolvedor! Neste post iremos disponibilizar à você algumas informações adicionais referentes a mensagem de erro: “(640) OPERACAO NAO PERMITIDA - CEDENTE INFORMADO NAO POSSUI AUTORIZACAO PARA UTILIZAR SERVICO WEBSERVICE”, apresentado pelo WebService da Caixa Econômica Federal (104). Este erro será apresentado quando o cedente que disparou a requisição de REGISTRO via WEBSERVICE ainda não finalizou o processo de ativação do registro via WS junto ao banco , ou seja, não possui liberação do banco para registrar via WebService, ou mesmo por alguma divergência nos dados de cedente declarados na requisição com os dados cadastrados no banco. Mensagem de erroA mensagem de erro “OPERACAO NAO PERMITIDA - CEDENTE INFORMADO NAO POSSUI AUTORIZACAO PARA UTILIZAR SERVICO WEBSERVICE” ocorre quando os dados de cedente enviados na requisição de registro possui divergências no cadastro junto ao banco ou o mesmo não possui a liberação para utilização do WEBSERVICE da Caixa. Como corrigir:Para corrigir o erro acima basta entrar em contato com o banco, e realizar o alinhamento das informações enviadas na requisição junto aos dados cadastrados no banco caso os dados estejam corretos deve-se conferir junto ao gerente se a conta do cedente realmente possui a liberação para utilização do WEBSERVICE da CEF. Como corrigir nas soluções Tecnospeed:Em nossa plataforma, identifique a conta que foi previamente cadastrada , e realize a conferencia de acordo com os dados fornecidos pelo banco, verifique se a opção de “registro instantâneo” está selecionada no respectivo convênio do cedente, e dê inicio nas emissões com este novo serviço. Motivos para utilizar o WebService O recurso da transmissão instantânea (WebService) é um método de comunicação direta com as APIs dos bancos, tendo assim uma resposta instantânea sobre a situação de seu boleto, ou seja, já no momento da emissão é feita uma comunicação com os servidores bancários, e os boletos já são autorizados ou rejeitados, permitindo assim que os clientes façam o pagamento logo após a emissão dos títulos, sem precisar aguardar o dia útil padrão de processamento de remessas, pois este serviço não utiliza o arquivo de remessa para o registro do boleto. Caso queira conhecer como fazer a configuração no ambiente da Tecnospeed, clique aqui e conheça nossos produtos! Caso tenha qualquer dúvida sobre o cenário explicado ou se quiser conhecer nossas soluções voltadas a automatização na geração de boletos, estaremos sempre à disposição, será um prazer ajudar!

Ola Desenvolvedor! Muitas empresas têm problemas com o tempo de registro de seus boletos, pois no processo tradicional de REGISTRO de títulos com as instituições bancarias existe o tempo de espera entre o envio arquivo de REMESSA que é feito pelo cedente e a espera do processamento por parte do banco para assim conseguir a recepção do arquivo de RETORNO, por esse motivo seus boletos ficam disponíveis para pagamento com o mínimo 1 dia útil, impossibilitando assim o pagamento do boleto na mesma data de sua emissão. O que é o Registro instantâneo ou registro via WEB SERVICE ? O termo TRÂNSMISSÃO INSTANTÂNEA refere-se ao registro online de boleto, esse processo também é conhecido como registro via webservice bancário, nesta modalidade de envio é disparada uma requisição com os dados do título a ser registrado pelo banco e imediatamente é devolvido a resposta via API com o aceite do título ou rejeição, caso a resposta da API bancaria seja positiva para o registro o título já estará disponível para pagamento imediatamente. A transmissão instantânea pode ser chamada também de registro online, registro e-commerce ou registro via webservice. Como a TECNOSPEED utiliza essa funcionalidade em sua API. Nossa API de emissão de boletos PlugBoleto envia uma requisição para a API do banco com os dados informados pelo cedente e em poucos segundos recebemos via webservice a devolutiva do banco com a instrução de REGISTRO ou REJEIÇÃO. Simples assim! Depois do retorno positivo do banco, o boleto já pode ser enviado para o cliente ou impresso e ele estará pronto para ser pago.

Ola @jairo! Segundo nossa documentação neste campo pode ser informado o Acessório Escritural(Verificar essa informação com o banco), talvez pelo nome do campo o gerente de conta não tenha entendido solicite a informação dessa forma novamente. Segue Link da Doc: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360015259873-Banco-Bradesco Qualquer duvida estamos a disposição! Att.

Ola @vallef! Nosa API se adapta a qualquer modelo de negocio, não teremos problemas a respeito da integração com seu CRM. Qualquer duvida estou a disposição! Att.

Olá @Denis Monteiro! Da para integrar no API para impressão com QRCode em delphi sem problemas, o procedimento é feito através da integração das ROTAS da Api em seu código. Att.

Olá @Guilherme Viana Creio que a atualização que passei para o Fabricio também caiba em sua pergunta, segue abaixo citada. Qualquer duvida estou a disposição! Att.

Boa tarde Marcelo! Primeiramente peço desculpas pela demora, estávamos em um processo de migração da plataforma do HUB que finalizamos Sexta-feira. Conforme imagem abaixo as na consulta do titulo em nossa API é disponibilizado no campo "TituloMovimentos" os movimentos que alteram as situações do titulo e dentro desse campo existe o campo "ocorrências" que lista as mesmas, no exemplo abaixo não contem ocorrências mas é ali que são disponibilizadas. A respeito dos campos como ValorJuros, Valor desc. e etc. Também estão listados na consulta do boleto. Segue exemplo : Qualquer duvida estou a disposição! Att.

Boa tarde Jairo! Identifiquei que o titulo trata-se do mesmo caso que estamos analisando no outro post. Creio que essa questão será sanada juntamente com a resolução anteriormente citada. Att.

Boa tarde @jairo! Primeiramente peço desculpas pela demora, estávamos em um processo de migração da plataforma do HUB que finalizamos Sexta-feira. Sobre sua questão levantei o cenário e identifiquei que o registro do boleto via webservice esta sendo feito com o código de beneficiário 22546 e o retorno do banco esta sendo disponibilizado com o beneficiário de número 4869. Sabe me dizer se essa troca de beneficiário realmente deve acontecer para esse cedente? Preciso desse mapeamento para tratarmos a situação. Att.