Integração contabilística Finvora ERP

A integração contabilística Finvora ERP liga o Bizaldo POS diretamente ao Finvora ERP. Concebida para operações modernas de restauração e retalho com múltiplas filiais, sincroniza automaticamente os relatórios Z de fecho diário e as liquidações de crédito a clientes (Compre Agora, Pague Depois / BNPL) como lançamentos equilibrados em partidas dobradas, sem necessidade de sincronização complexa de catálogos ou ementas.
Disponibilidade: A integração contabilística Finvora é configurada por empresa no Portal de Administração em Empresas → Integrações e é executada automaticamente em segundo plano durante as sessões de fecho de dia no POS e os registos de pagamento de crédito a clientes.

Como funciona

Criação de chave de API no Finvora ERP

O administrador cria uma chave de API de integração no Finvora ERP em Definições → Chaves de API com identificação de auditoria.

Configuração de credenciais no Bizaldo Admin

As credenciais da empresa (URL base e chave de API) são registadas e validadas em tempo real no Bizaldo Admin em Empresas → Integrações.

Abertura de turno e fundo de caixa no POS

O operador de caixa abre a caixa no tablet POS, verificando o ID do terminal e registando o fundo de caixa inicial em SAR.

Vendas contínuas e múltiplos métodos de pagamento

Os pedidos são processados normalmente com dinheiro, cartão ou crédito a clientes (BNPL). A faturação, o IVA (15%) e as contas a receber acumulam-se com precisão.

Fecho de turno e relatório provisório

No final do dia, o operador inicia o Fecho de dia, bloqueando novas encomendas, gerando relatórios provisórios e finalizando a contagem física.

Relatório Z automático e sincronização com o Razão Geral

O Bizaldo sela a sessão (ex.: ZR-000044) e regista de forma síncrona 4 lançamentos em partidas dobradas (Saída de caixa, Vendas, Reembolso, Liquidação) no Finvora ERP.

Liquidação de prestações BNPL e reconciliação

Quando os clientes liquidam saldos devedores no Bizaldo Admin, cada pagamento gera automaticamente um lançamento de liquidação (ex.: JE-2026-000005) no Finvora, saldando as contas a receber.

1. Geração de chave de API no Finvora ERP

Antes de configurar o Bizaldo Admin, crie uma chave de API segura nas definições da sua organização no Finvora ERP.

Passo 1.1: Navegar para Chaves de API no Finvora ERP

Inicie sessão no Finvora ERP, selecione a sua empresa no topo, abra Definições no painel de navegação esquerdo, mude para o separador Chaves de API e clique em + Gerar Nova Chave.
Separador de definições e chaves de API do Finvora ERP1234

Figura 1 — Finvora ERP: Navegue até Definições e ao separador de gestão de chaves de API

Elementos do Ecrã

1
Navegação para Definições

Abra Definições no menu lateral esquerdo para aceder às preferências da organização.

2
Separador Chaves de API

Selecione o separador Chaves de API na barra superior para gerir integrações externas.

3
Gerar Nova Chave

Clique em '+ Gerar Nova Chave' para abrir o diálogo de criação de credenciais.

4
URL base da API pública

Consulte o URL de endpoint público da sua instância Finvora na parte inferior.

Passo 1.2: Nomear a chave de API

Na janela modal, insira um nome descritivo (como Bizaldo) para que as transações criadas por esta chave sejam facilmente identificáveis nas pistas de auditoria do razão, e depois clique em Gerar Chave.
Diálogo de geração de chave de API no Finvora ERP12

Figura 2 — Finvora ERP: Introduza um nome descritivo para a integração com o Bizaldo

Elementos do Ecrã

1
Nome da chave

Introduza um identificador descritivo (ex.: 'Bizaldo') que surgirá nos registos de auditoria e lançamentos.

2
Botão Gerar Chave

Clique em 'Gerar Chave' para criar o segredo criptográfico da API.

Passo 1.3: Copiar chave secreta e endpoint

