A API Tudo Envio permite que você integre cotação de frete, emissão de etiquetas dos Correios, rastreamento de objetos e gestão de clientes diretamente no seu sistema. Todas as respostas são em JSON e o servidor utiliza HTTPS obrigatório.
Todas as chamadas exigem o cabeçalho Authorization com seu token:
Authorization: Bearer seu_token_aqui/me:curl -X GET "https://tudoenvio.com.br/api/public/v1/me" \
-H "Authorization: Bearer seu_token_aqui"O limite padrão é de 60 requisições por minuto por token. Ao atingir o limite, o servidor responde
X-RateLimit-Remaining eX-RateLimit-Reset indicam quando reativar./meRetorna informações do usuário autenticado pelo token.
curl -X GET "https://tudoenvio.com.br/api/public/v1/me" \
-H "Authorization: Bearer seu_token_aqui"{
"user": {
"id": "uuid-do-usuario",
"name": "João da Silva",
"email": "joao@empresa.com.br"
}
}/saldoRetorna o saldo disponível em reais (BRL) para emissão de etiquetas.
curl -X GET "https://tudoenvio.com.br/api/public/v1/saldo" \
-H "Authorization: Bearer seu_token_aqui"{
"saldo": 152.40,
"currency": "BRL"
}/frete/cotacaoCalcula o valor e prazo para todos os serviços Correios disponíveis (PAC, SEDEX, etc).
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| cep_origem | string | Sim | CEP de origem (8 dígitos). |
| cep_destino | string | Sim | CEP de destino (8 dígitos). |
| peso | number | Sim | Peso em kg (máx. 30). |
| comprimento | number | Não | Comprimento em cm. |
| largura | number | Não | Largura em cm. |
| altura | number | Não | Altura em cm. |
| valor_declarado | number | Não | Valor declarado em reais. |
{
"cep_origem": "01310100",
"cep_destino: "20040020",
"peso": 1.5,
"comprimento": 20,
"largura": 15,
"altura": 10
}curl -X POST "https://tudoenvio.com.br/api/public/v1/frete/cotacao" \
-H "Authorization: Bearer seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{ "cep_origem": "01310100", "cep_destino: "20040020", "peso": 1.5, "comprimento": 20, "largura": 15, "altura": 10 }'{
"cotacoes": [
{ "servico": "PAC", "codigo_servico": "03298", "valor": 18.50, "prazo": 7, "erro": null },
{ "servico": "SEDEX", "codigo_servico": "03220", "valor": 32.90, "prazo": 2, "erro": null }
]
}/etiquetasCria uma nova etiqueta de postagem. O valor é debitado do saldo do usuário.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| servico | string | Sim | Código do serviço (ex: 03220 para SEDEX). |
| remetente | object | Sim | Dados do remetente (nome, documento, endereço completo). |
| destinatario | object | Sim | Dados do destinatário (nome, documento, endereço completo). |
| peso | number | Sim | Peso em kg. |
| dimensoes | object | Sim | Objeto com altura, largura e comprimento em cm. |
| valor_declarado | number | Não | Valor declarado em reais. |
{
"servico": "03220",
"remetente": {
"nome": "Loja XYZ",
"documento": "12345678000190",
"cep": "01310100",
"logradouro": "Av. Paulista",
"numero": "1000",
"bairro": "Bela Vista",
"cidade": "São Paulo",
"uf": "SP"
},
"destinatario": {
"nome": "Maria Souza",
"documento": "12345678900",
"cep": "20040020",
"logradouro": "Rua da Quitanda",
"numero": "50",
"bairro": "Centro",
"cidade": "Rio de Janeiro",
"uf": "RJ"
},
"peso": 1.5,
"dimensoes": { "altura": 10, "largura": 15, "comprimento": 20 }
}curl -X POST "https://tudoenvio.com.br/api/public/v1/etiquetas" \
-H "Authorization: Bearer seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{ "servico": "03220", "remetente": { "nome": "Loja XYZ", "documento": "12345678000190", "cep": "01310100", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cidade": "São Paulo", "uf": "SP" }, "destinatario": { "nome": "Maria Souza", "documento": "12345678900", "cep": "20040020", "logradouro": "Rua da Quitanda", "numero": "50", "bairro": "Centro", "cidade": "Rio de Janeiro", "uf": "RJ" }, "peso": 1.5, "dimensoes": { "altura": 10, "largura": 15, "comprimento": 20 } }'{
"etiqueta": {
"id": "uuid-da-etiqueta",
"codigo_rastreamento": "BR123456789BR",
"servico": "SEDEX",
"status": "emitida",
"valor": 32.90,
"url_pdf": "https://..."
}
}/etiquetas/{id}Retorna os dados de uma etiqueta já emitida.
curl -X GET "https://tudoenvio.com.br/api/public/v1/etiquetas/{id}" \
-H "Authorization: Bearer seu_token_aqui"{
"etiqueta": {
"id": "uuid-da-etiqueta",
"codigo_rastreamento": "BR123456789BR",
"servico": "SEDEX",
"status": "emitida",
"valor": 32.90,
"created_at": "2026-06-11T02:00:00Z"
}
}/rastreamento/{codigo}Consulta os eventos de rastreio de um código dos Correios.
curl -X GET "https://tudoenvio.com.br/api/public/v1/rastreamento/{codigo}" \
-H "Authorization: Bearer seu_token_aqui"{
"codigo": "BR123456789BR",
"eventos": [
{ "data": "2026-06-11T08:30:00Z", "local": "São Paulo / SP", "descricao": "Objeto postado" },
{ "data": "2026-06-12T14:00:00Z", "local": "Rio de Janeiro / RJ", "descricao": "Objeto entregue" }
]
}/clientesRetorna a lista de clientes cadastrados pelo usuário.
curl -X GET "https://tudoenvio.com.br/api/public/v1/clientes" \
-H "Authorization: Bearer seu_token_aqui"{
"clientes": [
{ "id": "uuid", "nome": "Maria Souza", "documento": "12345678900", "email": "maria@email.com" }
]
}/clientesCadastra um novo cliente no catálogo.
{
"nome": "Maria Souza",
"documento": "12345678900",
"email": "maria@email.com",
"telefone": "11999999999",
"cep": "20040020",
"logradouro": "Rua da Quitanda",
"numero": "50",
"bairro": "Centro",
"cidade": "Rio de Janeiro",
"uf": "RJ"
}curl -X POST "https://tudoenvio.com.br/api/public/v1/clientes" \
-H "Authorization: Bearer seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{ "nome": "Maria Souza", "documento": "12345678900", "email": "maria@email.com", "telefone": "11999999999", "cep": "20040020", "logradouro": "Rua da Quitanda", "numero": "50", "bairro": "Centro", "cidade": "Rio de Janeiro", "uf": "RJ" }'{ "cliente": { "id": "uuid", "nome": "Maria Souza" } }Toda resposta de erro segue o formato padrão abaixo:
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Descrição amigável do problema."
}
}| Código | HTTP | Descrição |
|---|---|---|
| UNAUTHORIZED | 401 | Token ausente, inválido ou revogado. |
| FORBIDDEN | 403 | Acesso não autorizado a este recurso. |
| VALIDATION_ERROR | 400 | Dados de entrada inválidos. |
| CLIENT_NOT_FOUND | 404 | Recurso não encontrado. |
| INSUFFICIENT_BALANCE | 402 | Saldo insuficiente para emitir a etiqueta. |
| RATE_LIMITED | 429 | Limite de chamadas excedido. |
| INTERNAL_ERROR | 500 | Erro interno do servidor. |
Dúvidas ou problemas? Entre em contato em contato@tudoenvio.com.br ou pela página Ajuda.