API FISCAL · TRANSPORTE

CT-e e MDF-e.Uma API. Sem instalação.

Emita, assine e transmita documentos de transporte em todos os modais. Sem componente: a API da SPWB resolve XML, SEFAZ e DACTE. O seu time fica com o produto.

Falar com especialista Ver como integrar

Sem componenteAPI REST via HTTPSA1 + A3Síncrono + assíncrono

SPWB API

Pronto

POSThttps://api.spwb.com.br/v1/cte

1curl -X POST https://api.spwb.com.br/v1/cte \2  -H "Authorization: Bearer $SPWB_TOKEN" \3  -H "Content-Type: application/json" \4  -d '{5    "referencia": "cte-2026-001",6    "modal": "rodoviario",7    "carga": { "valor": 12500.00, "peso": 820.5 },8    "documentos": ["3526...00012"],9    "tomador": "destinatario"10  }'

Respostaexemplo ilustrativo

{
  id: "cte_9f2a7c",
  status: 201,
  cStat: "100",
  xMotivo: "Autorizado o uso do CT-e",
  chave: "35261111222333000181570010000000011000000012",
  protocolo: "135260000000001",
  dacte: "https://api.spwb.com.br/v1/cte/cte_9f2a7c/dacte.pdf"
}

Clique para simular a emissão

POST · 100request e response reais de exemplo

API REST via HTTPS
Certificado A1 + A3
Síncrono + assíncrono
Todos os modais
Suporte dev para dev

MANIFESTO

“O seu software cuida da operação. A SPWB cuida do fiscal.”

Uma API REST para CT-e e MDF-e, com a regra fiscal, a assinatura e a transmissão do nosso lado. O seu time volta a construir produto.

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

Cada UF e cada modal vira uma exceção no código.

Uma integração REST cobre o fluxo. A regra fiscal e a SEFAZ ficam com a SPWB.

02hoje

O componente prende o produto em Windows e Delphi.

Qualquer stack com HTTP client integra. Inclusive SaaS multi-tenant.

03hoje

O schema mudou e o cliente parou de emitir.

Atualização fiscal aplicada no servidor. Nenhuma reinstalação no cliente.

DOCUMENTOS

Dois documentos, um fluxo.

O CT-e documenta o frete. O MDF-e acompanha a carga. A API cobre os dois no mesmo contrato, sem instalar nada no cliente.

Modelo 57

CT-e

Conhecimento de Transporte Eletrônico

Documenta a prestação do serviço de transporte de cargas, com as partes, a carga, o valor e o ICMS do transporte.

Emissão, consulta, cancelamento e carta de correção
DACTE pronto para impressão
Todos os modais de transporte
Chave de acesso de 44 dígitos

Modelo 58

MDF-e

Manifesto de Documentos Fiscais Eletrônicos

Vincula a carga e os documentos fiscais ao veículo e à viagem. Acompanha o CT-e e as NF-e transportadas.

Emissão e encerramento
Vínculo com CT-e e NF-e da carga
DACTE do MDF-e
Integração com a operação logística

Emita o CT-e, vincule a carga e encerre o MDF-e no mesmo contrato de API.

01JSON

02XML

03Assinatura

04SEFAZ

05Autorizado

06DACTE

JSON

XML

Assinatura

SEFAZ

Autorizado

DACTE

Fluxo do documento

COMO FUNCIONA

Do JSON ao DACTE em quatro passos.

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

Credenciais

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

JSON

Envia a prestação, as partes, a carga e os documentos que acompanham o transporte.

Assinatura e SEFAZ

A API monta o XML, assina com o certificado A1 ou A3 e transmite à SEFAZ.

XML + DACTE

Recebe o documento autorizado, a chave, o protocolo e o DACTE para imprimir.

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.

Síncrono e assíncrono

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

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.

Todos os modais

Rodoviário, aéreo, aquaviário, ferroviário, dutoviário e multimodal.

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 e DACTE.
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/cte
Authorization: Bearer $SPWB_TOKEN
Content-Type: application/json

response201 created

{
  status: 201,
  cStat: "100",
  chave: "35261111222333000181570010000000011000000012"
}

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.

Critério

Componente

API SPWB

Instalação no cliente

Uma DLL por máquina

Nenhuma instalação

Atualização fiscal

Reinstalar versão

Automática no servidor

Stack

Delphi, C#, VB6

Qualquer linguagem com HTTPS

Multi-CNPJ e multi-tenant

Complexo

Nativo

Certificado

Preso à máquina

A1 e A3 com gestão central

Escala

Uma instância por cliente

Uma API para toda a base

Observabilidade

Log local

Resposta estruturada + status

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.

COBERTURA

Todos os modais. Um só contrato.

O CT-e cobre o transporte de cargas em qualquer modal. O MDF-e acompanha a carga.

COBERTURA

Rodoviário

O modal do dia a dia: cargas, fretes e redespacho.

JSONSEFAZXML + DACTE

A disponibilidade por modal segue as regras da SEFAZ e o cadastro do emitente. O time técnico confirma o seu cenário na 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 a SEFAZ.
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 · TMS

Recebi cStat 539 no CT-e. O que confere?

SPWB · engenharia

539 é rejeição de duplicidade. Valida a chave e o lote com a gente antes de reenviar.

exemplo ilustrativo de atendimento

Produto chefe · SPWB

Roteirizador de Carga

Receba CT-e do TMS, considere veículos e restrições e devolva a melhor sequência de entregas.

Conhecer o Roteirizador

TAMBÉM PRECISA DE NOTA FISCAL?

NF-e e NFS-e na mesma infraestrutura.

Se o seu produto também emite nota de mercadoria ou de serviço, a SPWB cobre os quatro documentos.

Conhecer NF-e + NFS-e

FAQ

Perguntas que o seu time vai fazer.

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

O que é o CT-e e para que serve?

O CT-e é o Conhecimento de Transporte Eletrônico. Ele documenta a prestação do serviço de transporte de cargas e é obrigatório para transportadoras e para quem presta serviço de frete vinculado a uma operação fiscal.

Preciso emitir MDF-e junto com o CT-e?

Depende da operação. O MDF-e acompanha a carga e os documentos fiscais na viagem. Em boa parte das operações de transporte ele é exigido. A API cobre os dois documentos, e o time ajuda a definir o fluxo do seu cenário.

A API cobre quais modais?

Rodoviário, aéreo, aquaviário, ferroviário, dutoviário e multimodal. A disponibilidade segue as regras da SEFAZ e o cadastro do emitente. Confirme o seu cenário com o time técnico.

Como funciona o certificado A3 na API?

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, sem prometer um atalho que não existe.

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 DACTE antes de ir para produção.

Como funcionam cancelamento e carta de correção?

A API expõe as operações de consulta, cancelamento e carta de correção do CT-e, com os prazos e impedimentos da regra fiscal. O retorno traz o protocolo do evento.

Consigo migrar de um componente para a API?

Sim. A migração é feita por fluxo: você mantém a regra de negócio e troca a camada de mensageria pelo HTTP. O time acompanha a homologação e a virada para produção.

A API atende multi-CNPJ?

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 e SaaS multi-tenant.

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.

Conversa técnica

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

Homologação

Você recebe acesso e testa o fluxo completo.

Produção

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

comercial@spwb.com.br