O que torna 10 dias úteis possível
Três fatores são determinantes.
Catálogo organizado
NCM atualizado contra TIPI vigente (gov.br/receitafederal), CFOP por tipo de operação definido, CST por SKU configurado, regime fiscal vinculado. Catálogo limpo é o pré-requisito que mais economiza tempo.
Plataforma compatível
VTEX (com Tax Service configurável), Shopify (via app), Magento, ou e-commerce custom com API. Plataformas com integração de Tax Service bem desenhada permitem setup mais rápido.
Política comercial documentada
Tabelas de preço por canal e regime, política de prazo, política de crédito, regras de exceção. Política escrita acelera configuração do motor.
Sem esses três, o cronograma se ajusta. Com eles, o setup em 10 dias úteis é viável em uma parcela relevante das implementações.
Dia 1: kick-off técnico e comercial
O ponto de partida formal.
Pauta do kick-off
Apresentação dos times (cliente, Mastery, eventualmente parceiro implementador), validação de escopo, alinhamento de cronograma, definição de stakeholders.
Documentação compartilhada
Workspace com brief técnico, lista de SKUs amostrais, lista de UFs atendidas, configuração da plataforma, credenciais sandbox.
Saídas do dia 1
Cronograma assinado, lista de pré-requisitos, lista de cenários a validar, plano de comunicação durante o setup.
Dias 2 a 3: revisão de catálogo
Catálogo é o trabalho mais sensível.
Inventário de SKUs
Listar SKUs ativos com NCM, CFOP, CST. Identificar lacunas. Priorizar por volume de vendas.
Validação contra TIPI vigente
Conferir NCM contra TIPI da Receita Federal. Marcar divergências para correção. Em catálogos grandes, focar nos top 20% de SKUs por faturamento.
Configuração da política fiscal
Por linha de produto: NCM, CFOP padrão, CST padrão, regime aplicável, benefício fiscal quando relevante. Documentar exceções.
Validação fiscal interna
Fiscal interno do cliente confere as decisões. Marca aprovações e ajustes.
Dia 4: configuração do Tax Service na plataforma
A camada técnica de integração.
Configurar Tax Service
No admin VTEX (ou equivalente em Shopify, Magento, custom): cadastrar URL Mastery, credenciais sandbox, timeout, política de fallback.
Teste de conectividade
Chamada de teste ao motor. Conferir resposta básica. Validar autenticação. Marcar conformidade técnica.
Configuração de política comercial
Tabelas de preço por regime, política de aprovação, configuração de Análise de Crédito B2B com base em score de CNPJ de bureau de crédito.
Dia 5: testes em sandbox, cenários core
Validação técnica funcional.
Cenários mínimos
Pedido PJ revenda mesma UF. Pedido PJ revenda interestadual com ICMS-ST. Pedido PJ uso próprio interestadual com DIFAL. Pedido com IPI por sub-NCM. Pedido PJ Simples Nacional.
Validação por cenário
Payload enviado, resposta do motor, conferência contra expectativa. Documento com checklist de aceite.
Ajustes de configuração
Se algum cenário falha, ajuste na configuração e nova rodada. Mastery atua junto.
Dia 6: testes em sandbox, cenários avançados
Cenários menos frequentes, igualmente importantes.
Cenários avançados
Pedido com benefício estadual aplicável. Pedido com produto sujeito a IS (em operações afetadas). Pedido com regime especial. Pedido com CNAE secundário relevante. Pedido com habilitação setorial (farma, química).
Validação fiscal
Fiscal interno do cliente confere cada cenário com base na regulamentação aplicável (LC 214 de 2025 em planalto.gov.br/ccivil_03/leis/lcp/lcp214.htm, Convênio ICMS 142 de 2018 em confaz.fazenda.gov.br).
Pesquisa de performance
Carga simulada, medição de latência em p50 e p95, conferência de timeout e fallback.
Dia 7: validação ponta a ponta com NF
Cálculo fiscal correto precisa virar nota correta.
Emissão em ambiente de homologação
Pedido aprovado em sandbox dispara emissão de NF-e em ambiente de homologação (não produção real). Nota gerada com CFOP, CST, alíquotas, base, destaques conforme cálculo Mastery.
Validação da nota
Fiscal interno e equipe técnica conferem nota contra expectativa. Marca conformidade. Em caso de divergência, ajuste no motor ou no ERP.
Documentação do fluxo
Diagrama do fluxo, registros de cada etapa, checklist de aceite ponta a ponta.
Dia 8: política de operação e fallback
Operação contínua exige preparação.
Plano de operação
Quem monitora cálculos no dia a dia, quem trata exceção, quem escala incidente. Procedimento documentado.
Plano de fallback
Em caso de motor indisponível, ação imediata. Possíveis estratégias: retentativa automática, cache de regra para SKUs frequentes, fila de aprovação manual. Configurar conforme apetite de risco.
Treinamento do time interno
Fiscal interno, time comercial, atendimento, TI: conhecimento do que o motor faz e do que não faz. Procedimento de escalonamento.
Dia 9: go live em produção
Migração com cuidado.
Janela de go live
Horário de baixo tráfego. Time de plantão. Cliente e Mastery em sala virtual durante a migração.
Atualizar credenciais para produção
Trocar URL e credenciais para ambiente de produção. Confirmar conectividade. Disparar smoke test (cenário mínimo) para validar conformidade.
Monitoramento intensivo nas primeiras horas
Dashboards de cálculo, alertas de divergência, comparação contra expectativa. Capacidade de rollback testada.
Comunicação interna
Time fiscal, comercial e atendimento avisados. Procedimento de escalonamento conhecido.
Dia 10: estabilização e retrospectiva
Primeiro dia de operação completa.
Acompanhamento dia inteiro
Monitorar volume de cálculos, latência real em produção, eventuais exceções. Ajustes finos conforme observação.
Retrospectiva técnica
Time Mastery e time cliente revisam o que funcionou, o que pode evoluir, o que precisa de ajuste pós go live. Documentar para os próximos clientes.
Plano de evolução
Próximos canais, próximas UFs, próximas verticais, próximas integrações. Como o motor acompanha a evolução da operação.
Encerramento formal do setup
Aceite do cliente, fechamento de checklist, transição para operação contínua com CSM Mastery responsável.
Quando o cronograma de 10 dias úteis não cabe
Nem toda operação cabe em 10 dias úteis. Quatro fatores costumam alongar.
Catálogo grande e desorganizado
Operação com 50 mil SKUs sem NCM atualizado, CFOP ausente em parte do mix, CST incorreto: investimento prévio em limpeza pode levar semanas a meses. O setup propriamente dito segue rápido depois.
Plataforma com integração customizada profunda
E-commerce com integração ERP profundamente customizada (campos próprios, regras de negócio embarcadas) pode demandar análise técnica mais longa.
Múltiplas UFs com regras diversas
Operações em todas as UFs com regras estaduais variadas exigem mapeamento mais detalhado. O motor cobre, mas a configuração inicial leva mais tempo.
Política comercial não documentada
Política em planilha, em memória de vendedor, em emails. Antes de configurar o motor, precisa virar regra escrita.
A Mastery atua em todos esses cenários. O cronograma se ajusta sem alterar a qualidade do setup.
Caso ilustrativo: indústria que entrou em produção em janela curta
Considere indústria B2B com catálogo de 800 SKUs principais (top 20% do faturamento), operação em 8 UFs, plataforma VTEX, ERP TOTVS, política comercial documentada.
Pré-condições antes do kick-off
Catálogo revisado pelo cliente, política comercial escrita, equipe técnica disponível, fiscal interno alocado.
O setup
Kick-off no dia 1. Catálogo dia 2 a 3. Tax Service e configuração dia 4. Sandbox cenários core dia 5. Sandbox avançado dia 6. Validação NF dia 7. Plano de operação dia 8. Go live dia 9. Estabilização dia 10.
O resultado
Operação em produção ao final dos 10 dias úteis. Time fiscal atuando em exceções e contestações desde o primeiro dia. Pedidos B2B com cálculo correto desde o início. O caso é ilustrativo da timeline padrão observada em parte das implementações Mastery.
Perguntas frequentes
Setup em 10 dias úteis funciona para qualquer operação?
Para operações com catálogo organizado (NCM atualizado, CFOP definido, CST por SKU), plataforma compatível (VTEX, Shopify, Magento, custom com API) e política comercial documentada. Operações com catálogo desorganizado ou customização pesada podem precisar de cronograma mais longo.
O que precisa estar pronto antes do kick-off?
Catálogo com NCM contra TIPI vigente, CFOP por operação, CST por SKU. Plataforma configurada (admin acessível, Tax Service habilitado). Política comercial documentada (tabelas de preço, prazo, crédito). Stakeholders alocados (fiscal, técnico, comercial).
Quem participa do kick-off?
Pelo cliente: CTO ou líder técnico, fiscal interno, gerente de e-commerce, eventualmente parceiro implementador. Pela Mastery: CSM, suporte técnico, engenheiro de integração.
O motor Mastery está pronto para a Reforma Tributária no go live?
Sim. O motor calcula IBS, CBS e IS conforme regulamentação publicada (LC 214 de 2025), suporta coexistência ICMS+IBS e PIS/Cofins+CBS na transição 2027 a 2033, e está preparado para Split Payment conforme cronograma de implementação dos gateways.
O que acontece após o go live?
Operação contínua com CSM Mastery responsável, monitoramento, atualização de regra conforme regulamentação publicada, suporte técnico, evolução de escopo conforme necessidade do cliente.
Este conteúdo tem caráter informativo e não substitui orientação contábil, fiscal ou jurídica especializada. Regras tributárias podem variar conforme UF, regime tributário, operação, produto, NCM, CNAE e perfil do comprador. Valide seu cenário com profissional habilitado.
Próximo passo: Solicitar kick-off técnico Mastery
Leituras relacionadas: - VTEX integração fiscal: passo a passo da implementação Mastery - API fiscal B2B: o que sua plataforma deve esperar do motor de cálculo - Motor fiscal complementar ERP: como funciona em paralelo sem substituir - Tecnologia Mastery