API | Bling - Homologação
Homologação Processo O processo de homologação é destinado a aplicativos com visibilidade pública, realizando integração com clientes do Bling. A primeira etapa consiste na revisão do uso da API. Após, é possível solicitar a revisão do aplicativo, onde os itens serão validados pela nossa equipe técnica conforme as regras descritas na seção validação de dados. Validação de dados
❌ Exemplo incorreto:
✅ Exemplo correto:
  • Logo: Deve ser condizente com a aplicação desenvolvida.
  • Nome do aplicativo: Nome que será exibido para os clientes do Bling.
  • Descrição: Descrição da solução proposta pelo seu aplicativo/plataforma.
  • Descrição curta: Descrição curta do aplicativo, utilizada na Central de Extensões. Deve ser uma descrição breve e objetiva da solução proposta pelo seu aplicativo/plataforma.
  • Categoria: Deve ser condizente com a solução proposta, assim o cliente poderá encontrar o seu aplicativo facilmente.
  • Link de redirecionamento: Conforme o fluxo de autorização, espera-se que, ao trocar o authorization_code pelo access_token, haja uma interface amigável para o usuário, tanto nos casos de sucesso quanto de erro. Esse fluxo ininterrupto facilita a experiência do usuário e a integração entre o seu aplicativo e o Bling.
  • Link da homepage: Recomenda-se que a página disponível pela URI possua uma descrição mais detalhada da solução que o aplicativo oferece, auxiliando, também, a promover e converter novos clientes. Aconselha-se que não necessite de autenticação para acessá-la.
  • Link do manual: Link para o manual do aplicativo.
  • Link do vídeo demonstrativo: Vídeo do Youtube ou Vimeo que apresenta as funcionalidades do aplicativo.
  • Escopos: Os escopos selecionados devem possuir relação com a finalidade do aplicativo.
Os itens apresentados acima são essencialmente utilizados na revisão dos dados cadastrados. No entanto, atente-se para a criação de um serviço seguro e bem otimizado. Qualquer indício de problema que possa prejudicar os nossos usuários fará com que o aplicativo seja inativado. Revisão Introdução Para iniciar o processo de revisão do aplicativo, acesse a aba "Homologação". Após confirmar o preenchimento dos dados, uma interface para acompanhar o processo será exibida. Caso ocorram inconsistências, elas serão exibidas e será necessário iniciar a revisão novamente. Já, se o teste for bem sucedido, será possível solicitar a revisão do aplicativo para a nossa equipe técnica. Execução O objetivo é validar o correto uso da API, através da execução de requests sequenciais para a API de homologação.
Em uma das etapas será invalidado o access token, nesse caso, utilize o refresh token.
A cada request realizado, será retornado no header um hash que deve ser informado no header do passo seguinte.
Exemplo de retorno do header:
x-bling-homologacao: iEL06HbaOdyrjw6F0cTk6z63ZOaI0Ezn0L43++ZjY/c= 1. O primeiro request deve ser feito para obter os dados que serão utilizados para o segundo request, utilizando o método GET. GET https://api.bling.com.br/Api/v3/homologacao/produtos Exemplo de resposta: 2. Realize o request para o endpoint de método POST informando, no body da requisição, os dados contidos na propriedade data, obtidos no primeiro passo. Será retornado o id do produto "criado", lembrando que o id é apenas para representar um novo produto. POST https://api.bling.com.br/Api/v3/homologacao/produtos Exemplo do body: Exemplo de resposta: 3. Após criar o produto, realize a alteração do atributo descricao para "Copo". Para isso utilize o método PUT, informando no path o id do produto obtido no passo anterior e no body informe os dados atualizados do produto. PUT https://api.bling.com.br/Api/v3/homologacao/produtos/16842381880 Exemplo do body: 4. Altere a situação do produto utilizando o método PATCH. A situação do produto deve ser informada no body. PATCH https://api.bling.com.br/Api/v3/homologacao/produtos/16842381880/situacoes Exemplo do body: 5. Por fim, remova o produto por meio do método DELETE. DELETE https://api.bling.com.br/Api/v3/homologacao/produtos/16842381880 Limites O tempo total do teste deve ser de no máximo 10 segundos.
O limite entre cada requisição é de 2 segundos.
Caso o limite seja atingido, revise a implementação e refaça a operação.
Situações As 5 situações de um aplicativo público são:
  • Em desenvolvimento: Ao salvar um aplicativo de visibilidade pública, no momento da criação, ele será salvo nessa situação.
  • Em revisão: Após o aplicativo estar desenvolvido e pronto para operar contas do Bling, na edição do aplicativo clique em "Solicitar revisão". Após, nossa equipe técnica fará a revisão.
  • Aprovado: Caso não haja incoerência, o aplicativo será aprovado.
  • Rejeitado: Havendo inconsistência no aplicativo, ele será rejeitado durante a fase de revisão. Se isso acontecer, você será notificado e os motivos da rejeição serão apresentados na edição do aplicativo. Realize os ajustes e salve o aplicativo, nesse momento uma nova revisão será solicitada. Durante a fase de rejeição o aplicativo funcionará como na fase de revisão.
  • Inativado: Caso sejam identificados ou reportados abusos, o aplicativo poderá ser inativado. Será notificado o problema encontrado e o aplicativo terá todos os tokens de acesso revogados. Para poder reativar o seu aplicativo, será necessário entrar em contato com a nossa equipe.
Se a situação do aplicativo for alterada, você será notificado no Bling. Caso a situação tenha sido alterada para rejeitado ou inativado, o motivo será informado na tela de edição do aplicativo.