Produtos em sintonia.
Uma conexão com o seu ERP pode simplificar o envio de produtos e manter o cadastro organizado entre os sistemas.
Integração iCan Imports
Sua operação.
Mais conectada.
Conecte os sistemas da sua loja à iCan Imports e reduza o trabalho de cadastrar e consultar informações em vários lugares.
Integração nos planos Gold e Expansão.
Uma conexão. Novas possibilidades.
API
Sua loja + seus sistemas + iCan Imports
Authorization: Bearer TOKEN_DE_EXEMPLO
Content-Type: application/json
{
"operacao": "conectada",
"loja": "sua empresa",
"possibilidades": [
"produtos",
"colaboradores",
"pedidos"
]
}Ilustração da integração. As rotas e os dados desta página são fictícios.
Menos tarefas repetidas
Mais tempo para a sua loja.
Sua equipe, conectada.
O cadastro de colaboradores representa pessoas com acesso à loja. A empresa continua com sua identidade e seus dados próprios.
Informação que acompanha.
A consulta de pedidos pode alimentar seu sistema de gestão e ajudar a acompanhar as vendas sem alternar entre painéis.
Autenticação
Acesso com Bearer Token.
As requisições autenticadas usam o cabeçalho Authorization, com o prefixo Bearer seguido do token de acesso.
Authorization: Bearer SEU_TOKEN
Content-Type: application/jsonUma conexão bem cuidada.
- Mantenha o token no servidor. Ele não deve aparecer no código público do site ou em repositórios.
- Utilize HTTPS. Proteja o envio de credenciais e informações da operação.
- Respeite os acessos da loja. A integração deve operar somente sobre os recursos autorizados.
- Planeje o tratamento de erros. Valide os dados e consulte o resultado antes de repetir uma operação.
Exemplos de uso
O que uma integração pode fazer.
Os exemplos abaixo demonstram possibilidades. São rotas fictícias, sem operação disponível nestes endereços. Não representam o contrato da API atual. Os campos, respostas e permissões serão definidos na documentação oficial.
POST
Cadastrar produto
Exemplo fictício/api/exemplo/v1/lojas/{loja_id}/produtos
Envia os dados de um produto para o catálogo da loja indicada.
Ver exemplo de envio
{
"nome": "Produto de exemplo",
"sku": "EXEMPLO-001",
"preco": 149.90,
"estoque": 20
}POST
Cadastrar colaborador
Exemplo fictício/api/exemplo/v1/lojas/{loja_id}/colaboradores
Cadastra um usuário colaborador vinculado à loja, mediante autorização para gerenciar a equipe.
Ver exemplo de envio
{
"nome_completo": "Pessoa de exemplo",
"email": "[email protected]",
"tipo": "colaborador"
}GET
Listar pedidos
Exemplo fictício/api/exemplo/v1/lojas/{loja_id}/pedidos?pagina=1&limite=30
Consulta os pedidos da loja com uma listagem paginada para acompanhar a operação.
Ver exemplo de resposta
{
"dados": [
{
"id": "pedido-exemplo",
"status": "pendente",
"total": 149.90
}
],
"pagina": 1,
"limite": 30,
"total": 1
}Gold e Expansão
Seu sistema pode fazer
parte do próximo passo.
A integração faz parte dos planos Gold e Expansão. Converse com nossa equipe para alinhar as possibilidades de conexão, a disponibilidade dos recursos e os requisitos da sua loja.