# UniSupri Marketplace API

> API REST do marketplace UniSupri para vendedores e integradores. Permite gerenciar catálogo, publicar anúncios, processar pedidos, emitir documentos fiscais e trocar mensagens com compradores.

Autenticação: header `Authorization: Bearer sk_...` (Token de Integração criado no painel do seller).

Formato de resposta padronizado: envelope `{ success, code, message_code, description, data, meta }`.

## Guias

- [Introdução](https://api-docs.samdevel.com.br/guides/primeiros-passos.md): Comece por aqui: credencial, token e primeira chamada.
- [Autenticação](https://api-docs.samdevel.com.br/guides/autenticacao.md): Detalhes do /api/integration/auth, rotação e troca de senha.
- [Limites de uso](https://api-docs.samdevel.com.br/guides/limites.md): Rate limit por token de integração (300/min), headers X-RateLimit-* e tratamento de 429.
- [Mídia](https://api-docs.samdevel.com.br/guides/midia.md): Upload de imagens compartilhado: suba uma vez, receba o ID e vincule ao recurso final.
- [Guia da Loja](https://api-docs.samdevel.com.br/guides/loja.md): Sessão, página pública, identidade visual e avaliações.
- [Produtos · Visão geral](https://api-docs.samdevel.com.br/guides/produtos.md): Cadastro do produto base: especificações, galeria, enums e fluxo de cadastro.
- [Produtos · Preços](https://api-docs.samdevel.com.br/guides/produtos-precos.md): Tabela de preços: modelo único (default) ou progressivo por quantidade (wholesale).
- [Produtos · Estoque](https://api-docs.samdevel.com.br/guides/produtos-estoque.md): Movimentação e consulta de saldo: existente, reservado e disponível.
- [Anúncios · Visão geral](https://api-docs.samdevel.com.br/guides/anuncios.md): Os dois caminhos pra vender: publicar anúncio próprio ou ofertar em anúncio de catálogo.
- [Anúncios · Categorias](https://api-docs.samdevel.com.br/guides/anuncios-categorias.md): A árvore de categorias: departamentos, navegação, busca e categorias folha.
- [Anúncios · Atributos e variações](https://api-docs.samdevel.com.br/guides/anuncios-atributos.md): Flags, tipos de valor, cor customizada e geração de combinações de variações.
- [Anúncios · Imagens](https://api-docs.samdevel.com.br/guides/anuncios-imagens.md): Vínculo das imagens da Mídia ao anúncio e às variações.
- [Pedidos · Visão geral](https://api-docs.samdevel.com.br/guides/pedidos.md): Recebimento de pedidos e avanço pelos estados do ciclo de vida.
- [Pedidos · Entrega](https://api-docs.samdevel.com.br/guides/pedidos-entrega.md): Workflow padrão: venda com envio, da preparação à entrega.
- [Pedidos · Retirada](https://api-docs.samdevel.com.br/guides/pedidos-retirada.md): Workflow de retirada em loja: ready_for_pickup, código de confirmação e expiração.
- [Pedidos · Sob encomenda](https://api-docs.samdevel.com.br/guides/pedidos-sob-encomenda.md): Workflow backorder: pedido pago aguardando reposição de estoque pra seguir.
- [Pedidos · Industrialização](https://api-docs.samdevel.com.br/guides/pedidos-industrializacao.md): Workflow production: produtos que passam pela fábrica antes de embalar.
- [Pedidos · Fiscal](https://api-docs.samdevel.com.br/guides/pedidos-fiscal.md): NF-e (modelo 55), Declaração de Conteúdo, XML e download de DANFE/PDF.
- [Pedidos · Logística](https://api-docs.samdevel.com.br/guides/pedidos-logistica.md): Shipments do pedido, geração e download de etiquetas (assíncrono com polling).
- [Devoluções · Visão geral](https://api-docs.samdevel.com.br/guides/devolucoes.md): Devoluções (RMA) encaminhadas ao seller: aprovação, rejeição, coleta reversa e reembolso.
- [Comunicação · Visão geral](https://api-docs.samdevel.com.br/guides/comunicacao.md): Os dois canais da loja com o comprador (atendimento e perguntas) e quando usar cada um.
- [Comunicação · Chat com cliente](https://api-docs.samdevel.com.br/guides/chat.md): Central de Atendimento: chat ancorado no pedido, com anexos e SLA.
- [Comunicação · Perguntas](https://api-docs.samdevel.com.br/guides/perguntas.md): Q&A das publicações: pergunta do comprador no produto, com moderação.
- [Guia de Ocorrências](https://api-docs.samdevel.com.br/guides/ocorrencias.md): Devoluções, problemas operacionais, divergências (tickets internos).

## Especificação OpenAPI

- [OpenAPI completo (JSON)](https://api-docs.samdevel.com.br/openapi.json)
- [OpenAPI completo (YAML)](https://api-docs.samdevel.com.br/openapi.yaml)

- Autenticação, Sessão e Mídia: [JSON](https://api-docs.samdevel.com.br/reference/primeiros-passos.json) · [YAML](https://api-docs.samdevel.com.br/reference/primeiros-passos.yaml)
- API da Loja: [JSON](https://api-docs.samdevel.com.br/reference/loja.json) · [YAML](https://api-docs.samdevel.com.br/reference/loja.yaml)
- API de Produtos: [JSON](https://api-docs.samdevel.com.br/reference/produtos.json) · [YAML](https://api-docs.samdevel.com.br/reference/produtos.yaml)
- API de Anúncios: [JSON](https://api-docs.samdevel.com.br/reference/anuncios.json) · [YAML](https://api-docs.samdevel.com.br/reference/anuncios.yaml)
- API de Pedidos: [JSON](https://api-docs.samdevel.com.br/reference/pedidos.json) · [YAML](https://api-docs.samdevel.com.br/reference/pedidos.yaml)
- API de Devoluções: [JSON](https://api-docs.samdevel.com.br/reference/devolucoes.json) · [YAML](https://api-docs.samdevel.com.br/reference/devolucoes.yaml)
- API de Comunicação: [JSON](https://api-docs.samdevel.com.br/reference/comunicacao.json) · [YAML](https://api-docs.samdevel.com.br/reference/comunicacao.yaml)
- API de Ocorrências: [JSON](https://api-docs.samdevel.com.br/reference/ocorrencias.json) · [YAML](https://api-docs.samdevel.com.br/reference/ocorrencias.yaml)

## Optional

- [Todos os guias em um único arquivo](https://api-docs.samdevel.com.br/llms-full.txt)
- [Bundle (tar.gz)](https://api-docs.samdevel.com.br/downloads/unisupri-api-docs-latest.tar.gz): guias + specs em JSON e YAML
- [Bundle (zip)](https://api-docs.samdevel.com.br/downloads/unisupri-api-docs-latest.zip)