1
Empresas emissoras criadas e configuradas em produção
A conta de produção é separada da de sandbox — nada é transportado.
Crie a(s) empresa(s) emissora(s) na produção e repita a configuração:
envie o certificado A1, defina
environmentType: production em cada modelo,
a série e a numeração, e os dados fiscais (regime tributário, CSC para NFC-e,
responsável técnico da NF-e/NFC-e, provedor/issueType da NFS-e). Veja
Configuração inicial.2
Certificado digital A1 válido
Confirme que o certificado A1 (
.pfx) cadastrado na empresa está dentro
da validade e é o certificado correto para o CNPJ emissor. Consulte os
certificados cadastrados via GET /v1/companies/{id}/certificates e
confira o campo expirationAt. Veja Certificado
digital.3
Credenciamento junto à SEFAZ (e prefeitura, para NFS-e)
A empresa precisa estar credenciada como emissora de NF-e/NFC-e junto à
SEFAZ do seu estado e, para NFS-e, junto à prefeitura do município. Sem o
credenciamento, notas emitidas em produção são rejeitadas independente da
integração estar correta. Alguns estados (SC, PR, ES, PA) têm etapas
adicionais que envolvem a software house do sistema de venda — veja
Credenciamento por estado.
4
CSC configurado, para quem emite NFC-e
Se você emite NFC-e, confirme que o CSC (Código de Segurança do
Contribuinte) da empresa está configurado corretamente nas configurações
fiscais (
PUT /v1/companies/{id}/settings). O CSC é obrigatório para
gerar o QR Code de consulta da NFC-e.5
Fluxo completo testado em sandbox
Valide o fluxo de ponta a ponta em ambiente de
testes: criação de venda, emissão,
cancelamento, correção (quando aplicável) e recebimento de webhooks. Não
valide só o caminho feliz — teste também rejeições e cancelamentos.
6
Base URL e chave trocadas para produção
Troque a base URL de
https://sandbox-api.spedy.com.br/v1 para
https://api.spedy.com.br/v1 e a X-Api-Key para a chave da empresa
de produção. As chaves não são intercambiáveis entre ambientes — veja
Autenticação.7
Monitoramento via webhook ativo
Configure e teste webhooks de status de nota antes do go-live, para que
sua equipe saiba imediatamente se uma nota for rejeitada em produção, em
vez de descobrir por reclamação de cliente. Veja Webhooks: visão
geral.
8
Emissão de validação em produção (piloto)
Assim que estiver em produção, emita pelo menos uma nota real de cada
modelo que você usa — em especial NFS-e — antes de liberar o volume.Por quê: no sandbox em Simulação, a Spedy exercita o fluxo de
emissão, mas não há validação tributária real. Só na emissão de produção
(ou em homologação real, quando o município oferece) a nota passa pelas
regras fiscais do município — código do serviço, alíquotas, retenções e
particularidades da prefeitura — e pode ser rejeitada.
Acompanhe o status por webhook, corrija o que for apontado e só então libere
o fluxo completo.