Documentação Ryakeza

Introdução

O Ryakeza é um sistema de faturação completo desenvolvido especificamente para o mercado angolano, com suporte nativo para o formato SAF-T AO.

Funcionalidades Principais

Instalação

Siga estes passos para instalar o Ryakeza no seu servidor.

Requisitos do Sistema

Instalação Automática

Para uma instalação rápida, utilize o script de instalação:

# Baixar o instalador
curl -O https://ryakeza.ao/installer.sh

# Executar o instalador
chmod +x installer.sh
./installer.sh

Instalação Manual

Para instalação manual, siga estes passos:

# 1. Extrair os ficheiros
tar -xzf ryakeza-v2.1.3.tar.gz

# 2. Mover para o diretório web
sudo mv ryakeza /var/www/html/

# 3. Configurar permissões
sudo chown -R www-data:www-data /var/www/html/ryakeza
sudo chmod -R 755 /var/www/html/ryakeza/storage

# 4. Criar base de dados MySQL
mysql -u root -p -e "CREATE DATABASE ryakeza;"
mysql -u root -p -e "CREATE USER 'ryakeza_user'@'localhost' IDENTIFIED BY 'senha_segura';"
mysql -u root -p -e "GRANT ALL PRIVILEGES ON ryakeza.* TO 'ryakeza_user'@'localhost';"
mysql -u root -p -e "FLUSH PRIVILEGES;"

Primeiros Passos

Após a instalação, siga este guia para configurar o sistema.

Configuração Inicial

1. Acesse o sistema através do seu navegador: https://seu-dominio.ao/ryakeza
2. Complete o assistente de configuração inicial
3. Configure os dados da sua empresa
4. Adicione os primeiros utilizadores

Configuração de Empresa

Exemplo de configuração via API:

 'Minha Empresa Lda',
    'nif' => '5000123456',
    'endereco' => 'Rua Comercial, 123',
    'municipio' => 'Luanda',
    'telefone' => '+244 222 123 456'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.ryakeza.ao/v1/empresa');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($empresa));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $token
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

const empresa = {
    nome: 'Minha Empresa Lda',
    nif: '5000123456',
    endereco: 'Rua Comercial, 123',
    municipio: 'Luanda',
    telefone: '+244 222 123 456'
};

fetch('https://api.ryakeza.ao/v1/empresa', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${token}`
    },
    body: JSON.stringify(empresa)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Erro:', error));

curl -X POST \
  https://api.ryakeza.ao/v1/empresa \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -d '{
    "nome": "Minha Empresa Lda",
    "nif": "5000123456",
    "endereco": "Rua Comercial, 123",
    "municipio": "Luanda",
    "telefone": "+244 222 123 456"
}'

Autenticação API

A API do Ryakeza utiliza autenticação baseada em tokens JWT.

Obter Token de Acesso

curl -X POST \
  https://api.ryakeza.ao/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "seu-email@empresa.ao",
    "password": "sua-senha"
}'

Resposta

{
    "success": true,
    "data": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "expires_in": 3600,
        "user": {
            "id": 1,
            "name": "João Silva",
            "email": "joao@empresa.ao"
        }
    }
}

Guia de Faturação

Aprenda a criar, editar e gerir faturas no sistema Ryakeza.

Como Criar uma Fatura

Siga estes passos para criar sua primeira fatura:

Passo 2: Dados do Cliente

Passo 3: Adicionar Itens

1. Clique em "Adicionar Item"
2. Pesquise pelo produto/serviço
3. Insira quantidade e preço unitário
4. O sistema calcula automaticamente:
   - Total do item
   - Impostos aplicáveis
   - Descontos configurados

Passo 4: Configurar Pagamento

Passo 5: Revisar e Emitir

Como Editar uma Fatura

Para editar uma fatura já emitida:

1. Vá para Faturas Emitidas
2. Localize a fatura desejada
3. Clique no botão Editar
4. Apenas faturas com estado "Rascunho" podem ser editadas livremente
5. Para faturas já emitidas, crie uma Nota de Crédito

Emissão de Recibos

Os recibos são documentos de recebimento que comprovam o pagamento de uma fatura ou serviço.

Quando Usar Recibos

Diferença entre Fatura e Recibo

Criar Recibo a partir de Fatura

Para criar um recibo quando uma fatura é paga:

1. Acesse a fatura pendente
2. Clique em "Registrar Pagamento"
3. Selecione método de pagamento
4. Insira valor pago
5. Sistema pergunta: "Emitir recibo?"
6. Clique em SIM para gerar recibo automático

SAF-T AO - Exportação Fiscal

O SAF-T (Standard Audit File for Tax) é um formato obrigatório para envio de informações fiscais à AGT.

Periodicidade de Envio

Gerar SAF-T AO no Ryakeza

Siga este passo-a-passo:

1. Preparação
   • Certifique-se que todos os documentos do período estão fechados
   • Verifique se há documentos pendentes de validação
   • Confirme que os dados da empresa estão atualizados
2. Configuração
   • Acesse Relatórios > SAF-T AO
   • Selecione o período fiscal
   • Escolha o tipo de exportação (Normal ou Simplificada)
3. Validação
   • O sistema valida automaticamente todos os dados
   • Corrija eventuais erros indicados
   • Verifique os totais de cada imposto (IVA, IS)
4. Exportação
   • Clique em "Exportar SAF-T"
   • Escolha o formato (XML padrão AGT)
   • O sistema gera o ficheiro com assinatura digital
5. Envio
   • Faça download do ficheiro XML
   • Aceda ao portal da AGT
   • Faça upload do ficheiro
   • Guarde o comprovativo de envio

Validação do Ficheiro SAF-T

Antes do envio, valide seu ficheiro:

# Validar estrutura XML
xmllint --schema SAFT-AO.xsd seu-ficheiro.xml

# Validar assinatura digital
openssl smime -verify -in seu-ficheiro.xml -noverify

# Verificar hash
sha256sum seu-ficheiro.xml

Erros Comuns e Soluções

Configurações do Sistema

Personalize o Ryakeza conforme as necessidades da sua empresa.

Configurações da Empresa

Acesse Sistema > Configurações para configurar:

Configurações de Licença

O sistema possui 4 níveis de licença com diferentes funcionalidades:

Ativar Módulos

Para ativar módulos adicionais:

1. Acesse Configurações > Módulos
2. Selecione o módulo desejado:
   - Contabilidade
   - Tesouraria
   - Inventário
   - RH
   - CRM
3. Clique em "Ativar"
4. O sistema verifica a licença
5. Se autorizado, o módulo fica disponível

Gestão de Utilizadores e Permissões

Controle quem acede ao sistema e o que cada utilizador pode fazer.

Perfis de Utilizador

Como Criar um Novo Utilizador

1. Acesse Cadastros > Utilizadores
2. Clique em Novo Utilizador
3. Preencha:
   • Nome completo
   • Email (será o login)
   • Perfil (Admin, Gestor, Colaborador)
   • Senha temporária
4. O sistema envia email de activação
5. O utilizador define sua senha definitiva

Permissões Granulares

Para controlar permissões específicas:

Módulo: Faturação
  ☑ Criar faturas
  ☑ Editar faturas
  ☐ Anular faturas
  ☑ Ver todas as faturas
  ☐ Exportar faturas

Módulo: Clientes
  ☑ Ver clientes
  ☑ Adicionar clientes
  ☑ Editar clientes
  ☐ Excluir clientes
  ☐ Ver dados sensíveis

Módulo: Relatórios
  ☑ Relatórios de vendas
  ☑ Relatórios de stock
  ☐ Relatórios financeiros
  ☐ Exportar SAF-T

Guia Completo de Faturação

Domine todas as funcionalidades de faturação do Ryakeza.

Criar Fatura - Guia Detalhado

Passo 1: Acesso e Seleção

Passo 2: Dados do Cliente

O sistema oferece várias formas de selecionar clientes:

Passo 3: Edição de Faturas

Faturas podem ser editadas em diferentes estados:

Anular Faturas

Para anular uma fatura já emitida:

1. Localize a fatura: Vá para "Faturas Emitidas"
2. Verifique estado: Só pode anular faturas não pagas
3. Clique em "Anular": Botão vermelho na lista
4. Informe o motivo: Obrigatório para auditoria
5. Confirme: A fatura fica com estado "Anulada"

Notas de Crédito

Use notas de crédito para:

Gestão de Recibos

Diferenças Técnicas

Criar Recibo Manualmente

Para criar um recibo sem faturas associadas:

1. Menu: Faturação & Vendas → Recibos
2. Clique em "Novo Recibo"
3. Selecione o cliente
4. Adicione os itens/serviços
5. Informe método de pagamento
6. Emita o recibo
7. O sistema gera PDF automaticamente

SAF-T AO - Especificações Técnicas

Processo de Geração

Validação Técnica do Ficheiro

Antes do envio, valide o ficheiro SAF-T:

# 1. Validar estrutura XML
xmllint --noout --schema SAFT-AO.xsd seu-ficheiro.xml

# 2. Validar assinatura
openssl smime -verify -in seu-ficheiro.xml -noverify -inform DER

# 3. Verificar hash SHA-256
sha256sum seu-ficheiro.xml

# 4. Validar contra DTD (opcional)
xmllint --valid --noout seu-ficheiro.xml

Erros Comuns e Soluções

Configurações Avançadas

Configurações da Empresa

Baseado no código PHP fornecido, o sistema gerencia:

Sistema de Licenciamento

O Ryakeza possui 4 níveis de licença:

Configurações de Faturação

// Exemplo de configurações disponíveis no sistema
const configuracoesDisponiveis = {
    // Configurações da Empresa
    'empresa.nome': { descricao: 'Nome comercial da empresa', categoria: 'empresa' },
    'empresa.nif': { descricao: 'NIF fiscal da empresa', categoria: 'empresa' },
    'empresa.contabilidade': { descricao: 'Ativar módulo de Contabilidade?', categoria: 'empresa' },
    'empresa.rh': { descricao: 'Ativar módulo de RH?', categoria: 'empresa' },
    
    // Configurações Financeiras
    'financeiro.moeda_padrao': { descricao: 'Moeda padrão (AOA)', categoria: 'financeiro' },
    'financeiro.banco': { descricao: 'Banco padrão', categoria: 'financeiro' },
    'financeiro.iban': { descricao: 'IBAN da empresa', categoria: 'financeiro' },
    
    // Configurações de Faturação
    'faturacao.prefixo_fatura': { descricao: 'Prefixo para faturas (FT)', categoria: 'faturacao' },
    'faturacao.envio_automatico_email': { descricao: 'Enviar email automático?', categoria: 'faturacao' },
    
    // Configurações de Email
    'email.host': { descricao: 'Servidor SMTP', categoria: 'email' },
    'email.porta': { descricao: 'Porta SMTP', categoria: 'email' },
    
    // Configurações SAF-T
    'saft.versao': { descricao: 'Versão do SAF-T', categoria: 'saft' }
};

// Verificação de licença para módulos
class GerenciadorLicencas {
    static modulosComLicenca = [
        'empresa.contabilidade',
        'empresa.tesouraria', 
        'empresa.inventario',
        'empresa.rh',
        'empresa.crm'
    ];
    
    static async validarAcessoModulo(modulo) {
        // Verifica se o módulo requer licença específica
        if (!this.modulosComLicenca.includes(modulo)) {
            return true;
        }
        
        // Consulta API para verificar licença
        const response = await fetch('api/licenca/verificar');
        const data = await response.json();
        
        return data.modulos_permitidos.includes(modulo);
    }
}

Módulos do Ryakeza

O Ryakeza é um sistema modular que permite ativar funcionalidades conforme a licença e necessidades da sua empresa.

1. Acesse: Configurações → Módulos
2. Localize "Contabilidade"
3. Clique em "Ativar"
4. Configure:
   - Plano de contas padrão
   - Contas de resultado
   - Período contabilístico
5. Importe saldos iniciais (se aplicável)

// Quando uma fatura é emitida, gera lançamentos contábeis
public function gerarLancamentosContabeis($fatura_id) {
    $fatura = $this->getFatura($fatura_id);
    
    // Lançamento de débito (Cliente)
    $lancamento1 = [
        'conta_debito_id' => $this->getContaId('Clientes'),
        'conta_credito_id' => $this->getContaId('Vendas'),
        'descricao' => "Fatura {$fatura['numero']} - {$fatura['cliente_nome']}",
        'valor' => $fatura['total_sem_imposto'],
        'documento_id' => $fatura_id
    ];
    
    // Lançamento de IVA
    if ($fatura['iva_valor'] > 0) {
        $lancamento2 = [
            'conta_debito_id' => $this->getContaId('Clientes'),
            'conta_credito_id' => $this->getContaId('IVA a Liquidar'),
            'descricao' => "IVA Fatura {$fatura['numero']}",
            'valor' => $fatura['iva_valor'],
            'documento_id' => $fatura_id
        ];
    }
    
    // Salva os lançamentos
    $this->salvarLancamentos([$lancamento1, $lancamento2]);
}

1. Cliente seleciona produtos
2. Sistema verifica disponibilidade
3. Se stock insuficiente → alerta
4. Se stock suficiente → reserva automática
5. Emissão da fatura
6. Baixa automática do stock
7. Atualização de custos
8. Geração de alertas (se necessário)

// Verificar disponibilidade de stock
async function verificarStock(item_id, quantidade, armazem_id = null) {
    const response = await fetch('/api/v1/inventario/stock', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${token}`
        },
        body: JSON.stringify({
            item_id: item_id,
            quantidade: quantidade,
            armazem_id: armazem_id
        })
    });
    
    const data = await response.json();
    
    if (data.success) {
        return {
            disponivel: data.disponivel,
            stock_atual: data.stock_atual,
            armazens: data.armazens,
            pode_vender: data.disponivel >= quantidade
        };
    }
    
    throw new Error(data.message);
}

