# SuperFrete para Desenvolvedores

> Cotação de frete, emissão de etiquetas, pedidos e webhooks da SuperFrete. Integração gratuita, sem mensalidade. API REST com autenticação Bearer; sandbox em https://sandbox.superfrete.com e produção em https://api.superfrete.com.

Toda requisição leva `Authorization: Bearer {token}` e um `User-Agent` com o nome da aplicação e um e-mail de contato técnico. Tokens são por ambiente: o de sandbox não funciona em produção. Dúvidas: integracao@superfrete.com.

## Guias

- [Primeiros passos](https://developers.superfrete.com/guias/primeiros-passos.md): Gere seu token, escolha o ambiente e faça a primeira chamada à API da SuperFrete.
- [Sua primeira etiqueta](https://developers.superfrete.com/guias/primeira-etiqueta.md): Do token ao rastreio em seis chamadas, no sandbox. Cote, crie a etiqueta, pague com saldo, imprima e acompanhe por webhook.
- [Autenticação](https://developers.superfrete.com/guias/autenticacao.md): Token manual ou OAuth 2.0? Veja qual modelo usar e como enviar o token em cada requisição.
- [Fluxo OAuth 2.0](https://developers.superfrete.com/guias/oauth.md): Como plataformas com várias lojas conectam cada seller à SuperFrete via OAuth 2.0, do pedido de credenciais ao token de acesso.
- [Cálculo de frete e etiquetas](https://developers.superfrete.com/guias/frete.md): Cote o frete, use a caixa certa, crie a etiqueta, pague com saldo e imprima. Inclui as regras de cada transportadora.
- [Webhooks](https://developers.superfrete.com/guias/webhooks.md): Receba os eventos dos seus pedidos em tempo real e valide a assinatura X-ME-Signature.
- [Erros e limites](https://developers.superfrete.com/guias/erros.md): Formato das respostas de erro, o que cada status HTTP significa, as mensagens mais comuns e os limites que valem para a sua integração.
- [Perguntas frequentes](https://developers.superfrete.com/faq.md): Respostas diretas para as dúvidas mais comuns de quem integra com a API da SuperFrete, de token e sandbox a saldo, cancelamento e webhooks.

## Referência da API

- [Especificação OpenAPI 3.1 (YAML)](https://developers.superfrete.com/openapi.yaml): contrato completo, fonte da verdade da API
- [Referência completa em Markdown](https://developers.superfrete.com/referencia.md): todos os endpoints em um arquivo
- [Trocar código OAuth por token](https://developers.superfrete.com/referencia/md/exchangeOAuthToken.md): POST /api/v0/oauth/token
- [Cotar frete](https://developers.superfrete.com/referencia/md/calculateShipping.md): POST /api/v0/calculator
- [Consultar regras dos serviços](https://developers.superfrete.com/referencia/md/getServicesInfo.md): GET /api/v0/services/info
- [Criar etiqueta (pedido)](https://developers.superfrete.com/referencia/md/createShipment.md): POST /api/v0/cart
- [Pagar etiqueta com saldo](https://developers.superfrete.com/referencia/md/checkoutShipment.md): POST /api/v0/checkout
- [Gerar link de impressão](https://developers.superfrete.com/referencia/md/getLabelPrintUrl.md): POST /api/v0/tag/print
- [Consultar pedido](https://developers.superfrete.com/referencia/md/getOrder.md): GET /api/v0/order/info/{id}
- [Listar pedidos](https://developers.superfrete.com/referencia/md/listOrders.md): GET /api/v0/me/orders
- [Cancelar pedido](https://developers.superfrete.com/referencia/md/cancelOrder.md): POST /api/v0/order/cancel
- [Consultar conta](https://developers.superfrete.com/referencia/md/getUser.md): GET /api/v0/user
- [Listar endereços](https://developers.superfrete.com/referencia/md/listUserAddresses.md): GET /api/v0/user/addresses
- [Listar Webhook Apps](https://developers.superfrete.com/referencia/md/listWebhooks.md): GET /api/v0/webhook
- [Criar Webhook App](https://developers.superfrete.com/referencia/md/createWebhook.md): POST /api/v0/webhook
- [Atualizar Webhook App](https://developers.superfrete.com/referencia/md/updateWebhook.md): PUT /api/v0/webhook/{id}
- [Remover Webhook App](https://developers.superfrete.com/referencia/md/deleteWebhook.md): DELETE /api/v0/webhook/{id}
- [Evento de pedido](https://developers.superfrete.com/referencia/md/orderEvent.md): webhook enviado pela SuperFrete
- [Atualização de rastreio](https://developers.superfrete.com/referencia/md/trackingUpdated.md): webhook enviado pela SuperFrete

## Optional

- [Corpus completo](https://developers.superfrete.com/llms-full.txt): todos os guias e a referência da API em um único arquivo
- [Especificação OpenAPI 3.1 (JSON)](https://developers.superfrete.com/openapi.json)