Como migrar uma integração API V2 para V3

Você é desenvolvedor? Então, atenção:

Se você utiliza a integração com o Bling através da API V2, já deve saber que ela será descontinuada no dia 15/01/2025.

Por isso, convidamos você a fazer a transição para a V3 o mais breve possível, a fim de garantir a continuidade das suas operações.

Estruturamos uma documentação completa para você, desenvolvedor, realize essa mudança, confira

Não é desenvolvedor? Não se preocupe, a gente te explica: 

As integrações API são feitas por empresa, plataformas e/ou pessoas desenvolvedoras, que conectam o Bling às suas plataformas terceiras para complementar as suas operações.

Portanto, a migração da integração deve ser feita pela empresa desenvolvedora da integração.

Sendo assim, basta você seguir os passos:

1. Verifique se a sua integração é API, veja como
   
   
2. Verifique se ela já está na versão 3
   
   
3. Integre a versão 3, acessando o ícone de Central de Extensões . Localize a integração e clique nela para autenticar.
   *Não localizou a integração? Acione a plataforma, ou desenvolvedor, que habilitou a integração para você, informando que a sua integração do Bling precisa ser atualizada para a v3.
   
   
4. Após integrar com a versão 3 e realizar a migração, você poderá excluir o 'usuário API' criado para a V2, e assim interromper os serviços da API V2. Veja como:
   Posicione o mouse sobre o ícone da engrenagem  e clique em 'Todas as Configurações > Sistemas > Usuários e usuário API'. 
   Encontre o usuário API cadastrado para a integração API, selecione ele, e clique no ícone de lixeira para excluir.

O que você precisa saber sobre a V3

A API V3 é uma evolução da API V2

Ela é pensada em melhorias, para atender melhor às necessidades das integrações entre sistemas parceiros e o Bling.

A API V3 foi estruturada no padrão REST

Nele, você poderá utilizar métodos GET, POST, PUT, PATCH e DELETE.

 A API V3 é mais segura

Como ela utiliza o meio de autenticação OAuth 2.0, no qual é possível acessar recursos do sistema de forma limitada e mais segura.

Benefícios da V3

Caso o seu objetivo seja integrar com o Bling pensando em operar múltiplas contas, a API V3 possui um mecanismo de homologação que valida sua integração de forma rápida.