// Exemplo de uso
const stockInfo = await verificarStock(123, 10);
if (!stockInfo.pode_vender) {
    alert(`Stock insuficiente. Disponível: ${stockInfo.stock_atual}`);
}

public function calcularSalario($funcionario_id, $mes, $ano) {
    // Obter dados do funcionário
    $funcionario = $this->getFuncionario($funcionario_id);
    $contrato = $this->getContratoAtual($funcionario_id);
    
    // Cálculo base
    $salario_base = $contrato['salario'];
    $dias_trabalhados = $this->getDiasTrabalhados($funcionario_id, $mes, $ano);
    
    // Horas extras
    $horas_extras = $this->getHorasExtras($funcionario_id, $mes, $ano);
    $valor_horas_extras = $horas_extras * ($salario_base / 160) * 1.5;
    
    // Benefícios
    $beneficios = $this->getBeneficios($funcionario_id, $mes, $ano);
    
    // Descontos
    $descontos = $this->calcularDescontos(
        $salario_base + $valor_horas_extras + $beneficios,
        $funcionario['nif']
    );
    
    // Total líquido
    $salario_liquido = ($salario_base + $valor_horas_extras + $beneficios) - $descontos;
    
    return [
        'bruto' => $salario_base,
        'horas_extras' => $valor_horas_extras,
        'beneficios' => $beneficios,
        'descontos' => $descontos,
        'liquido' => $salario_liquido,
        'dias_trabalhados' => $dias_trabalhados
    ];
}

Configurações necessárias:
1. financeiro.banco = "Nome do Banco"
2. financeiro.count = "Número da Conta"
3. financeiro.nome = "Titular da Conta"
4. financeiro.iban = "AO06 0005 0000 1234 5678 9012 3"
5. financeiro.swift = "BICACOLUXXX"
6. Saldo inicial: Definir data de abertura

{
  "event": "transferencia.recebida",
  "data": {
    "banco_origem": "BFA",
    "conta_origem": "123456789",
    "nome_origem": "Cliente Exemplo Lda",
    "conta_destino": "0005000012345678",
    "valor": 150000.00,
    "moeda": "AOA",
    "referencia": "FT202501001",
    "data_operacao": "2025-01-15",
    "descricao": "Pagamento Fatura FT202501001"
  },
  "timestamp": "2025-01-15T10:30:00Z",
  "signature": "sha256=..."
}

// Processamento no Ryakeza
public function processarTransferencia($dados) {
    // 1. Verificar se é fatura
    $fatura = $this->buscarFaturaPorReferencia($dados['referencia']);
    
    if ($fatura) {
        // 2. Registrar pagamento
        $this->registrarPagamentoFatura(
            $fatura['id'],
            $dados['valor'],
            'transferencia',
            $dados['data_operacao']
        );
        
        // 3. Atualizar movimento bancário
        $this->registrarMovimentoBancario(
            $dados['conta_destino'],
            'credito',
            $dados['valor'],
            "Pagamento: {$dados['referencia']}"
        );
        
        // 4. Notificar cliente
        $this->enviarConfirmacaoPagamento($fatura['cliente_email']);
    }
}

1. Lead/Prospecção → Identificação
2. Qualificação → Necessidades definidas
3. Proposta → Orçamento enviado
4. Negociação → Discussão de termos
5. Fecho → Ganho ou Perdido
6. Pós-venda → Implementação

