🌸 Cotação CDV — Admin

Faixas de cliente

Edite o JSON e salve. Estrutura: cada faixa tem nome, min_pedido e regra de frete grátis.

Caixas (embalagem)

peso_cartela_g é o peso unitário da cartela. Sistema escolhe a menor caixa cuja capacidade comporta o pedido.

Mapa de apelidos → SKU

A chave é o apelido normalizado (sem espaços/maiúsculas) que aparece no texto do pedido. O valor é o SKU exato no inventário Bling.

Preços FM (matriz tarifa × peso)

JSON gerado da Proposta Comercial. Edite com cuidado — uma linha errada quebra a cotação. Estrutura: {tarifas:[], faixas_peso_kg:[], precos_por_kg:{tarifa:[v1,v2,...]}}.

Regras FM (Seguro/GRIS/Devolução)

Subsídio Sedex (quando FM ficou grátis)

Lista de regras avaliadas em ordem. Primeira que casar (UF + faixa + valor mínimo) define o desconto fixo a abater do Sedex retornado pela Frenet. Use "*" para wildcard.

Configuração Frenet

Token Frenet NÃO está aqui — vai como wrangler secret put FRENET_TOKEN. Aqui só CEP origem e filtros de serviço.

💳 Pagar.me — credenciais e configuração

A Secret Key NUNCA aparece em GET (mascarada). Para alterar, cole o valor novo. Para manter o atual, deixe o campo vazio ou com a versão mascarada.

📡 Webhook
Cadastre no painel da Pagar.me em Configurações → Webhooks:
  • URL: https://cdv-cotacao-api.ciliosdasdivas.workers.dev/webhook/pagar-me
  • Categoria de eventos: PEDIDO (marque pelo menos order.paid, order.payment_failed, order.canceled)
  • Habilitar autenticação: Sim — defina um usuário e senha quaisquer e cole os mesmos valores nos campos acima.
Sem webhook ainda funciona — o sistema faz polling a cada 15 min como fallback.

🟧 Banco Inter — PIX (0% sem taxa)

Inter cobra 0% no PIX para sempre. Requer setup mais técnico (OAuth + certificado mTLS), mas economiza 1% por transação.

📋 Tutorial completo
  1. Login em contadigital.bancointer.com.br/empresas com sua conta PJ Inter
  2. Menu lateral → "Inter Empresas / Aplicações" (ou "API Banking")
  3. Clica "Criar nova aplicação":
    • Tipo: Pix Recebimento (selecione todos os escopos PIX)
    • Webhook (opcional): https://cdv-cotacao-api.ciliosdasdivas.workers.dev/webhook/inter
  4. Após criar, vai aparecer:
    • Client ID (UUID) → copia pro campo acima
    • Client Secret → copia pro campo acima
    • Certificado .crt e chave .key — você vai BAIXAR esses 2 arquivos
  5. Salve aqui no admin: Client ID + Client Secret + chave PIX
  6. ⚠️ Subir o certificado mTLS no Cloudflare (passo único, técnico):
    cd C:\Users\User\Downloads\cdv-cotacao
    npx wrangler mtls-certificate upload \
      --cert caminho/inter-cert.crt \
      --key caminho/inter-key.key \
      --name inter-cert
    O comando devolve um certificate_id. Me avisa esse ID que eu adiciono no wrangler.toml e re-deploy.
  7. Após o re-deploy, marca "Habilitado: Sim" aqui → 🔌 Testar conexão deve passar ✓
Nota: nada acontece em produção até você marcar "Habilitado: Sim". Pode preencher tudo agora e ativar quando o cert estiver subido.

📱 Mercado Pago — PIX (sem taxa de transação)

Configure o Access Token PJ para gerar QR Code PIX direto no painel. PIX no MP é gratuito para receber até alto volume.

📡 Como pegar seu Access Token (PJ)
  1. Logue em mercadopago.com.br/developers/panel/app com sua conta PJ
  2. Clique em "Criar aplicação" (se ainda não tem). Tipo: "Pagamentos online", marque PIX.
  3. Na sua aplicação, vá em "Credenciais de produção"
  4. Copie o "Access Token" (começa com APP_USR-)
  5. Para testar antes, use as "Credenciais de teste" (token começa com TEST-)
  6. Cole o token acima → Salvar🔌 Testar conexão
📡 Webhook Cadastre na sua aplicação em Webhooks → Configurar notificações:
  • URL: https://cdv-cotacao-api.ciliosdasdivas.workers.dev/webhook/mercadopago
  • Eventos: Pagamentos (payment)
Sem webhook funciona — o sistema faz polling a cada 15 min como fallback.

Ajustes gerais

dias_extras_prazo: dias úteis adicionados ao prazo de FM e Sedex como margem de segurança (ex: 1 deixa "7 dias" virar "8 dias" na cotação).

Atualizar inventário

Selecione o arquivo .xlsx exportado do Bling. O sistema lê localmente no navegador, extrai SKU + Disponível e envia.

Histórico de cotações (últimos 30 dias)