TOTVS API Carol funciona como um facilitador no preenchimento de cadastros de clientes e fornecedores no Protheus, economizando tempo e fornecendo dados mais precisos. Ao inserir o número do documento, a API preenche automaticamente alguns campos necessários. Essa funcionalidade está disponível para as versões 12.1.27 ou superiores do Protheus, e não requer nenhum custo adicional para atualização.
Apesar de ser uma novidade interessante, muitas dúvidas têm surgido sobre a API, como sua origem de dados, se funciona para CPFs e CNPJs, e se é uma ferramenta on-line. Este artigo responde a essas perguntas.
A origem dos dados usados pela TOTVS API Carol é o portal de Dados Públicos CNPJ da Receita Federal, que é atualizado a cada três meses. Portanto, empresas cadastradas antes deste período podem não ser encontradas pela API. A API Carol é focada em CNPJs e não puxa dados de CPFs de pessoas físicas. Portanto, se a maioria dos seus clientes são pessoas físicas, infelizmente essa ferramenta não poderá realizar o preenchimento automático.
Ao inserir o número de CNPJ de uma empresa no cadastro de clientes ou fornecedores, a TOTVS API Carol preenche automaticamente alguns campos, como mostrado na imagem abaixo:
Para preparar o Protheus para utilizar a API Carol, é um processo bastante simples.
Se você estiver usando a versão 12.1.33 ou superior, basta modificar dois parâmetros no configurador do sistema. Um para o cadastro de fornecedores e outro para o cadastro de clientes. Os parâmetros são:
MV_APIFOR = .T. (fornecedores) MV_APICCGC = .T. (clientes)
Se sua empresa estiver usando a versão 12.1.27, será necessário:
Atualizar o pacote acumulado do BackOffice ou, individualmente, o pacote de compras e o pacote de faturamento. Executar o UPDDISTR do pacote. Após essas etapas, atualize os parâmetros:
MV_APIFOR = .T. (fornecedores) MV_APICCGC = .T. (clientes)
IMPORTANTE: Se a sua empresa utiliza firewall, é necessário liberar o endereço https://app.carol.ai/api no firewall da rede para que a ferramenta funcione corretamente.
Para usar a API Carol, basta informar um CNPJ válido no campo CNPJ/CPF na tela de inclusão de cadastros, e os dados serão preenchidos automaticamente.
TOTVS API Carol x Mashups
Ao compararmos a TOTVS API Carol com os Mashups, que muitos de vocês já estão acostumados a utilizar no dia a dia, podemos destacar alguns pontos importantes.
Assim, é possível notar que há pontos positivos e negativos tanto na TOTVS API Carol quanto nos Mashups, sendo responsabilidade da empresa avaliar qual das duas opções é a melhor para suas necessidades.
