4,9 no Google

Toda a camada fiscal do seu software, por API.

API de nota fiscal para ERPs, SaaS e marketplaces: emita NF-e, NFS-e e NFC-e, receba as notas contra os seus CNPJs e reaja por webhook. Pronta para a Reforma Tributária, com um time fiscal acompanhando a integração.

seu-sistema · stdout
↗ prefeitura de São Paulo
✓ autorizada · 135240001924
← webhook → 200 OK
10s · loop
NFS-e · 000913
autorizada

total

R$ 297,00

protocolo 135240001924

PDF ↓XML ↓
webhook
✓invoice.queued
✓invoice.authorized
✓entregue · 200 OK

assinatura verificada

+12.000

empresas atendidas

+60 milhões

notas fiscais emitidas

+R$ 10 bilhões

em volume processado

sebraejusbrasilsesco-novo-mercadofluencypass

01 — plataforma

Tudo que o fiscal exige, atrás de um contrato só.

Emitir é a parte visível. O que mantém um sistema em dia com o Fisco é o que acontece antes e depois: as notas que chegam, os eventos que mudam e os campos que a lei passa a exigir.

NF-e · NFS-e · NFC-e

Emissão

Autorização, PDF, XML, cancelamento, carta de correção e inutilização pelo mesmo contrato.

SEFAZ · Ambiente Nacional

Recebidas e tomadas

O que emitem contra cada CNPJ chega sozinho, com manifestação e XML completo.

Standard Webhooks

Eventos

Todo o ciclo de vida por webhook assinado, com segredo rotacionável e retry idempotente.

1 conta · N CNPJs

Multiempresa

Certificado, série, numeração e configuração independentes por empresa.

CBS · IBS · IS

Reforma Tributária

Blocos novos já no schema: por item na NF-e/NFC-e, por nota na NFS-e.

llms.txt · OpenAPI

Agentes de IA

O Cursor, o Copilot ou o Claude do seu time leem a documentação e escrevem o cliente da API.

02 — arquitetura

O seu sistema faz uma chamada. O resto é com a Spedy.

Uma chamada entra, os órgãos respondem, o evento volta assinado. SEFAZ, prefeituras e Ambiente Nacional deixam de existir no seu código.

  1. 1Seu sistemaPOST /v1/orders
  2. 2Spedy APIvalida · assina · transmite · emite eventos
  3. 3SEFAZ · Prefeituras · Ambiente Nacionalautoriza e distribui
  4. 4Seu endpointwebhook · invoice.authorized

conte o que o seu sistema precisa emitir

03 — como funciona

Quatro passos. Nenhum deles no portal da prefeitura.

curl · sandbox
curl -X POST https://sandbox-api.spedy.com.br/v1/service-invoices \
  -H "X-Api-Key: $SPEDY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "cmp_8f3a",
    "customer":  { "federalTaxNumber": "12345678000190" },
    "services":  [{ "description": "Assinatura mensal", "amount": 297.00 }]
  }'

# 202 Accepted
{ "id": "inv_51c2", "status": "queued" }

04 — agentes de ia

Documentada para um assistente de IA integrar sozinho.

Cada página da documentação existe em Markdown, indexada num llms.txt, com a especificação OpenAPI ao lado. No vídeo, o Danilo, cofundador da Spedy, aponta um assistente para a URL e integra a API do zero.

  • docs.spedy.com.br/llms.txt
  • páginas .md para o agente ler
  • OpenAPI v1 para gerar o cliente
  • funciona com Cursor, Copilot, Claude e ChatGPT
Abrir o llms.txt

05 — operação

O que um time de engenharia cobra de uma API fiscal.

Não é a primeira nota que dá trabalho. É a milésima, num CNPJ diferente, numa cidade nova, com a SEFAZ fora do ar.

  • sandboxIdêntico à produção: mesmos endpoints, payloads e rejeições.
  • idempotênciatransactionId e integrationId. Retry nunca vira documento duplicado.
  • reprocessamentoPendentes e falhas reemitidas sob demanda; sync de recebidas forçada.
  • rejeiçõesCódigo, causa e ação em português, para SEFAZ e prefeituras.
  • rate limitLimites documentados, 429 previsível, checklist de produção.
  • webhooksAssinatura verificável, rotação de segredo com janela de até 72h.
  • multiempresaUm webhook para todas as empresas; certificado e série por CNPJ.
  • openapiSpec v1 para gerar clientes; llms.txt para agentes.
  • onboardingEspecialista fiscal da Spedy no WhatsApp durante a integração: código de serviço, CFOP, regime e credenciamento.

06 — reforma tributária

Reforma Tributária: CBS, IBS e IS já estão no schema.

A Reforma substitui PIS, COFINS, ICMS e ISS por um IVA dual, em fases. Os blocos novos das Notas Técnicas já existem na API. O seu sistema preenche conforme a fase vigente; a integração não muda. Nenhuma sprint para a próxima Nota Técnica.

