Para o time de tecnologia
API de e-commerce headless para integrar ERP, estoque e vitrine
Duas APIs: uma para o ERP e os sistemas internos, outra para a vitrine. 96 rotas na de integração e 94 na da loja, com tokens por escopo, idempotência e eventos assinados.
API de integração
O ERP conversa direto com o catálogo, o preço e o pedido
A API REST de integração cobre o que costuma vir do ERP e o que precisa voltar para ele. A NF-e continua sendo emitida pelo ERP; a Aonic recebe os dados da nota e mostra ao cliente.
Catálogo e estoque
- ProdutosCom imagens, vídeos e arquivos
- Categorias e atributosÁrvore de categorias, atributos e valores
- Centros de distribuiçãoCadastro de CDs e estoque por CD
Preço e comercial
- Listas de preçoExceções, prévia, publicação e ativação
- Perfis comerciaisPerfis e condição comercial de cada cliente, inclusive em lote
- ClientesCadastro, endereços e conta corrente
Pedidos e configuração
- PedidosStatus, status de pagamento e expedição
- Documento fiscalChave de acesso, número, série e link da NF-e emitida pelo ERP
- Webhooks e configuraçõesCadastro de endpoints e ajustes da loja
Loja headless
A vitrine é sua, do layout ao código
A API da loja entrega tudo o que a vitrine precisa. O cliente entra com login e recebe um token próprio para carrinho, checkout e conta.
- Layout, home, menus, banners, vitrines e páginas institucionais
- Catálogo, busca, página de produto e página do seller
- Carrinho, cotação de frete, cupom, checkout e pagamento
- Conta do cliente: pedidos, endereços, cartões, favoritos, chamados e pós-venda
- Avaliações e perguntas, newsletter e contato
- Área do revendedor, conta corrente e candidatura de sellers
Webhooks
11 eventos, assinados
Cada entrega sai com assinatura HMAC SHA-256 sobre o timestamp e o corpo, identificador único, nome do evento e número da tentativa nos cabeçalhos.
- Até 3 tentativas, com espera crescente
- Registro de entregas com reenvio manual
- Troca do segredo pelo admin
order.created order.updated payment.created payment.updated product.created product.updated category.created category.updated user.created user.updated current_account_entry.created
Acesso e segurança
Quem acessa, o que pode fazer e o que mudou
Cada integração tem credencial própria, cada pessoa do time tem papel definido, e as alterações ficam registradas.
Tokens por cliente
- Criados no adminUm cliente de API para cada sistema que integra
- EscopoLeitura para consultas, escrita para alterações
- Por sellerUm cliente pode ficar restrito aos dados de um seller
- Limite de uso120 requisições por minuto por cliente
Idempotência
- Idempotency-KeyCabeçalho exigido nas requisições de criação
- Sem lançamento em dobroConta corrente, sincronização de saldo e confirmação de entrega
- PagamentoAtualização de status de pagamento do pedido protegida contra repetição
Permissões e auditoria
- 73 permissõesNo painel, combinadas nos papéis de administrador, gerente e editor
- Equipe do sellerPapéis próprios de dono, gerente e operador
- Log do adminQuem fez, o quê, de onde e o valor antes e depois, guardado por 1 ano
- Log da APICliente, rota, conteúdo enviado e status da resposta, guardado por 90 dias
Perguntas frequentes
Perguntas do time técnico
Sobre integração, vitrine e eventos.
comercial@aonic.com.brExiste conector pronto para o meu ERP?
Hoje não há conector pronto para um ERP específico. A integração é feita sobre a API: o ERP envia produtos, estoque por CD, preços, clientes e documentos fiscais, e recebe pedidos e pagamentos por consulta ou por webhook.
Posso construir a vitrine com a tecnologia que eu quiser?
Pode. A loja é headless: a vitrine consome a API da loja por HTTP, então o front pode ser feito pela Aonic, por uma agência parceira ou pelo seu time, sem tema obrigatório.
Como valido que um webhook veio da Aonic?
Cada entrega leva uma assinatura HMAC SHA-256 calculada sobre o timestamp e o corpo da mensagem, com o segredo do endpoint. Recalcule a assinatura do seu lado e compare. O segredo pode ser trocado pelo admin a qualquer momento.
E se o meu sistema estiver fora do ar quando o evento acontecer?
A Aonic faz até 3 tentativas, com espera crescente entre elas. Todas as entregas ficam registradas no admin, e qualquer uma pode ser reenviada manualmente.
Onde fica a documentação da API?
A referência da API de integração é gerada a partir do próprio código, no padrão OpenAPI, e fica publicada na instalação da sua loja. O time técnico recebe o acesso na implantação.
A API é cobrada à parte?
Não. A API de integração, a API da loja e os webhooks fazem parte da mensalidade fixa. Veja os preços.
Continue lendo
Outras partes da Aonic
Demonstração
Converse com o nosso time técnico
Traga o seu ERP e a sua arquitetura. Mostramos a referência da API, um webhook chegando e o caminho da integração.