Documentação da API Pública

Integre o motor de cálculo do CVIP em qualquer sistema ou aplicação

Base URL: cvip.vercel.app Auth: Bearer Token Engine v9.0.0

Autenticação

Todas as requisições precisam do header Authorization: Bearer {sua_chave_api}. Para testes, use a chave de demonstração abaixo:

HTTP Header

Authorization: Bearer cvip_test_key_demo_1234

💡 Obtenha sua chave de API em Configurações → Integrações. A chave de demo é de uso exclusivo para testes e tem limite de 100 requisições/dia.

POST /api/calcular

Integre o motor de cálculo do CVIP em qualquer sistema ou aplicação

Parâmetros do Body (JSON)

Campo	Tipo	Req.	Descrição
quantidade	number	Obrigatório	Número de unidades compradas
cotacao_usd	number	Obrigatório	Cotação do dólar em R$
preco_usd	number	Obrigatório	Preço unitário em USD
frete_usd	number	Opcional	Frete total da importação em USD (default: 0)
ii_tax	number	Opcional	Imposto de importação em % (default: 0)
icms_tax	number	Opcional	ICMS estadual em % (default: 0)
icms_por_dentro	boolean	Opcional	Calcular ICMS pelo método 'por dentro' (default: false)
courier_fee	number	Opcional	Taxa de despacho/courier em BRL (default: 0)
tipo	string	Opcional	'importacao' ou 'nacional' (default: 'importacao')
preco_venda	number	Opcional	Preço de venda estimado em BRL
tarifa_mkt	number	Opcional	Tarifa do marketplace em % (default: 0)
imposto_venda	number	Opcional	Imposto sobre a venda em % (default: 0)
frete_venda	number	Opcional	Frete de venda em BRL (default: 0)
embalagem	number	Opcional	Custo de embalagem em BRL (default: 0)
is_kit	boolean	Opcional	Vender como kit (default: false)
unidades_por_kit	number	Opcional	Unidades por kit, se is_kit=true

Exemplos de Código

cURL

curl -X POST https://cvip.vercel.app/api/calcular \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer cvip_test_key_demo_1234" \
  -d '{"quantidade":100,"cotacao_usd":5.75,"preco_usd":15,"ii_tax":20,"icms_tax":17,"preco_venda":249.9}'

Exemplo de Requisição

JSON

{
  "quantidade": 100,
  "cotacao_usd": 5.75,
  "preco_usd": 15,
  "frete_usd": 50,
  "ii_tax": 20,
  "icms_tax": 17,
  "icms_por_dentro": false,
  "courier_fee": 200,
  "preco_venda": 249.9,
  "tarifa_mkt": 15,
  "imposto_venda": 8
}

Exemplo de Resposta (200)

JSON

{
  "etapa_1_aquisicao": {
    "valor_aduaneiro_usd": 1550,
    "valor_aduaneiro_brl": 8912.5,
    "imposto_importacao_brl": 1782.5,
    "icms_brl": 1786.81,
    "total_impostos_brl": 3569.31,
    "courier_fee_brl": 200,
    "custo_total_importacao_brl": 12681.81,
    "custo_unitario_brl": 126.82
  },
  "etapa_2_venda": {
    "preco_venda_brl": 249.9,
    "custo_produto_venda_brl": 126.82,
    "total_despesas_venda_brl": 57.48,
    "lucro_unitario_brl": 65.6,
    "margem_pct": 26.25,
    "roi_pct": 51.72
  },
  "etapa_3_projecao": {
    "investimento_total_brl": 12681.81,
    "quantidade_vendas_possiveis": 100,
    "receita_bruta_brl": 24990,
    "lucro_liquido_total_brl": 6560,
    "fator_multiplicador": 1.97,
    "break_even_unidades": 194
  },
  "meta": {
    "tipo": "importacao",
    "timestamp": "2026-05-14T18:00:00.000Z",
    "engine_version": "9.0.0"
  }
}

Códigos de Erro

Status	Significado
200 OK	Cálculo realizado com sucesso
400 Bad Request	Body JSON malformado
401 Unauthorized	Chave de API ausente ou inválida
422 Unprocessable Entity	Parâmetros obrigatórios ausentes ou inválidos
500 Internal Server Error	Erro interno no motor de cálculo

🚦 Rate Limits

Chave de demo: 100 req/dia | Plano PRO: 10.000 req/mês | Plano Parceiro: ilimitado

Obter minha Chave de API