Como começar

Peça acesso à equipe

O cadastro público ainda não está aberto. Fale com a equipe pelo WhatsApp pra ativarem sua conta. Você vai receber um e-mail e senha pra entrar em api.sysvelox.com/login.php.

Cadastre sua empresa (CNPJ)

Depois de entrar, vá em Minha conta → Empresas e clique em "+ Cadastrar novo CNPJ". Preencha os dados cadastrais (razão social, CRT, endereço). Você pode ter mais de um CNPJ na mesma conta — todos compartilham a mesma franquia de documentos do plano.

Onde encontrar cada dado: CRT (1, 2 ou 3) e código IBGE do município ficam no cartão CNPJ ou com seu contador; o código IBGE também pode ser consultado no site do IBGE pelo nome da cidade.

Envie o certificado digital

Na mesma tela de Empresas, depois de cadastrar o CNPJ, abra "+ Enviar certificado digital (.pfx)". Envie o arquivo .pfx (ou .p12) do certificado A1 da empresa, a senha dele, e escolha o ambiente:

• test — usa a SEFAZ de homologação. Nunca gera uma nota fiscal real, seguro pra testar à vontade.
• live — usa a SEFAZ de produção. Gera documentos fiscais reais.

A senha é criptografada assim que chega no servidor — ninguém, nem a equipe do SysVelox, consegue vê-la depois disso.

Gere uma chave de API

Vá em Minha conta → Chaves de API, escolha o ambiente test e clique em "Gerar nova chave". Copie o valor gerado (começa com sk_test_...) — ele só aparece uma vez, nunca fica visível de novo depois.

Quando estiver pronto pra emitir notas reais, gere uma chave sk_live_... separada. Nunca use uma chave live nos seus testes.

Faça sua primeira chamada

Veja os exemplos prontos em cURL, PHP, Node.js, Python e Java — copie, cole sua chave e o company_id (você encontra o ID da empresa passando o mouse sobre ela na tela de Empresas), e rode. Em poucos segundos você recebe uma resposta com status: "processando".

Acompanhe o resultado

A emissão é assíncrona — a SEFAZ pode levar alguns segundos pra responder. Duas formas de saber o resultado final:

• Consultar: GET /v1/notas/{id} a cada alguns segundos, até o status virar autorizado ou rejeitado.
• Webhook (recomendado): cadastre uma URL em Minha conta → Webhooks e receba a notificação automaticamente, sem precisar ficar perguntando.

Baixe o XML e o DANFE

Depois de autorizado, baixe o XML (GET /v1/notas/{id}/xml) e o PDF pronto pra impressão (GET /v1/notas/{id}/danfe) — nada pra montar na mão.