Início Rápido da API do Fornecedor: Criar, Atualizar, Excluir Produtos e Atender Pedidos
Equipes de fornecedores que sincronizam catálogos no Accplanet precisam de um fluxo claro: criar ou atualizar produtos, manter o estoque honesto, atender pedidos e lidar com reembolsos ou tickets quando algo der errado. Este guia de início rápido percorre esse fluxo usando a documentação da API de Fornecedor ao vivo.
Accplanet é um marketplace de agregação de fornecedores. Você atende o inventário; a plataforma cuida da descoberta de compradores, checkout, rastreamento e ferramentas de suporte. Use estes endpoints apenas para operações legítimas de catálogo e pedidos — não para burlar políticas ou automação insegura.
Em resumo
- Autentique com
X-API-Key,Authorization: Bearer, corpokey/apikeyou uma sessão ativa no painel do fornecedor. - Produtos: envie imagem → crie → liste/atualize → adicione contas de entrega automática → exclua apenas quando as regras permitirem.
- Pedidos: liste → obtenha → atualize informações de entrega / anexo → altere o status → reembolse quando apropriado.
- Novos anúncios podem precisar de aprovação do administrador antes de aparecerem publicamente.
- Mantenha a documentação oficial aberta para caminhos exatos e tabelas de parâmetros enquanto você codifica.
Autenticação
Use sua chave de API de fornecedor do seu perfil. Chamadas JSON de produto/pedido normalmente enviam:
X-API-Key: SUA_CHAVE_DE_API
Content-Type: application/jsonA autenticação por sessão do navegador também funciona quando você está logado no painel do fornecedor — útil com o painel Test API da documentação.
Ciclo de vida do produto
1 · Primeiro
Enviar imagem
POST /products/api/supplier/upload-image/ com arquivo de imagem multipart. Salve o image_path retornado para o array images na criação/atualização.
2 · Criar
Criar produto (ou atualizar pela URL de origem)
POST /products/api/supplier/create/ exige category_id, title, description, price. Opcionais: stock, min_quantity, images, source_product_id, source_product_url, warranty_period_days, status e pools de entrega automática via accounts ou accounts_text.
Se source_product_url corresponder a um item antigo na sua conta, a API pode atualizar esse item em vez de criar uma duplicata (sinalizadores created/updated na resposta). Observe approval_status.
3 · Manter
Listar, consultar, atualizar
GET /products/api/supplier/products/— lista paginada com filtros de busca, categoria, status e preço.GET /products/api/supplier/products/by-source-id/<source_product_id>/— caminho rápido para sincronização ativa por ID upstream.POST /products/api/supplier/products/<product_id>/update/— atualize título, preço, estoque, imagens, campos de origem, status ou campos do pool de entrega.
Identifique produtos pelo ID numérico do catálogo ou product_id das respostas de listagem. Os compradores veem os IDs do catálogo como valores service da API do Cliente quando atribuídos.
4 · Pool de entrega
Adicionar contas de entrega automática
POST .../products/<product_id>/accounts/ adiciona credenciais ao pool de entrega automática sem reescrever o estoque listado. Use objetos accounts estruturados ou linhas accounts_text (user:pass / user|pass). Trate o accounts_imported retornado com cuidado — são segredos.
5 · Remover
Excluir quando permitido
POST .../products/<product_id>/delete/ remove permanentemente um produto sem vendas concluídas. Prefira alterações de status quando precisar apenas parar de vender.
| Foco do endpoint | Caminho do método (host accplanet.com) | Uso típico |
|---|---|---|
| Enviar imagem | POST /products/api/supplier/upload-image/ |
Obter image_path |
| Criar | POST /products/api/supplier/create/ |
Novo anúncio / atualização por URL de origem |
| Listar | GET /products/api/supplier/products/ |
Sincronizar estado |
| Por ID de origem | GET .../by-source-id/<id>/ |
Sincronização ativa |
| Atualizar | POST .../products/<id>/update/ |
Preço, estoque, descrição |
| Adicionar contas | POST .../products/<id>/accounts/ |
Pool de entrega automática |
| Excluir | POST .../products/<id>/delete/ |
Remover SKU não utilizado |
Ciclo de vida do pedido
Após a compra dos compradores, atenda pelos endpoints de Pedidos:
- Listar —
GET /orders/api/supplier/orders/comstatus,searche paginação opcionais. - Obter —
GET /orders/api/<order_id>/quando precisar de um snapshot de um pedido. - Entregar —
POST .../orders/<order_id>/delivered/comdelivered_info(texto simples ou string de array JSON). Definaappend_delivered_info=truepara adicionar linhas. Ou envie um arquivo via.../delivery-attachment/(multipartfile, ≤10MB). - Status —
POST .../orders/<order_id>/status/com valores permitidos comopending_order,running_order,completed_order,refunded_order.receipt_confirmed_ordernão pode ser definido via API. - Reembolso —
POST .../orders/<order_id>/refund/para reembolso integral quando seu processo exigir.
Acompanhe delivered_units, remaining_to_deliver e campos de pagamento das respostas de listagem/obtenção para que sua lógica de armazém corresponda ao painel.
Pool de entrega automática
Pré-carregue contas no produto; o Accplanet pode enfileirar tarefas de entrega.
delivered_info manual
Envie credenciais ou chaves por pedido quando o atendimento for gerenciado manualmente.
Anexo
Envie um único arquivo de atendimento quando campos de texto não forem suficientes.
Tickets, pagamentos, saldo
- Tickets — liste, obtenha, crie (
order_id+ título + descrição), atualize status/resposta em/orders/api/supplier/tickets/. - Pagamentos —
GET /orders/api/supplier/payments/para registros de pagamento dos seus pedidos fornecidos. - Saldo —
GET /users/api/balance/retorna saldos de carteira do cliente e do fornecedor para a conta autenticada.
Status de aprovação, estoque e estados de pedido seguem as regras ao vivo da plataforma. Confirme o comportamento na documentação atual da API de Fornecedor ao lançar a sincronização em produção.
Checklist do fornecedor
- [ ] Chave de API de fornecedor armazenada no servidor
- [ ]
category_idmapeado das categorias do Accplanet (subcategoria final quando exigido) - [ ] Caminho de criação/atualização testado primeiro com um título fora de produção
- [ ] Atualizações de estoque e preço idempotentes no seu job de sincronização
- [ ] Pool de entrega ou caminho manual de
delivered_infoverificado em um pedido de teste - [ ] Transições de status de pedido correspondem aos valores permitidos no painel
- [ ] Caminhos de ticket + reembolso documentados para sua equipe de suporte
Próximo passo: abra a documentação da API de Fornecedor, autentique com Test API, crie um produto rascunho e pratique listar → entregar → status em um pedido estilo sandbox. Compradores que integram compras devem usar o guia de início rápido da API do Cliente no blog do Accplanet.
Perguntas frequentes
Por que meu novo produto não está visível para os compradores?
Anúncios podem exigir aprovação do administrador (approval_status). Mantenha o item active apenas quando estiver pronto para vender e confirme a aprovação na resposta ou no painel.
Qual é a diferença entre product_id e business_id?
product_id é o identificador do sistema usado nos caminhos do fornecedor. business_id é o ID numérico do catálogo quando atribuído — os compradores geralmente o veem como service da API do Cliente.
Adicionar contas altera o estoque listado?
Não. Adicionar contas atualiza o pool de entrega automática. Gerencie o stock listado pelos campos de criação/atualização separadamente, a menos que seu processo operacional
