Guia do usuário
Tudo o que você precisa para usar o app, passo a passo.
Sumário
- Instalar o app
- Preencher os dados da empresa
- Personalizar e conferir a fatura
- Escolher quando e como as faturas são enviadas
- Adicionar o link da fatura na confirmação do pedido da Shopify (opcional)
- Acompanhar as faturas no dia a dia
- Numeração e idiomas
- Factur-X: a fatura eletrônica
- Gerenciar seu plano
- Boas práticas
1Instalar o app
A instalação leva um minuto e não altera sua loja nem seus pedidos.
- Na Shopify App Store, abra a página do app e clique em "Instalar".
- Aceite o acesso aos seus pedidos: o app os lê para criar as faturas e só grava neles uma informação, o link da fatura. Não altera mais nada.
- O app abre no seu admin da Shopify, em Apps › Hoshi Factures. Nome, endereço e e-mail da loja já vêm preenchidos.
- Na aba Início, siga a lista "Primeiros passos": ela some quando as três etapas forem concluídas.
2Preencher os dados da empresa
Estes dados aparecem em todas as faturas. São obrigatórios para uma fatura válida.
- Abra a aba Configurações, cartão "Sua empresa".
- O mais rápido (empresas francesas): em "Preenchimento automático", digite seu SIRET (ou o nome da empresa e a cidade), clique em "Buscar" e depois em "Usar". Razão social, endereço da sede, SIRET, forma jurídica e número de IVA vêm do registro oficial. Você também pode clicar em "Usar os dados da Shopify".
- Confira a razão social e o e-mail: seus clientes respondem para esse endereço e é lá que você recebe as cópias das faturas.
- Digite o endereço em várias linhas, com o CEP e a cidade na mesma linha (ex.: "01310-100 São Paulo"), e escolha o país.
- Informe o número de registro (SIRET na França) e o número de IVA.
- Isento de IVA: marque a opção de isenção. O IVA some das faturas e a menção legal é adicionada.
- Abra "Mais dados da empresa" para forma jurídica e capital, registro comercial, telefone, site e tipo de venda (bens, serviços ou ambos).
- Clique em "Salvar" na barra que aparece na parte de baixo da tela.
3Personalizar e conferir a fatura
Dê às faturas a cara da sua marca e confira o resultado antes do primeiro pedido.
- Na Shopify, abra Conteúdo › Arquivos, envie seu logotipo (PNG ou JPEG) e copie o link.
- Em Configurações › Aparência, cole o link em "URL do logotipo" e escolha a cor principal.
- Se precisar, altere as menções do rodapé e a mensagem de agradecimento. Se ficarem vazias, são traduzidas automaticamente no idioma do cliente.
- Clique em "Prévia do PDF": uma fatura de exemplo é baixada com suas configurações, mesmo as não salvas.
- Salve quando estiver satisfeito com o resultado.
4Escolher quando e como as faturas são enviadas
Por padrão, a fatura é criada quando o pedido é pago e enviada ao cliente por e-mail na hora.
- Em Configurações › Funcionamento, escolha quando criar a fatura: quando o pedido for pago (recomendado) ou assim que for feito.
- Em “Como seus clientes recebem a fatura”, escolha: um e-mail com o PDF anexado (recomendado, nada a configurar); um só e-mail com um botão “Baixar fatura” na página do pedido (sem código: 3 cliques para ativar); ou um só e-mail com o link direto na confirmação da Shopify (colar um código uma vez). As configurações guiam você passo a passo.
- Marque "Enviar-me uma cópia de cada fatura" para receber cada fatura e montar seu arquivo.
- Para personalizar o e-mail, abra "E-mail ao cliente": assunto e mensagem aceitam as variáveis {{first_name}}, {{name}}, {{invoice_number}}, {{order}} e {{shop}}.
5Adicionar o link da fatura na confirmação do pedido da Shopify (opcional)
Seus clientes também encontram a fatura no e-mail de confirmação habitual da loja.
- Em Configurações, abra "Link no e-mail de confirmação da Shopify" e clique em "Copiar o código".
- Na Shopify, vá em Configurações › Notificações › Notificações ao cliente › Confirmação do pedido e depois em "Editar código".
- Cole o código onde o botão deve aparecer, por exemplo logo depois do resumo do pedido.
- Clique em "Visualizar" para conferir e depois em "Salvar".
6Acompanhar as faturas no dia a dia
A aba Início mostra as últimas faturas emitidas com o status de envio.
- Cada linha mostra número, pedido, cliente, data, total e status do e-mail.
- "Enviada": o cliente recebeu a fatura. "Não enviada": o envio automático está desativado. "Falha": passe o mouse sobre o status para ver o motivo.
- Clique em "PDF" para baixar uma fatura, ou em "Reenviar" para enviá-la de novo ao cliente.
- O selo Factur-X indica que a fatura também contém os dados para a fatura eletrônica.
7Numeração e idiomas
Os números são sequenciais e sem falhas, como a lei exige, e cada cliente recebe a fatura no seu idioma.
- Em Configurações › Numeração e idioma, escolha o prefixo dos números (padrão "F-", ou seja F-2026-00001).
- Se você já emitia faturas com outra ferramenta, informe o próximo número: ele pode aumentar, mas nunca diminuir.
- Escolha o idioma das faturas: o do cliente (francês, inglês, alemão, espanhol, italiano, holandês, português (Brasil), tcheco, dinamarquês, finlandês, bokmål norueguês, polonês, português (Portugal), sueco, turco e malaio) ou um idioma único.
- Com "Idioma do cliente", escolha também o idioma alternativo usado quando o do cliente não estiver disponível.
8Factur-X: a fatura eletrônica
Com o Factur-X, o PDF também contém os dados da fatura, legíveis por softwares de contabilidade e pelas plataformas de fatura eletrônica, obrigatória entre empresas na França a partir de 2026–2027.
- Abra Configurações › Factur-X: a opção vem ativada por padrão.
- Se aparecer "Factur-X pausado", preencha a informação indicada (geralmente o endereço, o país ou o número de IVA) e salve.
- Quando o indicador ficar ✓, todas as faturas seguintes serão Factur-X, sem nenhuma mudança para seus clientes.
9Gerenciar seu plano
Plano Grátis: 10 faturas por mês. Essencial: 200 faturas por US$ 7,90 por mês. Ilimitado: US$ 12,90 por mês. Teste grátis de 7 dias nos planos pagos.
- A aba Plano (e o Início) mostra quantas faturas você usou este mês. O contador recomeça no dia 1º de cada mês.
- Para mudar de plano, clique em "Escolher" e aprove na página da Shopify: o valor é incluído na sua fatura da Shopify.
- Se o limite for atingido, os novos pedidos ficam em espera e você é avisado por e-mail. Depois de mudar de plano, clique em "Gerar as faturas" no Início.
- Para voltar ao plano Grátis, clique em "Cancelar".
10Boas práticas
Alguns hábitos para cuidar da contabilidade com tranquilidade.
- Faça um pedido de teste depois da configuração (com o modo de teste do Shopify Payments) e confira a fatura recebida.
- Guarde suas faturas por 10 anos: mantenha a cópia recebida por e-mail ou baixe-as todo mês. Elas são apagadas do app 48 horas após a desinstalação.
- Uma fatura emitida não pode ser alterada: em caso de erro ou reembolso, emita uma nota de crédito no seu sistema contábil.
- Alguma dúvida? Consulte as perguntas frequentes na aba Ajuda.