Marketplace In: criação e identificação de sellers via API

A criação de sellers via API permite integrar o cadastro de novos vendedores ao fluxo do marketplace. 

Com a melhoria implementada, esse processo passa a ser contínuo, garantindo que o ID do seller seja obtido de forma imediata, sem depender de etapas adicionais.

Esse identificador é essencial para dar sequência às demais ações da integração.

Para que serve

Essa funcionalidade garante que, após criar ou identificar um seller na base, seja possível recuperar seu ID de forma direta e confiável. 

Isso permite seguir com ações que dependem desse identificador, como vínculos, configurações e integrações adicionais, além de trazer mais autonomia e eficiência para o onboarding.

Como funciona na prática

O fluxo de onboarding via API segue uma sequência simples: o seller é cadastrado, criado via API e, na resposta dessa requisição, o sistema já retorna o seu ID. 

A partir disso, a integração pode continuar normalmente, utilizando esse identificador nas próximas etapas.

Caso o ID não esteja disponível diretamente na resposta, ainda é possível obtê-lo por meio de uma consulta, utilizando dados conhecidos do seller, como e-mail ou CNPJ. 

Essa lógica garante que tanto sellers recém-criados quanto já existentes possam ser identificados.

Regras importantes

Alguns comportamentos devem ser considerados no uso da funcionalidade:

• o ID do seller é o identificador único utilizado nas operações da API;
• quando retornado na criação, pode ser utilizado imediatamente;
• na consulta, é necessário informar um dado válido do seller;
• o comportamento é o mesmo para sellers novos e existentes.

Além disso, a melhoria não altera regras já existentes da API, mantendo a compatibilidade com integrações em funcionamento.

Como utilizar

Dentro do fluxo de integração, o uso é direto. Ao criar um seller, é importante verificar se a resposta da API já retorna os dados do cadastro, incluindo o ID. Quando isso acontece, o processo pode seguir sem interrupções.

Se o retorno não trouxer essa informação, basta utilizar a rota de consulta de sellers, informando um dado conhecido para localizar o registro e obter o ID correspondente.

Como acompanhar

Após a criação ou consulta, o ID do seller passa a estar disponível para uso nas demais requisições da API. Com ele, é possível vincular o seller a outras entidades, configurar regras específicas e dar continuidade ao fluxo de onboarding de forma estruturada.

Observações importantes

A identificação do seller não depende de acesso ao painel administrativo, sendo totalmente possível via API. Para consultas, é necessário que o dado informado corresponda a um seller existente na base.

Essa melhoria garante mais eficiência, escalabilidade e continuidade no processo de onboarding, sem impactar o funcionamento atual das integrações.

Dúvidas?

Acesse o Help Center para saber mais sobre o Hub de Marketplaces da Uappi!