hoje

PIS

federal

COFINS

federal

ICMS

estadual

ISS

municipal

com a Reforma

CBS taxes.ibsCbs.cbsRate

federal · no lugar de PIS e COFINS

IBS taxes.ibsCbs.ibsStateRate

estadual e municipal · no lugar de ICMS e ISS

IS taxes.is

federal · bens específicos

git diff · items[0].taxes
"taxes": {
"icms": { "cst": "00", "rate": 18 },
"pis": { "cst": "01", "rate": 1.65 },
"cofins": { "cst": "01", "rate": 7.6 },
+ "ibsCbs": { "cst": "000", "cbsRate": 0.9,
+ "ibsStateRate": 0.1 },
+ "is": { "cst": "000", "rate": 0 }
}

valores ilustrativos · o que é obrigatório depende da fase de transição vigente · guia da Reforma ↗

o time fiscal acompanha a transição com você

07 — quem faz e quem usa

Quem constrói a API.
E quem já integrou.

Fundada em 2021, a Spedy é citada como referência em automação fiscal pela imprensa especializada. Abaixo, o que os times dizem depois de integrar.

“Cara, que praticidade e rapidez para emitir as notas, e uma facilidade de integrar e configurar. Sério, muito bom mesmo, estão de parabéns pela plataforma. Trabalho há uns 15 anos no ramo de TI e nunca vi nada parecido.”
José Eduardo

José Eduardo

Gestor Auto App

“Assinei recentemente o serviço e fiquei impressionado com o level de suporte. Foi muito fácil integrar e começar a usar. Bem satisfeito até então.”
Giancarllo Rojas

Giancarllo Rojas

@coredacao

“A Spedy resolveu nosso problema de emitir nota fiscal em literalmente 5 minutos. Já somos usuários há mais de um ano, já indiquei para dezenas de empreendedores, e a Spedy me toma 0 minutos por mês hoje.”
Tiago Costa

Tiago Costa

@automarticles

“Atendimento até o momento nota 10. Quem fez o onboarding foi o Carlos, tirou todas as nossas dúvidas e ajudou desde os primeiros passos até a emissão da primeira nota fiscal para teste.”
Luís Juliani

Luís Juliani

@roboticon.ia

09 — perguntas frequentes

O que o time técnico pergunta antes.

As dez que mais aparecem nas conversas com engenharia.

  • Sim. Um único contrato para os três tipos de nota. A volumetria do seu plano é compartilhada entre NF-e, NFS-e e NFC-e. Você integra os módulos que precisar e paga por volume, não por tipo de nota.

  • Sim. O recurso de notas recebidas captura as NF-e na SEFAZ, faz a manifestação automática e entrega XML, DANFE e dados estruturados pelos endpoints de notas recebidas, além dos webhooks de recebimento. Tudo na mesma API da emissão, com a mesma chave e a mesma base de empresas: não existe contrato nem integração separada para receber, como é comum no mercado. Também não é preciso migrar a emissão para usar o recebimento.

  • Sim. A franquia mensal do seu plano é única e vale para emissão e recebimento, no mesmo contrato e sem taxa de setup adicional.

  • Depende do ponto de partida. Quem já tem os dados fiscais definidos (código de serviço, CFOP, regime, certificado) costuma ir ao ar em poucos dias; quem está começando do zero conta com o time fiscal da Spedy para definir esses parâmetros antes de emitir. A migração técnica em si é simples: sandbox (https://sandbox-api.spedy.com.br/v1) e produção (https://api.spedy.com.br/v1) usam a mesma interface, então é trocar a URL base e a chave.

  • Sim. Os blocos de CBS, IBS e IS já estão no schema, e os municípios migrados para o padrão nacional da NFS-e já estão cobertos. As atualizações são automáticas e sem impacto no seu código.

  • Sim. A Spedy API suporta multiempresas: múltiplos CNPJs gerenciados em uma única integração. Ideal para ERPs, marketplaces e plataformas que emitem em nome dos clientes.

  • Sim. A NFC-e é emitida via SEFAZ estadual, sem variação por prefeitura. A cobertura é nacional, na mesma integração das outras notas.

  • Não. Você escolhe o plano com a franquia de notas que faz sentido para o seu volume e paga só isso, todo mês. Sem taxa de setup, sem custo surpresa.

  • Time especializado disponível via WhatsApp, chat e e-mail para apoiar na integração e na operação. Além disso, a documentação em docs.spedy.com.br tem exemplos prontos para os cenários mais comuns.

  • Sim. A Spedy tem llms.txt e documentação estruturada para leitura por modelos de linguagem. O assistente escreve o cliente da API; as definições fiscais (código de serviço, regime, CFOP) continuam sendo suas, com o apoio do nosso time.

Pronto para tirar o fiscal do seu backlog?

sandbox gratuito · sem taxa de setup