Todos os guias

Equipa e administração

Imprimir documentos do Stripe

Imprima automaticamente faturas, notas de crédito, orçamentos e recibos do Stripe com a app Sealed Print para Stripe.

A app Sealed Print para Stripe imprime os documentos que o Stripe cria na sua conta: faturas, notas de crédito, orçamentos e recibos de pagamento. Decide para cada tipo de documento se é impresso, quando e para onde vai. A app envia cada documento para um endpoint de API da sua organização; assim, cada um torna-se um trabalho em nome do proprietário do endpoint, como qualquer outro documento.

Pré-requisitos

  • Uma conta Stripe na qual possa instalar apps (função Stripe Administrador).
  • Um admin ativa o canal de entrada REST API em Definições → Canais de entrada.
  • Um endpoint de API cujo destino deva receber os documentos.
  • Vários identificadores por tipo de documento, ou um grupo de destinos, requerem o plano Team (consulte Imprimir em vários destinos ao mesmo tempo).
DocumentoPode ser impresso
FaturasQuando a fatura é finalizada, enviada ou paga
Notas de créditoQuando a nota de crédito é criada
OrçamentosQuando o orçamento é finalizado ou aceite
Recibos (experimental)Quando o pagamento é concluído ou reembolsado

O Stripe oferece os recibos apenas como página web. O Sealed Print imprime a versão em PDF, que o Stripe não documenta; se o Stripe a alterar, os recibos deixam de ser impressos até adaptarmos a app. As faturas do Stripe pelas suas próprias taxas só estão disponíveis no Dashboard do Stripe; a app não as consegue imprimir.

Configuração inicial

  1. No Sealed Print, vá a Origens → Endpoints de API e selecione Novo endpoint de API. Escolha a Rota dos documentos e copie o URL do endpoint.
  2. No Dashboard do Stripe, instale a app Sealed Print a partir do Stripe App Marketplace e abra as definições.
  3. Cole o URL em URL do endpoint de API.
  4. Em Documentos, ative Imprimir automaticamente para cada tipo de documento que quer em papel. Escolha Quando é impresso, o número de Cópias e, se não deve ir para o destino do endpoint, os Identificadores de destinos, grupos ou de um fluxo de trabalho, separados por vírgulas.
  5. Selecione Guardar e depois Verificar a ligação. Quando aparecer “Está tudo pronto”, os documentos novos são impressos. O campo URL do endpoint de API continua a mostrar o URL ligado, para que possa ver mais tarde que endpoint está configurado.

O modo real e o modo de teste do Stripe têm definições separadas, por isso pode experimentar tudo primeiro com dados de teste.

No dia a dia

  • Os documentos novos são impressos sozinhos. Aparecem na fila como trabalhos com o nome do documento, por exemplo “Invoice INV-0042 – Exemplo Lda.”, com o canal de entrada REST API.
  • Cada documento é impresso uma vez por evento, mesmo que o Stripe volte a enviar o evento.
  • Para imprimir uma fatura manualmente, abra-a no Dashboard do Stripe e selecione Imprimir com o Sealed Print no painel do Sealed Print. São usados os identificadores e as cópias da regra das faturas, mesmo que a impressão automática esteja desativada.
  • Com um fluxo de trabalho como primeiro identificador, os documentos passam por ele, por exemplo para serem assinados primeiro (consulte Fluxos de trabalho). O identificador hold mantém-nos no Sealed Print até alguém os enviar.
  • Para enviar faturas como faturas eletrónicas (ZUGFeRD ou XRechnung) aos seus clientes, introduza para as faturas o identificador de um fluxo de trabalho com os passos Converter em fatura eletrónica e Enviar por e-mail. O passo de e-mail envia para o endereço de e-mail do comprador lido da fatura (consulte o exemplo em Fluxos de trabalho).

Resolução de problemas

  • Verificar a ligação mostra o que impede a impressão, com as mesmas mensagens que a app usa abaixo.
  • “O URL do endpoint de API foi renovado”: alguém selecionou Gerar novo URL. Cole o URL novo.
  • “O endpoint de API já não existe”: crie um endpoint novo e cole o seu URL.
  • “Não existe nenhum destino, grupo ou fluxo de trabalho com o identificador …”: verifique a grafia do identificador no destino e se o proprietário do endpoint pode imprimir para ele (o destino de outro utilizador tem de estar partilhado).
  • “O canal de entrada REST API está desativado”: um admin ativa-o em Definições → Canais de entrada.
  • Uma fatura não é impressa: os rascunhos não têm PDF. O Stripe cria-o quando a fatura é finalizada.
  • Um recibo não é impresso: o Stripe não disponibilizou o recibo em PDF (experimental, ver acima).

Próximos passos