Copie de imediato a chave de API apresentada (`ak_...`). Por segurança, o Finvora nunca mais voltará a mostrar este token secreto. Anote também o URL base da API pública da sua organização (ex.: `https://.../api/public/v1`).
Janela com chave de API gerada no Finvora ERP123

Figura 3 — Finvora ERP: Copie a chave de API gerada antes de fechar a janela

Elementos do Ecrã

1
Token de chave secreta

Clique no ícone de cópia junto ao token secreto da chave de API (prefixo 'ak_').

2
URL base pública

Copie o URL base da API pública apresentado na barra de endpoint para a configuração do Bizaldo.

3
Botão Concluído

Clique em 'Concluído' depois de guardar o token em segurança no seu gestor de credenciais.

[!IMPORTANT]

Guarde a sua chave de API do Finvora em segurança. No Bizaldo, as credenciais são encriptadas em repouso com AES-256.

2. Configuração no Bizaldo Admin

Após obter a chave de API no Finvora, associe-a à sua empresa no Bizaldo Admin.

Passo 2.1: Abrir o separador Integrações

No Bizaldo Admin, aceda a Empresas, selecione a sua empresa, abra o separador Integrações e localize o cartão Finvora.
Separador de integrações da empresa no Bizaldo Admin12

Figura 4 — Bizaldo Admin: Cartão de integração Finvora em Empresas → Integrações

Elementos do Ecrã

1
Menu Empresas

Aceda a Empresas no menu lateral do Bizaldo Admin.

2
Cartão Finvora

Cartão de integração que indica o estado da ligação ao Finvora ERP.

Passo 2.2: Introduzir credenciais e mapear filiais

Insira o URL base da API pública, cole a chave de API Finvora (`ak_...`), configure o mapeamento de filiais e clique em Guardar alterações para validar a ligação.
Diálogo de configuração do Finvora no Bizaldo Admin123456

Figura 5 — Bizaldo Admin: Janela de credenciais da API Finvora e mapeamento de filiais

Elementos do Ecrã

1
Campo URL da API

