API FISCAL · NOTA FISCAL

NF-e e NFS-e.Na mesma API.

Produto e serviço em uma única integração REST. Sem componente: XML, assinatura, SEFAZ e DANFE sob nossa responsabilidade.

Sem componenteAPI REST via HTTPSNF-e + NFS-eA1 + A3
SPWB · DOCUMENTO FISCALNº 000.123
NF-eNFS-eexemplo
EmitenteSPWB Tecnologia
DestinatárioCliente Exemplo Ltda.
Produto · SKU-001R$ 249,90
Serviço · integraçãoR$ 1.200,00
TotalR$ 1.449,90
Autorizado

chave 3526 1111 2223 3300 0181 5500 1000 0000 0210 0000 0023

pronto·simulação

Clique para simular a emissão

  • API REST via HTTPS
  • NF-e + NFS-e
  • Certificado A1 + A3
  • Síncrono + assíncrono
  • Suporte dev para dev

DOCUMENTOS

Produto e serviço. Um só contrato.

A NF-e documenta a circulação de mercadoria. A NFS-e documenta a prestação de serviço. A SPWB cobre os dois com a mesma API.

Modelo 55

NF-e

Nota Fiscal Eletrônica

Documenta a operação de circulação de mercadoria, com emitente, destinatário, itens, impostos e pagamento.

  • Emissão, consulta, cancelamento e carta de correção
  • DANFE pronto para impressão
  • Manifestação do destinatário
  • Chave de acesso de 44 dígitos

Serviço

NFS-e

Nota Fiscal de Serviço Eletrônica

Documenta a prestação de serviços, com tomador, descrição, valor e tributação do município do emitente.

  • Emissão e consulta do documento de serviço
  • Padrão nacional e regras do município
  • DANFSE para o tomador
  • Cancelamento conforme a regra da praça

Emita a NF-e da mercadoria e a NFS-e do serviço com a mesma credencial e o mesmo padrão de resposta.

01

JSON

02

XML

03

Assinatura

04

SEFAZ

05

Autorizado

06

DANFE

Fluxo do documento

MANIFESTO

“Produto e serviço não deveriam viver em integrações diferentes.”

A SPWB unifica NF-e e NFS-e em uma API REST, com a regra fiscal, a assinatura e a transmissão do nosso lado. Uma credencial, dois documentos.

SPWB API FISCAL

POR QUE TROCAR

O fiscal não deveria ser o gargalo do seu produto.

Se a sua equipe gasta tempo com schema, SEFAZ e componente, o produto perde velocidade. A API devolve esse tempo.

01hoje

NF-e e NFS-e em fornecedores, contratos e fluxos diferentes.

Um contrato, uma credencial e dois documentos na mesma integração.

02hoje

Cada município tem uma regra de NFS-e.

A API padroniza a chamada e trata a particularidade da praça, com o time confirmando a cobertura.

03hoje

A Reforma Tributária muda o leiaute às pressas.

Acompanhamos as notas técnicas e mantemos a API compatível. O seu produto não corre atrás de cada mudança.

COMO FUNCIONA

Do JSON ao DANFE em quatro passos.

A sua aplicação envia os dados. A SPWB monta, assina e transmite. O retorno chega estruturado.

01

Credenciais

Você recebe o token e o ambiente de homologação para testar o fluxo completo.

02

JSON

Envia as partes, os itens, os impostos e o pagamento da operação.

03

Assinatura e SEFAZ

A API monta o XML, assina com o certificado A1 ou A3 e transmite ao autorizador.

04

XML + DANFE

Recebe o documento autorizado, a chave, o protocolo e o DANFE ou DANFSE.

RECURSOS

O fiscal resolvido. O produto no seu foco.

Cada recurso existe para tirar uma responsabilidade da sua equipe e devolver tempo de produto.

API REST via HTTPS

Integra com qualquer linguagem. Sem SDK obrigatório, sem DLL, sem OCX.

NF-e + NFS-e

Produto e serviço na mesma integração, com uma credencial e um contrato.

Certificado A1 e A3

Flexibilidade para operações que ainda dependem de token e para quem já opera em nuvem.

Atualizações fiscais

Schemas e notas técnicas aplicados no servidor, sem reinstalar cliente.

Síncrono e assíncrono

Escolha o fluxo que combina com a sua operação e com o volume de emissão.

Dev para dev

Suporte técnico de quem entende a API e a regra fiscal, não script de atendimento.

EXPERIÊNCIA DO DEV

A API que o seu time entende.

Sem SDK obrigatório. Sem componente. Um HTTP client resolve. O resto é JSON.

  • Exemplos em cURL, PHP, Node e C#.
  • Resposta estruturada com cStat, chave, protocolo e URLs de XML, DANFE e DANFSE.
  • Ambiente de homologação para testar antes de produção.
  • Erros decodificados com contexto para corrigir rápido.

A API não exige instalação no cliente. O seu produto continua leve.

