# Akeba

> Documentação da API da Akeba — marketplace de produtos criativos e artesanais feitos por criadores independentes do Brasil.

## Docs

- [Atualiza o estoque de uma variação de produto](https://docs.akeba.com.br/api-reference/estoque/atualiza-o-estoque-de-uma-variação-de-produto.md): Atualiza a quantidade em estoque (quantidade, integer) e/ou status de atividade (is_active, boolean). Ambos os campos são opcionais mas ao menos um deve ser fornecido. Para produtos sem variações que rastreiam estoque, sincroniza automaticamente o estoque global.
- [Lista o estoque de todas as variações da loja](https://docs.akeba.com.br/api-reference/estoque/lista-o-estoque-de-todas-as-variações-da-loja.md): Retorna uma lista paginada de 50 variações com suas quantidades em estoque. Inclui informações do produto associado.
- [Get ping](https://docs.akeba.com.br/api-reference/get-ping.md)
- [Aceita um item de pedido](https://docs.akeba.com.br/api-reference/pedido/aceita-um-item-de-pedido.md): Marca um item como aceito pela loja. Só é permitido quando o pedido está pago e o item está no status 'pendente'. Transição de status: pendente → aceito. Retorna o item atualizado ou erro 400 se a transição não for permitida.
- [Inicia a produção de um item de pedido](https://docs.akeba.com.br/api-reference/pedido/inicia-a-produção-de-um-item-de-pedido.md): Marca um item como em produção. Só é permitido quando o item está no status 'aceito'. Transição de status: aceito → em_producao. Retorna o item atualizado ou erro 400 se a transição não for permitida.
- [Lista os itens de pedido da loja](https://docs.akeba.com.br/api-reference/pedido/lista-os-itens-de-pedido-da-loja.md): Retorna uma lista paginada de 25 itens de pedido com suporte a filtros por status e data. Status válidos: 'pending', 'accepted', 'in_production', 'shipped', 'delivered', 'cancelled'. Datas devem estar no formato YYYY-MM-DD.
- [Marca um item como enviado com código de rastreio](https://docs.akeba.com.br/api-reference/pedido/marca-um-item-como-enviado-com-código-de-rastreio.md): Marca um item como enviado e registra o código de rastreamento. Só é permitido quando o item está no status 'em_producao'. Requer campo 'tracking_code' (string, até 100 caracteres). Transição de status: em_producao → enviado. Retorna o item atualizado ou erro 400 se a transição não for permitida.
- [Obtém detalhes de um pedido](https://docs.akeba.com.br/api-reference/pedido/obtém-detalhes-de-um-pedido.md): Retorna os detalhes completos de um pedido incluindo todos os seus itens e endereço de entrega. Apenas itens pertencentes à loja autenticada são incluídos.
- [Volta um item para produção](https://docs.akeba.com.br/api-reference/pedido/volta-um-item-para-produção.md): Reverte um item enviado de volta para o status de produção (e.g., em caso de erro de envio). Só é permitido quando o item está no status 'enviado'. Transição de status: enviado → em_producao. Retorna o item atualizado ou erro 400 se a transição não for permitida.
- [Atualiza o preço de um produto](https://docs.akeba.com.br/api-reference/produto/atualiza-o-preço-de-um-produto.md): Atualiza o preço base (preco) e/ou preço promocional (preco_promocional) de um produto. Ambos os campos são opcionais mas ao menos um deve ser fornecido. Valores em centavos (integer).
- [Lista os produtos da loja](https://docs.akeba.com.br/api-reference/produto/lista-os-produtos-da-loja.md): Retorna uma lista paginada de 25 produtos com resumo de informações. Suporta filtro por status. Status válidos: 'ativo', 'inativo', 'deletado'.
- [Obtém detalhes completos de um produto](https://docs.akeba.com.br/api-reference/produto/obtém-detalhes-completos-de-um-produto.md): Retorna informações detalhadas do produto, incluindo todas as variações de estoque, imagem de capa, galeria de imagens e categoria com categoria pai.
- [Autenticação](https://docs.akeba.com.br/guias/autenticacao.md): Como autenticar suas requisições com token Bearer e respeitar os limites da API.
- [Erros](https://docs.akeba.com.br/guias/erros.md): Códigos de status HTTP e o formato das respostas de erro da API.
- [Fluxo de pedidos](https://docs.akeba.com.br/guias/fluxo-de-pedidos.md): O ciclo de vida de um item de pedido: do pagamento à entrega.
- [Paginação e sincronização](https://docs.akeba.com.br/guias/paginacao-e-sincronizacao.md): Como navegar por resultados paginados e sincronizar apenas o que mudou com delta sync.
- [Webhooks](https://docs.akeba.com.br/guias/webhooks.md): Receba eventos em tempo real: pedidos pagos, mudanças de status e cancelamentos.
- [API Akeba para ERPs](https://docs.akeba.com.br/index.md): Integre seu ERP com a Akeba: consulte pedidos, atualize status de entrega, gerencie preços e estoque.
- [Quickstart](https://docs.akeba.com.br/quickstart.md): Faça sua primeira chamada à API da Akeba em menos de 5 minutos.

## OpenAPI Specs

- [openapi](https://docs.akeba.com.br/openapi.json)

## Optional

- [Site da Akeba](https://www.akeba.com.br)
- [Painel do vendedor](https://akeba.com.br/vendedor/integracoes)