API Fiscal

API para emissão de NF-e e NFC-e

Integre o seu sistema (loja virtual, ERP ou aplicativo) ao emissor da WLG e emita NF-e e NFC-e por API REST. Cancelamento, carta de correção e download de XML e DANFE também estão disponíveis.

A API é gratuita e já está em produção. Gere as credenciais no portal, teste em homologação e depois emita em produção.

Ver documentação da API
Grátis. Sem limite de notas. Sem cartão.

O que a API faz

  • Emissão de NF-e e NFC-eModelos 55 e 65. A emissão é assíncrona: você acompanha cada envio pelo operationId.
  • CancelamentoCancele notas autorizadas informando a justificativa.
  • Carta de correção (CC-e)Envie a correção e a sequência é calculada automaticamente.
  • XML e DANFEBaixe o XML, o DANFE em PDF ou os dois em ZIP, além dos XMLs de cancelamento e CC-e.

Do token à nota em 4 chamadas

Exemplos com curl. O contrato completo de cada endpoint está na documentação Swagger.

Autenticar
curl -X POST https://fiscal.wlgsistemas.com.br/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{ "clientId": "SEU_CLIENT_ID", "clientSecret": "SEU_CLIENT_SECRET" }'

# → { "accessToken": "eyJhbGciOi...", "tokenType": "Bearer", "expiresIn": 3600 }
Emitir a NF-e ou NFC-e
curl -X POST https://fiscal.wlgsistemas.com.br/api/v1/nfe \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "empresaId": "ID_DA_EMPRESA",
    "tipoAmbiente": 2,
    "ide": { "modelo": 55, "serie": 1, "numero": 1234, ... },
    "emitente": { ... },
    "destinatario": { ... },
    "itens": [ { ... } ],
    "totais": { ... },
    "pagamento": { ... }
  }'

# → 202 { "operationId": "6f1e61b8-...", "status": "PROCESSANDO" }
Consultar o resultado
curl https://fiscal.wlgsistemas.com.br/api/v1/operacoes/OPERATION_ID \
  -H "Authorization: Bearer SEU_TOKEN"

# → { "status": "SUCCESSO", "chaveNfe": "3524...", "dataAutorizacao": "..." }
# ou { "status": "ERRO", "motivoErro": "Rejeição ..." }
Baixar o DANFE e o XML
curl https://fiscal.wlgsistemas.com.br/api/v1/nfe/CHAVE/danfe \
  -H "Authorization: Bearer SEU_TOKEN" -o danfe.pdf

# também: /xml (XML) e /zip (XML + DANFE)

Como começar

  1. Crie sua conta gratuita e configure o certificado digital e os dados fiscais da empresa. O suporte ajuda em cada etapa.

  2. No Portal do Cliente, abra Fiscal API e crie uma credencial. Copie o ClientId e o ClientSecret: o secret só é exibido na criação.

  3. Teste a integração no ambiente de homologação (tipoAmbiente = 2).

  4. Com tudo validado, passe a emitir em produção (tipoAmbiente = 1).

Por que usar a API da WLG

  • API gratuita, sem cartão
  • NF-e e NFC-e na mesma API
  • Homologação para testar sem valor fiscal
  • Documentação interativa (Swagger)
  • Várias empresas na mesma conta
  • Suporte humano via WhatsApp
FAQ

Perguntas frequentes

A API de NF-e da WLG é gratuita?

Sim. A API é gratuita e está disponível para as contas do emissor, sem cadastro de cartão.

Quais documentos a API emite?

NF-e (modelo 55) e NFC-e (modelo 65). A API também cancela notas autorizadas, emite carta de correção (CC-e) e disponibiliza o XML e o DANFE.

Como funciona a autenticação da API?

Você cria uma credencial (ClientId e ClientSecret) no Portal do Cliente e a troca por um token de acesso válido por 1 hora, enviado no cabeçalho Authorization: Bearer.

A emissão pela API é síncrona?

Não. A emissão é assíncrona: a API responde com um operationId e você consulta o status até receber sucesso, com a chave da nota, ou erro, com o motivo da rejeição.

Posso testar antes de emitir em produção?

Sim. Use o ambiente de homologação (tipoAmbiente = 2) para testar a integração sem valor fiscal.

Onde fica a documentação da API?

Na documentação interativa (Swagger) em fiscal.wlgsistemas.com.br/swagger, com todos os endpoints, os contratos de request e response e a opção de testar as chamadas.

Veja também