Qualquer stacksem instalação
Delphi.NETPHPNodePythonJavaGo+ HTTP client
request
POST https://api.spwb.com.br/v1/nfe
Authorization: Bearer $SPWB_TOKEN
Content-Type: application/json
response201 created
{
  status: 201,
  cStat: "100",
  chave: "35261111222333000181550010000000021000000023"
}
Resposta estruturadaHTTPS · A1 + A3

SEM COMPONENTE

O modelo antigo prende. A API liberta.

Se o seu produto precisa escalar, atender multi-CNPJ e atualizar sem reinstalar, o componente vira custo.

Instalação no cliente

DLLUma DLL por máquina

Nenhuma instalação

Atualização fiscal

DLLReinstalar versão

Automática no servidor

Stack

DLLDelphi, C#, VB6

Qualquer linguagem com HTTPS

Multi-CNPJ e multi-tenant

DLLComplexo

Nativo

Certificado

DLLPreso à máquina

A1 e A3 com gestão central

Escala

DLLUma instância por cliente

Uma API para toda a base

Observabilidade

DLLLog local

Resposta estruturada + status

Comparativo de modelos de integração. Não se refere a um fabricante específico.

ABRANGÊNCIA

Mercadoria e serviço. Sem trocar de fornecedor.

A mesma API atende a nota de produto e a nota de serviço, com o tratamento fiscal de cada uma.

COBERTURA

NF-e · modelo 55

Circulação de mercadoria, com itens, impostos, transporte e pagamento.

JSONSEFAZXML + DANFE

A cobertura de NFS-e depende do município e do padrão adotado. O time técnico confirma a sua praça antes da integração.

SEGURANÇA

Certificado certo. Credencial protegida.

A assinatura e a transmissão acontecem no nosso lado. A sua responsabilidade fica no produto.

A1 + A3

certificados suportados pela API

Certificado A1

Assinatura no servidor, sem depender da máquina do cliente.

Certificado A3

Suporte para operações que usam token. O time orienta o formato de envio.

HTTPS de ponta a ponta

Credenciais e documentos trafegam em canal seguro.

Dados sob controle

Credenciais isoladas por emitente e políticas de acesso por ambiente.

SUPORTE

Suporte dev para dev. Sem script.

Quem responde entende de API e de regra fiscal. Isso encurta a integração e evita tentativa e erro.

  • Atendimento técnico de quem conhece a API e o autorizador.
  • Ajuda na integração, na homologação e na leitura dos retornos.
  • Canal direto com o time de engenharia durante o projeto.
dev para devdurante a integração
Suporte técnico
online

Dev · ERP

A NFS-e voltou com rejeição de município. Como leio o retorno?

SPWB · engenharia

O retorno traz o código da praça e a mensagem do autorizador. Vamos validar o cadastro do emitente com você.

exemplo ilustrativo de atendimento

TAMBÉM ATENDE TRANSPORTE?

CT-e e MDF-e na mesma infraestrutura.

Se o seu produto também atende transporte, a SPWB cobre o frete e o manifesto.

Conhecer CT-e + MDF-e

FAQ

Perguntas que o seu time vai fazer.

Respostas diretas para as dúvidas que aparecem antes da integração.

Qual é a diferença entre NF-e e NFS-e?
A NF-e documenta a circulação de mercadoria. A NFS-e documenta a prestação de serviço. As duas têm regras, autorizadores e documentos auxiliares próprios. A SPWB entrega as duas na mesma API.
A API emite NFS-e no padrão nacional?
Sim. A API trabalha com o padrão nacional e com as particularidades do município do emitente. A cobertura da sua praça é confirmada pelo time técnico antes da integração.
Como funciona a emissão para vários municípios?
Cada emitente é cadastrado com o seu município e as suas credenciais. A chamada é padronizada; a API trata a regra da praça. Municípios com exigências específicas são validados na homologação.
A API acompanha a Reforma Tributária?
A API é mantida conforme as notas técnicas que afetam NF-e e NFS-e. A atualização acontece no servidor, sem reinstalar cliente. O seu time acompanha o calendário e nós cuidamos da compatibilidade.
Como funciona o certificado A1 e A3?
A API aceita certificados A1 e A3. O formato de envio depende do modelo do certificado e da operação. O time técnico orienta o caminho correto na integração.
Existe ambiente de homologação?
Sim. A integração começa em homologação, sem valor fiscal, para validar o fluxo, os retornos e a impressão do DANFE ou DANFSE antes de ir para produção.
Consigo emitir DANFE e consultar o status?
Sim. A API retorna o XML autorizado, a chave, o protocolo e o DANFE ou DANFSE. A consulta de status usa a chave de acesso e devolve a situação atual do documento.
A API atende multi-tenant?
Sim. Cada emitente tem suas credenciais e seu certificado. A mesma integração atende a base, o que resolve o cenário de software house, ERP e SaaS.

PRÓXIMO PASSO

Coloque a API no seu fluxo.

Fale com o time da SPWB, receba o acesso de homologação e integre com o seu stack.

01

Conversa técnica

Entendemos o seu cenário, o volume e o stack.

02

Homologação

Você recebe acesso e testa o fluxo completo.

03

Produção

A integração vira rotina, com suporte dev para dev.

O que você precisa emitir?

Retornamos pelo canal que você preferir.