Documentação SoftMax

Bem-vindo à documentação oficial da SoftMax. Aqui você encontra tudo que precisa para usar nossos sistemas de forma eficiente.

Primeiros Passos

Siga estes passos para configurar sua conta e começar a usar o sistema:

Crie sua conta

Acesse a página de trial e crie sua conta gratuita. Você terá 7 dias para testar todas as funcionalidades sem compromisso.

Configure sua empresa

Preencha os dados da sua empresa como CNPJ, razão social e endereço. Essas informações são usadas para emissão de notas fiscais.

Importe seus dados

Use nossa ferramenta de importação para trazer clientes, produtos e outros dados de planilhas Excel ou outros sistemas.

Comece a usar!

Explore os módulos, faça sua primeira venda, emita uma nota fiscal ou cadastre um agendamento.

Módulos Disponíveis

Acesse a documentação específica de cada módulo:

Autenticação

Para acessar a API, você precisa de uma chave de API (API Key). Você pode gerar sua chave no painel administrativo em Configurações → API.

Importante

Mantenha sua chave de API em segurança. Não a compartilhe publicamente ou inclua em código client-side.

Exemplo de Requisição

// Exemplo de requisição autenticada curl -X GET "https://api.softmaxbr.com.br/v1/clientes" \ -H "Authorization: Bearer SUA_API_KEY" \ -H "Content-Type: application/json"

Resposta

{ "success": true, "data": [ { "id": 1, "nome": "João Silva", "email": "joao@email.com", "telefone": "(11) 99999-1234" } ], "total": 1 }

Dica

Use o parâmetro ?limit= e ?offset= para paginar os resultados em listas grandes.

Webhooks

Configure webhooks para receber notificações em tempo real sobre eventos no sistema:

  • Vendas: nova_venda, venda_cancelada, pagamento_recebido
  • Clientes: cliente_criado, cliente_atualizado
  • Estoque: estoque_baixo, produto_atualizado
  • NF-e: nfe_autorizada, nfe_cancelada

Integrações

O SoftMax se integra com diversas plataformas:

  • Pagamentos: PagSeguro, MercadoPago, Stripe, PIX
  • Marketplaces: Mercado Livre, Amazon, Shopee
  • Contabilidade: Conta Azul, Omie, Bling
  • Logística: Correios, Jadlog, Melhor Envio

Emissão de NF-e

Para emitir notas fiscais eletrônicas, você precisa:

  1. Certificado digital A1 válido
  2. Inscrição estadual ativa
  3. Cadastro completo da empresa
  4. Configuração dos impostos (ICMS, PIS, COFINS)

Importação de Dados

Importe dados via planilha Excel ou CSV. Formatos suportados:

  • Clientes (nome, CPF/CNPJ, endereço, contato)
  • Produtos (código, descrição, preço, estoque)
  • Fornecedores (razão social, CNPJ, contato)

Exportação de Dados

Exporte seus dados a qualquer momento em formato Excel, CSV ou PDF. Disponível para todos os módulos.

Precisa de ajuda?

Se você não encontrou o que procurava, entre em contato com nossa equipe de suporte: