Integração em minutos

Como funciona a Atura?

Quatro passos simples para começares a gerar faturas certificadas pela AT na tua aplicação.

Instala o SDK

Adiciona a Atura ao teu projeto em segundos

Configura a API

Autentica e configura com a tua chave API

Cria Faturas

Gera documentos certificados pela AT automaticamente

Vai Live

Deploy para produção e começa a faturar

Implementação passo a passo

Exemplos reais de como integrar a Atura na tua aplicação

Passo 1

Instala o SDK

Escolhe a tua linguagem favorita e instala em segundos

shell

npm install @atura/node

# ou alternativas
gem install atura          # Ruby
pip install atura          # Python
composer require atura/sdk # PHP

Passo 2

Configura a autenticação

Inicializa o cliente com a tua chave API

atura.ts

import { Atura } from '@atura/node';

const atura = new Atura({
  apiKey: process.env.ATURA_API_KEY,
  environment: 'production' // ou 'sandbox'
});

Passo 3

Cria a tua primeira fatura

Documento certificado pela AT em uma chamada simples

create.ts

const invoice = await atura.invoices.create({
  client: {
    vatNumber: "123456789",
    name: "Cliente Exemplo Lda",
    email: "cliente@exemplo.com"
  },
  items: [{
    description: "Desenvolvimento de Software",
    quantity: 1,
    price: 1500.00,
    vatRate: 23
  }],
  dueDate: "2025-02-15"
});

// ✅ Fatura certificada pela AT criada!
console.log(`Fatura #${invoice.number} criada`);
console.log(`PDF: ${invoice.pdfUrl}`);

Passo 4

Recebe notificações automáticas

Configura webhooks para updates em tempo real

webhooks.ts

// Configura webhook
await atura.webhooks.create({
  url: "https://tua-app.com/webhooks/atura",
  events: ["invoice.created", "invoice.paid"]
});

// Handler no teu servidor
app.post('/webhooks/atura', (req, res) => {
  const { event, data } = req.body;

  switch (event) {
    case 'invoice.paid':
      console.log(`💰 Fatura ${data.number} foi paga!`);
      // Atualizar base de dados, enviar email, etc.
      break;
    case 'invoice.overdue':
      console.log(`⚠️ Fatura ${data.number} em atraso`);
      break;
  }

  res.status(200).send('OK');
});

100% Conforme

Certificação AT automática

Todos os requisitos legais portugueses automaticamente cumpridos

SAF-T PT

Exportação automática em formato SAF-T PT para a AT

Comunicação Série

Comunicação automática de séries documentais

Arquivo Digital

Arquivo digital seguro por 10 anos

Assinatura Digital

Assinatura digital qualificada em todos os documentos

Preparado para produção

99.9%

Uptime Garantido

5min

Tempo de Integração

100%

Certificado pela AT

24/7

Monitorização

SDKs para todas as linguagens

Escolhe a tua linguagem favorita e começa em segundos

npm install @atura/node

Pronto para simplificar?

Mostra interesse na API de faturação feita para developers portugueses.