# API Upscale

- [Introdução](https://docs-api.upscaledigital.com.br/introduction.md): API da plataforma Upscale para integração com sistemas externos (ERPs, gateways, marketplaces).
- [Autenticação](https://docs-api.upscaledigital.com.br/authentication.md): Todo request precisa de uma chave de API válida no header X-API-Key.
- [Rate Limits](https://docs-api.upscaledigital.com.br/rate-limits.md): 100 requests por minuto por chave, compartilhado entre todos os endpoints.
- [Códigos de erro](https://docs-api.upscaledigital.com.br/errors.md): Códigos padronizados no campo error.code + mapeamento pros status HTTP.
- [Sincronização inicial do catálogo](https://docs-api.upscaledigital.com.br/guides/fluxo-catalogo.md): Carga inicial: categorias → produtos → variantes → estoque → preços.
- [Sincronização periódica de estoque e preço](https://docs-api.upscaledigital.com.br/guides/fluxo-estoque.md): Duas frequências: batch a cada 10 min (deltas acumulados) e imediata após cada venda no sistema integrado.
- [Pull de pedidos + processamento + rastreio](https://docs-api.upscaledigital.com.br/guides/fluxo-pedidos.md): Modelo pull cursor-based: consulta periódica com updated_since + campo status pra decidir o que fazer.
- [Criar / atualizar produtos](https://docs-api.upscaledigital.com.br/api-reference/produtos/criar.md): Upsert em lote de produtos, com chave de idempotência hunter_id.
- [Listar produtos](https://docs-api.upscaledigital.com.br/api-reference/produtos/listar.md): Listagem paginada de produtos com hunter_id preenchido.
- [Criar / atualizar variantes](https://docs-api.upscaledigital.com.br/api-reference/variantes/upsert.md): Upsert em lote de variantes vinculadas a um produto pai.
- [Atualizar estoque](https://docs-api.upscaledigital.com.br/api-reference/estoque/atualizar.md): Atualização em lote de estoque por SKU. Requer variantes já cadastradas.
- [Atualizar preços](https://docs-api.upscaledigital.com.br/api-reference/precos/atualizar.md): Atualização em lote de preço e promoção por SKU.
- [Listar pedidos](https://docs-api.upscaledigital.com.br/api-reference/pedidos/listar.md): Pull cursor-based de pedidos em status ativo. Base do fluxo de processamento no ERP.
- [Confirmar processamento (NF emitida)](https://docs-api.upscaledigital.com.br/api-reference/pedidos/processado.md): Confirma que o pedido teve estoque baixado + NF emitida. Idempotência ESTRITA — segunda chamada retorna 409.
- [Registrar rastreio](https://docs-api.upscaledigital.com.br/api-reference/pedidos/rastreio.md): Registra ou corrige código de rastreio. Idempotência ABERTA — sobrescreve se pedido já enviado.