Estados possíveis:
- Novo (0%)
- Em contacto (25%)
- Proposta enviada (50%)
- Negociação (75%)
- Ganho (100%)
- Perdido (0%)

// Criar nova oportunidade
async function criarOportunidade(dados) {
    const response = await fetch('/api/v1/crm/oportunidades', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${token}`
        },
        body: JSON.stringify({
            cliente_id: dados.cliente_id,
            titulo: dados.titulo,
            descricao: dados.descricao,
            valor_estimado: dados.valor,
            estado: 'novo',
            probabilidade: 25,
            data_fecho_esperada: dados.data_fecho,
            responsavel_id: dados.responsavel_id,
            origem: 'website', // website, telefone, indicacao, etc.
            tags: dados.tags || []
        })
    });
    
    const result = await response.json();
    
    if (result.success) {
        // Criar tarefa automática
        await criarTarefa({
            oportunidade_id: result.data.id,
            titulo: 'Contactar cliente',
            descricao: 'Fazer primeiro contacto',
            data_limite: new Date(Date.now() + 24 * 60 * 60 * 1000), // Amanhã
            prioridade: 'alta'
        });
        
        return result.data;
    }
    
    throw new Error(result.message);
}

// Uso
const oportunidade = await criarOportunidade({
    cliente_id: 456,
    titulo: 'Implementação ERP',
    valor: 2500000,
    data_fecho: '2025-03-31'
});

Gestão de Utilizadores e Permissões

Baseado no código sidebar fornecido, o sistema possui 3 níveis de acesso:

Como Criar um Novo Utilizador

1. Acesso

   Apenas administradores podem criar novos utilizadores:

   • Menu: Cadastros → Utilizadores
   • Clique em "Novo Utilizador"
2. Dados Obrigatórios
   • Nome completo: Nome do utilizador
   • Email: Será usado para login
   • Perfil: Admin, Gestor ou Colaborador
   • Empresa: Associar à empresa correta
3. Configuração de Acesso
   • O sistema gera senha temporária
   • Envia email de ativação
   • Utilizador define senha definitiva no primeiro acesso
4. Permissões Específicas
   • Configure permissões por módulo
   • Defina limites de acesso
   • Revise periodicamente

Sistema de Permissões Granulares

{
  "usuario_id": 123,
  "permissões": {
    "faturacao": {
      "criar": true,
      "editar": true,
      "anular": false,
      "exportar": true,
      "ver_todas": true
    },
    "clientes": {
      "ver": true,
      "criar": true,
      "editar": true,
      "excluir": false,
      "ver_sensivel": false
    },
    "relatorios": {
      "vendas": true,
      "financeiro": false,
      "saft": false,
      "exportar": true
    },
    "configuracoes": {
      "empresa": false,
      "sistema": false,
      "backup": false
    }
  }
}

Área do Funcionário

Controle de Presenças

Funcionalidades disponíveis para funcionários:

Folhas de Salário

// Exemplo de consulta de salários via API
async function carregarSalarios() {
    try {
        const response = await fetch(
            '../../database/controlls/funcionarios/api_funcionarios.php?action=salarios',
            {
                method: 'GET',
                headers: {
                    'Authorization': `Bearer ${localStorage.getItem('token')}`
                }
            }
        );
        
        const data = await response.json();
        
        if (data.success) {
            // Processar dados
            data.salarios.forEach(salario => {
                console.log(`Mês: ${salario.mes}/${salario.ano}`);
                console.log(`Líquido: ${salario.salario_liquido}`);
                console.log(`Bruto: ${salario.salario_bruto}`);
                console.log(`Descontos: ${salario.descontos}`);
            });
        }
    } catch (error) {
        console.error('Erro:', error);
    }
}

// Download de recibo
function baixarRecibo(salarioId) {
    window.open(
        `../../database/controlls/funcionarios/api_funcionarios.php?action=baixar_recibo&id=${salarioId}`,
        '_blank'
    );
}

Sistema de Justificativas

Funcionários podem justificar faltas através do portal:

1. Acesso: Menu Justificativas → Nova Justificativa
2. Tipos: Doença, Assuntos Familiares, Outros
3. Anexos: PDF, JPG, PNG (até 5MB)
4. Fluxo:
   • Funcionário envia justificativa
   • Gestor/RH recebe notificação
   • Aprovação/Rejeição com observações
   • Funcionário é notificado do resultado

Portal do Cliente

Acesso do Cliente

Para dar acesso a um cliente ao portal:

1. Cadastro: Certifique-se que o cliente tem email cadastrado
2. Ativar Acesso: Na ficha do cliente, marque "Permitir acesso ao portal"
3. Senha: O sistema gera senha automática e envia por email
4. Primeiro Acesso: Cliente redefine a senha

Funcionalidades do Portal

API para Integração com Pagamentos

// Configurar webhook para receber notificações
{
  "url": "https://suaempresa.ao/api/webhooks/pagamentos",
  "events": [
    "pagamento.recebido",
    "pagamento.confirmado",
    "pagamento.recusado"
  ],
  "secret": "seu_secreto_aqui"
}

// Exemplo de payload recebido
{
  "event": "pagamento.recebido",
  "data": {
    "fatura_id": "FT202501001",
    "cliente_id": 456,
    "valor": 150000.00,
    "metodo": "multicaixa",
    "referencia": "REF123456789",
    "data_pagamento": "2025-01-15 14:30:00"
  },
  "timestamp": "2025-01-15T14:30:00Z",
  "signature": "sha256=..."
}

Resolução de Problemas

Problemas Comuns e Soluções

Logs do Sistema

Localização dos principais ficheiros de log:

Contactar Suporte

Se o problema persistir:

Quando contactar o suporte, forneça:

1. Versão do Ryakeza (v2.1.3)
2. Descrição detalhada do problema
3. Passos para reproduzir
4. Capturas de ecrã (se aplicável)
5. Logs relevantes (remova dados sensíveis)

Histórico de Versões

API - Gestão de Clientes

Integre o Ryakeza com outros sistemas através da API REST.

Listar Clientes

curl -X GET \
  https://seu-dominio.com/api/v1/clientes \
  -H 'Authorization: Bearer SEU_TOKEN_JWT' \
  -H 'Content-Type: application/json'

Criar Cliente

curl -X POST \
  https://seu-dominio.com/api/v1/clientes \
  -H 'Authorization: Bearer SEU_TOKEN_JWT' \
  -H 'Content-Type: application/json' \
  -d '{
    "nome": "Cliente Exemplo Lda",
    "nif": "5000123456",
    "email": "cliente@empresa.ao",
    "telefone": "+244 923 456 789",
    "tipo": "cliente",
    "endereco": "Rua Comercial, 123",
    "cidade": "Luanda"
}'

Atualizar Cliente

curl -X PUT \
  https://seu-dominio.com/api/v1/clientes/123 \
  -H 'Authorization: Bearer SEU_TOKEN_JWT' \
  -H 'Content-Type: application/json' \
  -d '{
    "telefone": "+244 923 999 999",
    "email": "novo-email@empresa.ao"
}'

API - Gestão de Faturas

Crie e gerencie faturas programaticamente através da API.

Criar Fatura via API

const fatura = {
    cliente_id: 456,
    data_emissao: "2024-12-01",
    data_vencimento: "2024-12-31",
    metodo_pagamento: "transferencia",
    itens: [
        {
            item_id: 789,
            descricao: "Serviço de Consultoria",
            quantidade: 10,
            preco_unitario: 15000.00,
            imposto_id: 1
        },
        {
            item_id: 790,
            descricao: "Produto Exemplo",
            quantidade: 2,
            preco_unitario: 25000.00,
            imposto_id: 2
        }
    ],
    observacoes: "Fatura gerada automaticamente via API"
};

fetch('https://seu-dominio.com/api/v1/faturas', {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(fatura)
})
.then(response => response.json())
.then(data => console.log(data));

Emitir Fatura em PDF

# Baixar PDF da fatura
curl -X GET \
  https://seu-dominio.com/api/v1/faturas/789/pdf \
  -H 'Authorization: Bearer SEU_TOKEN_JWT' \
  --output fatura-789.pdf

Enviar Fatura por Email

curl -X POST \
  https://seu-dominio.com/api/v1/faturas/789/enviar-email \
  -H 'Authorization: Bearer SEU_TOKEN_JWT' \
  -H 'Content-Type: application/json' \
  -d '{
    "email_destino": "cliente@empresa.ao",
    "assunto": "Sua Fatura #FT2024120001",
    "mensagem": "Prezado cliente, em anexo sua fatura.",
    "enviar_copia": true,
    "copia_para": "contabilidade@empresa.ao"
}'

Perguntas Frequentes (FAQ)

Changelog