HSM / Singularity

HSM e Singularity são duas marcas de educação executiva, com cursos e eventos, vendidas a partir de um admin Shopify. Construí a vitrine headless sozinho, em Hydrogen sobre React Router 7: um código só, publicado como duas vitrines no Oxygen, com as seções, os formulários e um app próprio para impostos.

Quando uma empresa compra no Brasil, parte dos tributos federais é retida na fonte: ela paga o pedido menos a retenção e recolhe o resto direto com a Receita. O Shopify não tem esse conceito. As configurações de imposto dele só somam imposto, não subtraem, e não mudam conforme quem está comprando. E o valor que o checkout mostra precisa bater com a nota no centavo.

• Retenção como desconto, numa Shopify FunctionA regra roda numa Function de desconto e devolve um valor fixo no pedido, com o nome “Retenção na fonte”. Ela considera faixas de valor, a isenção parcial de quem é optante do Simples Nacional e três formas de reconhecer uma compra de empresa: o CNPJ, uma tag de cliente ou uma empresa B2B.
• CNPJ validado no campo nativoUma Function de validação confere os dígitos verificadores e trava o checkout antes do pagamento quando o número está malformado.
• Uma extensão de checkout que mantém a Function em diaA Function não enxerga o campo nativo de documento ao vivo. A extensão copia o CNPJ para um metafield do carrinho, cada escrita roda a regra de novo, e a própria extensão mostra o detalhamento por tributo.
• Alíquotas como dadoFaixas e alíquotas ficam num JSON em metafield que a Function, a extensão e um formulário no admin leem. Mudar uma alíquota é editar o admin, sem deploy.
• Formulários feitos de metaobjects, entregues no SalesforceCampos e etapas são metaobjects, e cada produto escolhe o seu formulário. O servidor refaz a validação a partir da definição do admin e cria o lead no Salesforce por OAuth. Se o CRM recusa um valor, ele vai para a descrição e o envio é repetido, então um erro de digitação no admin não perde lead.
• Duas marcas, um buildA marca é resolvida em tempo de execução pelo ambiente, o tema é isolado por atributo no HTML, e os e-mails transacionais das duas marcas saem do mesmo conjunto de templates.

• Desconto, porque imposto no Shopify só sobeModelar a retenção como desconto de pedido com valor fixo é o jeito de o total do checkout mostrar o que a empresa realmente paga.
• Centavos inteiros nas duas pontasA Function e a extensão calculam separadas. Com ponto flutuante, em alguns totais elas discordariam em um centavo na frente do cliente. As duas usam a mesma conta em inteiros, com arredondamento half-up.
• A definição do formulário vale no servidorA validação é refeita a partir do admin, então o cliente não pula campo obrigatório, e quem edita o formulário não depende de deploy.
• Falhar com calma no CRMCRM recusa valor de lista o tempo todo. Um lead perdido custa mais que uma descrição bagunçada.

Em desenvolvimento, antes do lançamento nos domínios finais. As vitrines rodam em deploys de preview e o app de imposto já está instalado na loja.