1
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.2
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.
3
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.4
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.
5
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.6
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.