Esta documentação orienta parceiros que desejam conectar seus sistemas a uma loja no Sellmate. Ela apresenta como trocar informações de anúncios e pedidos com o marketplace. Os detalhes de cada requisição e resposta estão no contrato da API.
A integração segue um fluxo de notificações e webhooks. Quando um produto ou anúncio é criado ou atualizado no sistema do parceiro, ele envia uma notificação à API Sellmate. A confirmação de recebimento dessa notificação não significa que o anúncio já foi processado.Após recebê-la, a Sellmate consulta os dados completos do produto no webhook informado pelo parceiro durante a configuração. Quando o processamento termina, a Sellmate chama o webhook de status do parceiro para informar o resultado da criação ou atualização do anúncio. Os fluxos de pedidos e cotação, quando habilitados, também utilizam os webhooks cadastrados.
O endereço base da API é https://{marketplaceName}.sellmate.com.br/backend. Substitua {marketplaceName} pelo identificador do marketplace fornecido para a sua integração. Por exemplo, se o identificador for minhaloja, o endereço base será https://minhaloja.sellmate.com.br/backend.Nosso time envia um formulário para reunir os dados necessários à configuração da integração, incluindo os webhooks do parceiro. Depois que a configuração for concluída, o parceiro receberá o marketplaceName, o sellerId da loja e o token de integração. O token deve ser enviado no cabeçalho Authorization: Bearer {token} das chamadas feitas à API Sellmate. Nas chamadas da Sellmate aos webhooks do parceiro, a autenticação usa a apiKey cadastrada na configuração, enviada como parâmetro de consulta apiKey.
Controle o volume de chamadas. Evite rajadas e notificações duplicadas; distribua envios de alto volume ao longo do tempo. Confirme com nosso time os limites aplicáveis à sua integração antes de iniciar cargas maiores. Se receber uma resposta HTTP 429, aguarde o tempo indicado em Retry-After, quando disponível. Caso contrário, tente novamente com intervalos progressivamente maiores.
Proteja o token de integração. Ele é um dado sensível: guarde-o em um gerenciador de segredos ou configuração protegida, restrinja o acesso e não o inclua em código-fonte, logs ou mensagens públicas.
Use HTTPS nos webhooks. Mantenha as URLs informadas à Sellmate acessíveis e atualizadas. Se precisar alterá-las ou substituir credenciais, entre em contato com nosso time antes da troca.
