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).
| Documento | Pode ser impresso |
|---|---|
| Faturas | Quando a fatura é finalizada, enviada ou paga |
| Notas de crédito | Quando a nota de crédito é criada |
| Orçamentos | Quando 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
- 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.
- No Dashboard do Stripe, instale a app Sealed Print a partir do Stripe App Marketplace e abra as definições.
- Cole o URL em URL do endpoint de API.
- 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.
- 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
holdmanté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
- Endpoints de API: o endpoint por trás da app, também para os seus próprios programas.
- A fila e as rotas
- Fluxos de trabalho