Clientes e fornecedores
- Cadastrar o cliente que entrou pelo seu sistema
- Consultar a lista de clientes, página por página
Ligue o seu sistema, a sua loja ou o seu PDV ao Berga com uma chave de API. A integração usa a mesma API das telas do Berga e faz o que o usuário dono da chave pode fazer.
curl \
-H "x-api-key: SUA_CHAVE" \
"https://api.berga.app/persons?page=1&pageSize=20"A chave abre a mesma API que as telas do Berga usam. Alguns exemplos:
Cada chamada respeita as permissões do usuário dono da chave e o plano da sua empresa.
Em Integrações › API Keys, clique em Nova Chave. Quem cria precisa da permissão Gerenciar integrações.
Dê um nome que diga onde a chave vai ser usada, como "PDV Caixa 01", marque Token de automação e escolha 1 ano, 6 meses, 90 dias ou sem expiração.
Ela aparece uma única vez. Guarde num cofre de senhas ou direto na configuração do seu sistema.
Toda chamada para https://api.berga.app leva o cabeçalho x-api-key com a chave.
GET /persons?page=1&pageSize=20
x-api-key: SUA_CHAVEA chave tem as permissões de quem a criou. Para limitar o que a integração faz, crie a chave com um usuário só para ela, num perfil com o necessário.
A chave enxerga apenas a empresa em que foi criada.
Escolha a validade ao criar e revogue quando quiser em Integrações › API Keys: a chave para na hora.
A chave aparece só na criação. Perdeu? Revogue e crie outra.
Não. A chave de API está em todos os planos. O que ela acessa segue o plano da sua empresa e as permissões do usuário dono da chave.
Conte pelo contato o que você quer integrar, e enviamos as rotas e um exemplo para o seu caso.
Pode. Crie uma por sistema ou por caixa, cada uma com o seu nome, e revogue só a que precisar.
Não. A chave vale só para a empresa em que foi criada: crie uma chave em cada empresa.
Revogue em Integrações › API Keys: ela para de funcionar na hora. Depois crie outra e troque no seu sistema.
Enviamos as rotas e um exemplo para o seu sistema, a sua loja ou o seu PDV.