Saltar para o conteúdo
Tejobit
Logótipo Fatture in Cloud

Faturação

Integração Fatture in Cloud

Documentos emitidos, clientes e pagamentos no Fatture in Cloud criados a partir das vendas, com o envio ao SDI feito pelo próprio software.

Pedir esta integração Ver todas as integrações

Visão geral

Fatture in Cloud

O Fatture in Cloud, do grupo TeamSystem, é dos programas de faturação mais usados por pequenas empresas e profissionais em Itália. Em Itália a fattura elettronica entre empresas e para consumidores passa obrigatoriamente pelo Sistema di Interscambio (SDI), e o Fatture in Cloud trata desse envio.

A Tejobit usa a API v2 do Fatture in Cloud, com autorização OAuth, para criar clientes e documentos emitidos a partir de reservas, encomendas ou pagamentos. A ligação preenche o codice fiscale ou a partita IVA, o código destinatário ou a PEC e as linhas com a aliquota IVA certa, para que a fatura siga para o SDI sem rejeições.

A API tem webhooks: o Fatture in Cloud avisa quando um documento é criado ou alterado. Isso permite, por exemplo, devolver à plataforma de origem o número da fatura sem estar sempre a perguntar, e poupar a quota de pedidos da conta.

Casos de uso

Para que serve

  • Empresa portuguesa de experiências enogastronómicas na Toscana que vende pelo FareHarbor e precisa de faturar cada reserva em Itália.
  • Loja Shopify com armazém em Milão em que as encomendas italianas geram fattura elettronica automaticamente.
  • Pagamentos Stripe marcados como pagos no documento, para o scadenzario refletir a realidade.
  • Notificação no Slack ou email quando uma fatura é alterada ou removida no Fatture in Cloud.
  • Sincronização de clientes empresariais entre um CRM e o Fatture in Cloud.
IN

O que a ligação escuta

  • Webhooks do Fatture in Cloud sobre criação, alteração ou eliminação de documentos emitidos e clientes.
  • Reserva paga ou encomenda concluída na plataforma de origem.
  • Pagamento confirmado no Stripe ou no PayPal.
  • Verificação agendada como rede de segurança caso um webhook falhe.
OUT

O que a ligação faz

  • Cria ou atualiza o cliente com partita IVA ou codice fiscale, código SDI ou PEC.
  • Cria o documento emitido (fattura, ricevuta, nota di credito) com linhas e IVA.
  • Regista o pagamento na prestação correspondente do documento.
  • Pede ao Fatture in Cloud o envio da fattura elettronica ao SDI, quando o plano o permite.
  • Devolve à origem o número e o estado do documento.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta Fatture in Cloud com um plano que inclua a API e, para envio ao SDI, a fatturazione elettronica.
  • Autorização OAuth da aplicação na empresa certa, se a conta gerir várias.
  • Tabela de correspondência entre produtos da origem e taxas de IVA italianas.
  • Decisão sobre que vendas vão para Itália e que tipo de documento emitem.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A API tem quotas de pedidos por hora e por mês, que variam com o plano; volumes muito altos podem exigir agrupamento.
  • Faturas recusadas pelo SDI voltam com erro e precisam de correção dos dados, que a ligação sinaliza mas não adivinha.
  • Os webhooks indicam que algo mudou; o detalhe é obtido com um pedido adicional à API.

Perguntas frequentes

Antes de começar

A fatura chega ao SDI sozinha?

Se o plano incluir fatturazione elettronica, a ligação cria o documento e pede o envio ao Fatture in Cloud, que o transmite ao SDI. O estado da entrega fica visível na conta.

Preciso de partita IVA italiana?

Para faturar em Itália com o Fatture in Cloud precisa de estar registado para IVA em Itália. O enquadramento fiscal deve ser confirmado com um commercialista.

A integração usa webhooks ou consultas?

Usa os webhooks do Fatture in Cloud sempre que existem para o recurso, e uma verificação periódica apenas como reforço.

Funciona com várias empresas na mesma conta?

Sim. A autorização OAuth indica a empresa, e é possível ter regras diferentes por empresa.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Fatture in Cloud?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com