Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Guia de Primeiros Passos

Se você está integrando pela primeira vez, siga esta sequência em ordem. Não pule etapas.

Sumário​

Fluxo geral​

Etapa 1 — Obter credenciais​

No painel nfe.io, crie uma API Key em Configurações → Chaves de API. Guarde-a com segurança — ela só é exibida uma vez.

Etapa 2 — Localizar seu company_id​

Em Empresas, clique na empresa que deseja integrar e copie o company_id exibido na URL ou nos detalhes da empresa.

Etapa 3 — Ativar o inbound​

Faça uma requisição para ativar o monitoramento do CNPJ:

curl -X POST \
  "https://api.nfe.io/v2/companies/SEU_COMPANY_ID/inbound/productinvoices" \
  -H "Authorization: ApiKey SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "StartFromNsu": 0,
    "StartFromDate": "2024-01-01T00:00:00Z",
    "EnvironmentSEFAZ": "Production",
    "WebhookVersion": 2
  }'

Resposta esperada: { "status": "Active", ... }

Etapa 4 — Configurar seu endpoint de webhook​

No painel nfe.io, vá em Webhooks e cadastre a URL do seu servidor que vai receber as notificações.

Mínimo necessário no seu endpoint:

# Python (Flask)
@app.route('/webhook', methods=['POST'])
def webhook():
    data = request.json
    access_key = data['accessKey']
    # Processar...
    return '', 200  # OBRIGATÓRIO retornar 200

Etapa 5 — Verificar que documentos chegam​

Após ativar, aguarde entre 15 minutos e 4 horas. Consulte documentos recebidos:

curl "https://api.nfe.io/v2/companies/SEU_COMPANY_ID/inbound/productinvoices/CHAVE_44_DIGITOS" \
  -H "Authorization: ApiKey SUA_API_KEY"

Etapa 6 — Migrar para produção​

Quando seus testes estiverem OK com "EnvironmentSEFAZ": "Test", recrie a configuração com "Production":

# 1. Desativar o inbound de homologação
curl -X DELETE \
  "https://api.nfe.io/v2/companies/SEU_COMPANY_ID/inbound/productinvoices" \
  -H "Authorization: ApiKey SUA_API_KEY"

# 2. Ativar com ambiente de produção
curl -X POST \
  "https://api.nfe.io/v2/companies/SEU_COMPANY_ID/inbound/productinvoices" \
  -H "Authorization: ApiKey SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "StartFromNsu": 0,
    "StartFromDate": "2024-01-01T00:00:00Z",
    "EnvironmentSEFAZ": "Production",
    "WebhookVersion": 2
  }'

Importante: Documentos de ambiente Test (homologação SEFAZ) e Production são separados. Nunca misture os dois na mesma configuração.

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.