Início Rápido da API de Fornecedor Accplanet: Produtos, Pedidos e Atualizações de Entrega

By Olivia Chen

Setembro 13, 2026 Buyer Tips 👁 142 Visualizações

Accplanet Supplier API API key api design principles supplier product API create update delete product API supplier order API update delivery API upload product image API

Accplanet Supplier API quick start

Authenticate with X-API-Key, manage products, list orders, and update delivery through the Supplier REST API.

Create an API key
Generate a supplier API key in Profile → API key and send it as the X-API-Key header.
Create or update products
Use /products/api/supplier/create/ and /products/api/supplier/products/{id}/update/ with JSON bodies from the live docs.
Fulfill orders
List /orders/api/supplier/orders/ and POST delivered updates for each order id. Cache GETs and back off on 429.

Se você vende na Accplanet e quer automação, a Accplanet Supplier API é uma superfície REST para produtos, pedidos e atualizações de entrega. Este guia rápido leva um vendedor desde a configuração da chave de API até criar / atualizar / excluir produtos, listar pedidos e marcar entrega — sem substituir a documentação completa da Supplier API.

A Accplanet é o marketplace; sua conta de fornecedor é proprietária dos anúncios e do fulfillment. Os scripts se autenticam com uma chave de API no cabeçalho X-API-Key.

Resumo

Gere uma chave de API no seu perfil da Accplanet; envie-a como X-API-Key em todas as chamadas à Supplier.
Fluxo de produto: criar → listar/atualizar campos de estoque → excluir ao descontinuar um SKU.
Fluxo de pedido: listar pedidos do fornecedor → atualizar informações de entrega → alterar status quando seu processo exigir.
Prefira caminhos sem prefixo como /products/api/supplier/… para POST (evita que o redirecionamento de idioma transforme POST em GET).
Faça cache das leituras; respeite HTTP 429 e Retry-After.

Obtenha sua chave de API

Faça login com uma conta habilitada como fornecedor, abra Perfil → Chave de API e gere uma chave de API. Para a integração de vendedor da Accplanet, toda requisição deve se parecer com:

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Armazene a chave em um cofre de segredos. Faça a rotação dela se algum laptop ou log de CI já a tiver exibido.

Princípios de design de API para sincronização de vendedores

Os endpoints de fornecedor seguem princípios comuns de design de API que mantêm a sincronização de ERP ou armazém previsível:

URLs de recurso: produtos e pedidos são recursos REST separados em vez de um único endpoint mega-ação.
Autenticação por cabeçalho: X-API-Key mantém as credenciais fora das query strings nos logs de acesso.
JSON de entrada / JSON de saída: os corpos de criação e atualização são estruturados; uploads usam multipart/form-data.
Hábitos idempotentes: atualize pelo id do produto; use os flags de mesclagem de entrega com cuidado para não apagar linhas de entrega anteriores.

Produtos: criar, atualizar, excluir

1 · Criar

Criar produto via API

Faça POST para a API de criação de produto do fornecedor. Os nomes dos campos e os ids de categoria obrigatórios são documentados ao vivo — comece pelo testador da documentação depois de conseguir se autenticar.

curl -X POST https://accplanet.com/products/api/supplier/create/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Example listing\",\"price\":\"9.99\",\"category_id\":\"CATEGORY_ID\"}"

Substitua o JSON pelo payload completo da documentação da Supplier API. Trate o exemplo acima como um lembrete de formato, não como um schema completo.

2 · Listar / atualizar

Listar produtos e atualizar por id

curl -X GET https://accplanet.com/products/api/supplier/products/ \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST https://accplanet.com/products/api/supplier/products/PRODUCT_ID/update/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"price\":\"8.50\"}"

Use a atualização para preço, campos relacionados a estoque e alterações de descrição que sua loja já suporta. Prefira atualizar um id de produto existente em vez de criar duplicatas.

3 · Excluir

Descontinuar um anúncio

curl -X POST https://accplanet.com/products/api/supplier/products/PRODUCT_ID/delete/ \
  -H "X-API-Key: YOUR_API_KEY"

Confirme no admin ou em uma chamada de listagem posterior que o produto foi removido ou está inativo conforme as regras da sua conta definem.

Pedidos e atualizações de entrega

Listar pedidos

GET /orders/api/supplier/orders/ para a API de pedidos do fornecedor. Filtre por status no seu job de sincronização; não faça polling mais rápido do que uma vez por minuto por chave.

Atualizar entrega

POST /orders/api/supplier/orders/{order_id}/delivered/ para enviar linhas de conta entregues. Ao mesclar, siga a documentação de append_delivered_info para não substituir linhas anteriores por engano.

Status / reembolsos

Existem endpoints dedicados de status e reembolso na mesma árvore de pedidos do fornecedor. Integre-os somente depois que as atualizações de entrega estiverem estáveis.

curl -X GET "https://accplanet.com/orders/api/supplier/orders/" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST https://accplanet.com/orders/api/supplier/orders/ORDER_ID/delivered/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"delivered_info\":\"[\\\"line1\\\",\\\"line2\\\"]\",\"append_delivered_info\":true}"

Valide o payload exato de entrega com a documentação ao vivo — os formatos de entrega variam conforme o tipo de produto.

Enviar imagens de produtos

Use a API de upload de imagem de produto com multipart form data:

curl -X POST https://accplanet.com/products/api/supplier/upload-image/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "image=@./cover.webp"

Reutilize a URL retornada nos payloads de criação/atualização quando seu schema esperar um caminho de imagem.

Limites de taxa

Leituras, escritas e uploads REST do fornecedor ficam em orçamentos separados por minuto (as leituras costumam ser o mais restrito para pollers ingênuos). Para a integração de vendedor da Accplanet:

Faça cache das listas de produtos e pedidos via GET.
Agrupe atualizações de UI em vez de chamadas de listagem a cada clique.
Em caso de 429, respeite Retry-After antes de tentar novamente uploads ou escritas.

Checklist do fornecedor

Chave de API em X-API-Key; segredos não commitados.
Caminho de criar → atualizar → excluir produto testado em um SKU de sandbox.
Listagem de pedidos + atualização de entrega verificadas com um id de pedido real ou de staging.
Upload de imagem funcionando antes dos jobs de importação em massa.
Backoff para 429 implementado.