Cole o URL base da API pública do Finvora (ex.: https://api.finvora.com/api/public/v1).

2
Campo Chave de API

Cole a chave secreta de API ('ak_...') gerada no Finvora ERP.

3
Mapeamento de filiais

Associe cada filial do Bizaldo ao respetivo centro de custos ou divisão no Finvora.

4
Mapeamento de contas

Verifique os códigos de conta do razão para caixa, bancos, clientes e IVA.

5
Ativar integração

Ative o comutador para permitir a sincronização automática dos fechos de caixa.

6
Guardar alterações

Clique para testar as credenciais contra a API do Finvora e guardar as definições.

[!NOTE]

O Bizaldo valida as credenciais executando um teste de ligação imediato com o Finvora. Assim que validado, o cartão apresenta o estado 'Ligado'.

3. Fluxo de trabalho no tablet POS

Os operadores de caixa utilizam o tablet POS com normalidade. A integração regista as operações financeiras de forma transparente.

Passo 3.1: Abertura de dia e fundo de caixa

Ao abrir o terminal POS, o operador de caixa deve iniciar o dia e registar o fundo de caixa físico.
Ecrã de abertura de caixa no tablet POS1

Figura 6 — Tablet POS: Ecrã de início de dia com identificador do terminal e moeda

Elementos do Ecrã

1
Botão Iniciar Dia

Clique em 'Iniciar Dia' para abrir a janela de contagem de fundo de caixa.

Janela de fundo de caixa no tablet POS12

Figura 7 — Tablet POS: Entrada do fundo de caixa inicial de abertura em SAR

Elementos do Ecrã

1
Moeda

Confirma a moeda de funcionamento (SAR) para a sessão de caixa.

2
Confirmar fundo

Clique em Confirmar para abrir o registo e começar a registar pedidos.

Assim que o fundo de caixa é confirmado, o registo fica aberto e preparado para vendas durante todo o turno.

Passo 3.2: Registo de vendas contínuas

Durante o dia, os operadores cobram pedidos através de vários métodos de pagamento: cartão, dinheiro ou crédito a clientes (BNPL).
Ecrã de catálogo e carrinho no tablet POS1

Figura 8 — Tablet POS: Catálogo de artigos e botões de pagamento com cartão, dinheiro e BNPL

Elementos do Ecrã

1
Artigos no carrinho e valor total

Carrinho ativo (Gourmet Burger, total 45.50 SAR com IVA) pronto para finalização.

Processamento de pedido com cartão

Ao pagar com cartão (como no Pedido 2, Sprite a 101.50 SAR), premir Cartão abre o diálogo de confirmação de pagamento eletrónico.
Diálogo de confirmação de pagamento com cartão no tablet POS123

Figura 10 — Tablet POS: Diálogo de confirmação de pagamento eletrónico com cartão

Elementos do Ecrã

1
Detalhes do pedido

Resumo detalhado do pedido (ex.: Sprite 101.50 SAR) processado através de cartão.

2
Confirmação de pagamento com cartão

Mensagem de confirmação: 'Pretende concluir este pedido com Cartão?'.

3
Confirmar

Confirma a transação.

Processamento de pedido em dinheiro

Ao selecionar Dinheiro, abre-se o diálogo de confirmação com opções para concluir instantaneamente ou confirmar e imprimir recibo.
Diálogo de confirmação de pagamento em dinheiro no tablet POS123

Figura 9 — Tablet POS: Diálogo de pagamento em dinheiro com opções de impressão de recibo

Elementos do Ecrã

1
Mensagem de pagamento em dinheiro

Pergunta ao operador: 'Pretende concluir este pedido com Dinheiro?'.

2
Concluir Instantaneamente

Conclui a transação em dinheiro de imediato sem imprimir recibo.

3
Confirmar e Imprimir Recibo

Finaliza o pagamento, regista a entrada de dinheiro e imprime o recibo de compra.

Processamento de pedido a crédito (BNPL)

Para vendas a crédito (Pedido 3), premir BNPL solicita a associação da conta de cliente (ex.: `customer-test`), o registo de eventual entrada inicial (ex.: `10.00 SAR` por cartão) e o lançamento do remanescente (`35.50 SAR`) em contas a receber.
Diálogo de pedido a crédito BNPL no tablet POS1234

Figura 11 — Tablet POS: Concluir pedido com crédito a cliente (BNPL) e entrada parcial

Elementos do Ecrã

1
Introduzir dados do cliente

Insira ou selecione a conta de cliente registada (ex.: customer-test, 091381093132) para associar ao pedido.

2
Clicar em Concluir Instantaneamente

Clique em Concluir Instantaneamente para finalizar o registo sem aguardar impressão.

3
Selecionar método de pagamento

Selecione o método de pagamento (cartão ou dinheiro) para o valor da entrada inicial.

4
Clicar em Confirmar

Clique em Confirmar para finalizar o pedido e lançar o saldo restante em contas a receber de clientes.

Passo 3.3: Histórico de pedidos e auditoria do turno

O ecrã de Pedidos no POS apresenta todas as operações efetuadas durante o turno com os respetivos selos: `[Synced] [Completed]` para dinheiro e cartão, e `[Synced] [BNPL] [Completed]` para crédito. Toque num pedido para abrir o ecrã de detalhes.
Histórico de pedidos no tablet POS com selos de pagamento1

Figura 12 — Tablet POS: Histórico de pedidos exibindo vendas em dinheiro, cartão e BNPL

Elementos do Ecrã

1
Selecionar pedido para ver detalhes

Selecione um pedido (como o pedido de cartão #...5453583 com selo [Synced] [Completed]) para abrir os detalhes e auditar ou gerir a transação.

Passo 3.4: Vista detalhada de pedido individual

Ao tocar num pedido abre-se a discriminação de artigos, o resumo de impostos e a confirmação de pagamento, com a opção de cancelar o pedido diretamente a partir deste ecrã.
Detalhe de pedido individual no tablet POS1

Figura 13 — Tablet POS: Detalhe do pedido com método de pagamento e resumo de IVA

Elementos do Ecrã

1
Cancelar pedido e resumo financeiro

Consulte o resumo financeiro (Subtotal 95.75 SAR, IVA 5.75 SAR, Total 101.50 SAR) e toque em Cancelar pedido para anular esta venda diretamente a partir do ecrã de detalhes.


4. Fecho de turno e emissão automática de relatório Z

No encerramento do serviço, os operadores executam o Fecho de dia para selar o turno do ponto de vista contabilístico.

Passo 4.1: Preparar fecho e relatório provisório

Em Definições → Fecho de dia, premir Gerar relatório provisório bloqueia de imediato novos pedidos e calcula os valores preliminares de receitas, impostos e dinheiro.
Passo de preparação de fecho de dia no tablet POS1

Figura 14 — Tablet POS: Preparar fecho de turno e gerar relatório de reconciliação provisório

Elementos do Ecrã

1
Gerar relatório provisório

Toque para bloquear novas vendas e calcular os totais provisórios de auditoria.

Passo 4.2: Confirmar fecho do turno

Os operadores analisam os totais provisórios, confirmam a contagem de gaveta e clicam em Fechar dia. Isto sela a sessão, cria o relatório Z inalterável `ZR-000044` e envia os lançamentos para o Finvora ERP.
Confirmação de fecho de dia no tablet POS1

Figura 15 — Tablet POS: Revisão do relatório provisório e fecho do turno com Fechar dia

Elementos do Ecrã

1
Botão Fechar dia

Clique no botão Fechar dia para encerrar a jornada e gerar os lançamentos contabilísticos associados a todos os pedidos efetuados ao longo do dia.


5. Relatórios POS e auditoria de relatórios Z no Bizaldo Admin

Auditores e responsáveis financeiros podem auditar as reconciliações de turno no Bizaldo Admin em Relatórios POS → Relatórios Z (Sessões).

Passo 5.1: Tabela de sessões de relatórios Z

A tabela de relatórios Z oferece verificação visual imediata da sincronização com o ERP para cada sessão de caixa.
Tabela de relatórios Z no Bizaldo Admin1

Figura 16 — Bizaldo Admin: Tabela de relatórios Z com o selo Sincronizado com Finvora (4)

Elementos do Ecrã

1
Selo Sincronizado com Finvora (4)

Selo verde que confirma a publicação bem-sucedida dos 4 lançamentos no razão.

Passo 5.2: Painel lateral de auditoria do relatório Z

Ao abrir o relatório `ZR-000044`, são apresentados os 4 lançamentos de diário associados e registados no Finvora ERP.
Painel lateral de relatório Z no Bizaldo Admin12

Figura 17 — Bizaldo Admin: Discriminação do relatório Z mostrando os 4 lançamentos associados

Elementos do Ecrã

1
Cabeçalho do relatório Z

Identificador único e imutável do fecho de turno (#ZR-000044).

2
Lançamentos de diário associados

Quatro lançamentos diretos: Saída de caixa (JE-...01), Vendas (JE-...02), Reembolso (JE-...03), Liquidação (JE-...04).

Lançamentos de diário gerados para o relatório Z:

  • Redução de dinheiro na gaveta (Saída de caixa: JE-2026-000001): Regista transferências de numerário para o cofre.
  • Faturação e receitas diárias (Vendas: JE-2026-000002): Debita Caixa e Bancos; credita Vendas e IVA liquidado.
  • Devoluções e reembolsos a clientes (Reembolso: JE-2026-000003): Regista devoluções de artigos e estorno de impostos.
  • Fecho de lote de cartões bancários (Liquidação: JE-2026-000004): Reconcilia as autorizações de TPA com a conta bancária da empresa.

6. Verificação no Razão Geral do Finvora ERP (Relatórios Z)

No Finvora ERP em Contabilidade → Lançamentos de Diário, os quatro movimentos da sessão `ZR-000044` ficam logo visíveis no estado Publicado com perfeito equilíbrio de partidas dobradas.
Painel de lançamentos de diário no Finvora ERP1234

Figura 18 — Finvora ERP: Os quatro lançamentos publicados resultantes do relatório Z ZR-000044 do Bizaldo

Elementos do Ecrã

1
Lançamentos do relatório Z

Quatro movimentos com referências externas BIZ para liquidação, reembolsos, vendas e saída de caixa.

2
Resumo de lançamentos publicados

Contadores que mostram um total de 10 lançamentos publicados no Razão Geral.

3
Débito e crédito equilibrados

Verificação estrita de saldo: Total de débito igual ao total de crédito em cada movimento.

4
Estado Publicado

Estado finalizado que atesta que os lançamentos estão registados permanentemente no razão.


7. Sincronização de liquidação de crédito a cliente (BNPL)

Quando os clientes pagam os seus saldos de crédito no Bizaldo Admin, cada pagamento é lançado automaticamente como movimento de liquidação equilibrado no Finvora ERP.

Passo 7.1: Diretório de clientes

No Bizaldo Admin, aceda a Clientes e localize a ficha do cliente (ex.: `customer-test`). Clique em Ver para aceder ao seu perfil.
Diretório de clientes no Bizaldo Admin12

Figura 19 — Bizaldo Admin: Diretório de clientes apresentando o cartão de perfil de customer-test

Elementos do Ecrã

1
Cartão de perfil de cliente

Ficha do cliente customer-test (Telefone: 091381093132, Total gasto: 45.50 SAR).

2
Botão Ver perfil

Clique em 'Ver' para abrir o perfil do cliente e consultar o histórico de crédito.

Passo 7.2: Saldo devedor do cliente

Mude para o separador Saldo devedor para consultar encomendas BNPL em aberto, a dívida total (`35.50 SAR`) e as opções de amortização.
Separador de saldo devedor do cliente no Bizaldo Admin1234

Figura 20 — Bizaldo Admin: Conta corrente do cliente exibindo a encomenda BNPL por liquidar

Elementos do Ecrã

1
Separador Saldo devedor

Separador dedicado ao acompanhamento de compras com pagamento a prestações (BNPL).

2
Métricas de saldo

Total em dívida 35.50 SAR, Total pago 0.00 SAR, Encomendas em aberto 1.

3
Linha da encomenda por pagar

Encomenda #...5497588 com Valor inicial 35.50 SAR, Pago 0.00 SAR, Remanescente 35.50 SAR.

4
Botão Registar pagamento

Clique em 'Registar pagamento' para lançar uma amortização ou liquidação.

Passo 7.3: Registar amortização de prestação

Clique em Registar pagamento, introduza o valor amortizado (ex.: `20.00 SAR`), escolha o método de pagamento (Transferência bancária) e clique em Registar pagamento.
Diálogo Registar pagamento no Bizaldo Admin1234

Figura 21 — Bizaldo Admin: Registo de pagamento de 20.00 SAR por transferência bancária

Elementos do Ecrã

1
Valor da prestação

Introduza o valor liquidado pelo cliente (ex.: 20.00 SAR).

2
Método de pagamento

Selecione Transferência bancária (ou Dinheiro) para determinar a conta de tesouraria a debitar.

3
Referência e observações

Referência bancária externa opcional e notas de liquidação.

4
Botão Registar pagamento

Clique em 'Registar pagamento' para validar o recebimento e disparar o lançamento no Finvora.

Passo 7.4: Saldo atualizado e lançamento associado

O saldo devedor do cliente baixa de imediato para `15.50 SAR`. No histórico de pagamentos, o registo exibe o lançamento do Finvora associado: JE-2026-000005.
Conta corrente do cliente com lançamento associado no Bizaldo Admin123

Figura 22 — Bizaldo Admin: Saldo devedor reduzido com documento Finvora associado JE-2026-000005

Elementos do Ecrã

1
Métricas de saldo atualizadas

O Total em dívida desce para 15.50 SAR; o Total pago sobe para 20.00 SAR.

2
Estado de encomenda parcial

O estado da encomenda passa a Parcial com um montante remanescente de 15.50 SAR.

3
Etiqueta do documento associado

O histórico regista a Transferência bancária com a etiqueta verde do Finvora: JE-2026-000005.


8. Lançamento contabilístico de liquidação BNPL no Finvora ERP

Consulte o movimento de liquidação no Finvora ERP em Contabilidade → Lançamentos de Diário → JE-2026-000005.
Detalhe do lançamento de liquidação BNPL no Finvora ERP1234

Figura 23 — Finvora ERP: Movimento de liquidação JE-2026-000005 com linhas em partidas dobradas

Elementos do Ecrã

1
Cabeçalho do lançamento

Documento JE-2026-000005 no estado Publicado com data de 04/11/2026.

2
Descrição e referência

Descrição: Bizaldo POS (Main) — BNPL Credit Payment, Ref: CR-PMT-644CE5FD-050C-44.

3
Linhas em partidas dobradas

Débito: Conta 1020 (Conta bancária, 19.59 AED) | Crédito: Conta 1050 (Clientes a receber, 19.59 AED).

4
Equilíbrio contabilístico perfeito

Verificação rigorosa: Total a débito (19.59 AED) = Total a crédito (19.59 AED).

Fórmula contabilística de liquidação:

  • Débito: Conta 1020 (Conta bancária) — 19.59 AED (20.00 SAR convertidos à taxa de câmbio diária)
  • Crédito: Conta 1050 (Clientes a receber) — 19.59 AED (regularização do ativo de crédito a clientes)

9. Mapeamento padrão do plano de contas

O Bizaldo POS afeta os valores das transações a contas standard do plano contabilístico do Finvora:
Código de contaNome da contaTipoSentido do lançamentoDescrição
1010Caixa e valores em caixaAtivoDébito (+)Total de dinheiro físico recebido durante o turno de caixa.
1020Compensação de cartões bancáriosAtivoDébito (+)Recibos e faturas pagos por cartão de crédito/débito.
1050Clientes a receber (BNPL)AtivoDébito na venda / Crédito no pagamentoVendas a crédito pendentes; regularizadas na liquidação das prestações.
2100IVA a pagar (IVA liquidado)PassivoCrédito (+)IVA liquidado cobrado sobre vendas sujeitas a imposto.
4000Proveitos e vendasRendimentoCrédito (+)Receita líquida de vendas excluindo impostos e descontos promocionais.

10. Tolerância a falhas e segurança contabilística

A integração foi concebida com elevada resiliência empresarial para salvaguardar a continuidade do negócio:
  • Garantias estritas de idempotência: Cada pedido de sincronização de relatório Z inclui uma referência externa imutável (ex.: EXT-Z-{zReportId} ou BIZ-Z-{zReportId}). Se houver repetição de pedidos por falha de rede, o Finvora deteta a entrada e devolve o registo sem duplicar movimentos.
  • Verificação estrita de partidas dobradas: Antes de emitir qualquer documento, o Finvora impõe a regra: Total a débito == Total a crédito com tolerância de 0.01. Qualquer movimento não equilibrado é rejeitado em segurança.
  • Funcionamento prioritário offline no POS: As operações no terminal POS não dependem de forma síncrona do Finvora. Caso haja corte de Internet ou manutenção no ERP, os operadores continuam a faturar e a fechar turnos com normalidade, ficando os dados em fila de espera para sincronização posterior.
  • Isolamento multi-empresa e chaves encriptadas: As chaves de API são armazenadas no Bizaldo com encriptação AES-256. O Finvora isola cada pedido por identificador de empresa (tenantId), garantindo que nenhuma organização possa consultar ou alterar dados contabilísticos de outra.