Liga o teu CRM ao Sattotal: chegou a API pública
Se já tens os clientes ou os fornecedores noutro programa, deixa de os escrever duas vezes. Com uma chave de API, o Sattotal e o teu CRM mantêm-se em dia sozinhos.
Até aqui, trazer os teus dados para o Sattotal passava por uma importação em CSV: serve para a mudança, não serve para o dia a dia. Crias um cliente no teu CRM na terça-feira e na quinta tens de o escrever outra vez aqui. Com a API pública isso acaba: o teu CRM, o teu ERP ou uma ferramenta como o Make ou o n8n podem consultar e criar clientes e fornecedores dentro da tua organização, sem ninguém mexer num ficheiro.
Como se põe a funcionar
Cria a chave em Definições → API
Só administradores. Dás-lhe um nome que identifique a integração («CRM da loja», «Make»), marcas que recursos pode tocar e com que nível, e está feito.
Decides o que pode fazer, recurso a recurso
Clientes e Fornecedores concedem-se em separado, cada um em Apenas leitura ou em Leitura e escrita. Podes emitir uma chave que só lê fornecedores e não mexe em mais nada.
Copia-la uma vez e colas na tua ferramenta
A chave completa aparece uma única vez e fica depois guardada cifrada, sem forma de a recuperar. Se a perderes, revoga-la e crias outra: a antiga deixa de responder de imediato.
Sincroniza só o que mudou
Não precisas de trazer tudo em cada passagem. Guardas a data da última execução e pedes apenas o que foi alterado desde então. Um cenário que corre de quinze em quinze minutos quase não mexe dados.
As permissões são por recurso, e isso já se notou: quando os fornecedores entraram, as chaves que já existiam — todas de clientes — NÃO ganharam acesso a eles. Foi preciso concedê-lo à mão. O mesmo vale para qualquer recurso que venha a seguir: uma integração nunca vê mais do que aquilo que lhe deste.
Dos fornecedores sincroniza-se a ficha: nome, identificador fiscal, contactos, forma e prazo de pagamento, o teu número de cliente nesse fornecedor. As compras e as faturas de fornecedor não estão na API e ficam onde já estiverem, no teu ERP ou aqui. E há duas coisas que ficam de fora de propósito: o IBAN e as contas bancárias do fornecedor. Se um dia uma chave se perdesse, não servia para a fraude da mudança de conta, que é a mais frequente neste terreno.
Definições → API
CRM da loja sat_Ab3k…x9Zq
Clientes · Leitura e escrita Fornecedores · Apenas leitura
Última utilização: há 3 minutos [ Revogar ]
0 de 10 chaves ativas
Uma sincronização normal
A referência técnica completa está publicada em formato API e pode ser importada no Postman, no Make ou no n8n para teres todas as chamadas prontas. Na ajuda tens o guia passo a passo, com um cenário do Make montado do princípio ao fim. A API está incluída nos planos pagos e também durante o período experimental.
Novidade de outubro: a API avisa quando um dado não fica guardado. Se a tua ferramenta envia um campo com um nome que a API não conhece — por exemplo "firstName" em vez de "nombre", ou "apellido" em vez de "apellidos" —, o cliente é criado na mesma, mas a resposta inclui a lista de campos ignorados para corrigires o mapeamento à primeira, em vez de descobrires semanas depois que faltavam nomes.
Quer experimentar por si próprio?
Experimente a Sattotal grátis com dados de exemplo, sem cartão de crédito.
