> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Checklist de produção

> Checklist para ir para produção com a API da Spedy.

Antes de emitir documentos fiscais reais, confirme cada item abaixo. Emissões
em produção têm validade fiscal — um detalhe pulado aqui pode significar nota
rejeitada, autuação ou retrabalho.

<Steps>
  <Step title="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](/guides/configuracao-inicial).
  </Step>

  <Step title="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](/guides/certificado-digital).
  </Step>

  <Step title="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](/guides/credenciamento-estadual).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Fluxo completo testado em sandbox">
    Valide o fluxo de ponta a ponta em [ambiente de
    testes](/start/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.
  </Step>

  <Step title="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](/start/autenticacao).
  </Step>

  <Step title="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](/webhooks/visao-geral).
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  Notas emitidas em produção têm validade fiscal e podem gerar obrigações
  reais (impostos, guarda de arquivos, retificações). Não use a base URL de
  produção para testes.
</Warning>