Vero Box · API para software houses

Os teus clientes facturam no teu software.
O Vero certifica.

Tens um ERP, um POS ou um software de gestão? Com o Box, as empresas dos teus clientes emitem facturas certificadas pela AGT a partir do teu software, através da API do Vero. Sem certificares o teu software, sem integrares com a AGT.

Criar conta e o meu Box Falar connosco

Já tens conta? Entra e abre Box no menu.

box.sh

# Uma chave por empresa cliente, a mesma API
curl -X POST https://api.vero.ao/v1/organisations/ORG_ID/invoices \
  -H "Authorization: Bearer vero_live_sk_CHAVE_DO_CLIENTE" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "...",
    "documentType": "FR",
    "items": [{ "description": "Serviço", "quantity": 1,
                "unitPrice": 2500000, "taxRate": 14 }]
  }'

Em nome de cada empresa: As facturas saem com os dados do teu cliente
A empresa autoriza: Nada é emitido antes de autorizar o teu Box
O Box paga: As empresas não recebem cobranças

Certificação AGT incluída

O Vero é software de facturação certificado pela AGT (FE/271/AGT/2026). O teu software usa a nossa certificação - não precisas de a pedir.

Uma API, todos os documentos

Facturas, facturas-recibo, recibos, notas de crédito e de débito, pró-formas. Comunicação em tempo real com a AGT, PDF e webhooks.

Em nome de cada cliente

Cada factura sai com o NIF, a série e a chave AGT da empresa do teu cliente. Para a AGT, quem emite é a empresa - não tu.

Como funciona

Crias o teu Box

Na tua conta Vero, abres Box no menu e dás-lhe o nome do teu software.

Juntas as empresas

Basta o NIF e o email. O Vero vai buscar o nome à AGT e cria a conta da empresa, se ainda não tiver.

A empresa autoriza

Recebe um email e autoriza com um clique. Até lá já podes configurar, mas nada é emitido em nome dela.

Emites pela API

Crias a chave de API de cada empresa e o teu software emite com ela. Uma chave por cliente.

Para os teus developers

Uma chamada à API por factura.

O teu software guarda, para cada cliente, o identificador da empresa no Vero e a chave de API dela. Cada venda é um pedido: a factura é assinada, comunicada à AGT e devolvida com o PDF.

Ler o guia técnico do Box

Terminal

curl -X POST https://api.vero.ao/v1/organisations/ORG_ID/invoices \
  -H "Authorization: Bearer vero_live_sk_CHAVE_DO_CLIENTE" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "...",
    "documentType": "FR",
    "items": [{ "description": "Serviço", "quantity": 1,
                "unitPrice": 2500000, "taxRate": 14 }]
  }'

Confiança

A empresa do teu cliente continua a mandar.

Autoriza antes

Nada é emitido em nome da empresa antes de ela autorizar o teu Box.

Vê tudo

A empresa entra no Vero com o email dela e vê todas as facturas emitidas.

Sai quando quiser

Pode retirar o acesso a qualquer momento. As chaves de API que criaste para ela são revogadas.

Preço

O preço do Vero, por empresa.

· Pagas por cada empresa activa (já autorizada). As empresas não pagam e não recebem cobranças.
· Todas as empresas do Box ficam pagas até à mesma data; uma empresa nova entra no período já pago.
· Pagas por referência ou Multicaixa Express e recebes uma factura-recibo por cada pagamento.
· Avisamos-te 7 dias antes do fim do período. Os documentos emitidos continuam sempre válidos.
· Cobras aos teus clientes o que quiseres - isso é contigo.

Mensal

6 000 Kz

por empresa / mês

Anual

72 000 Kz

por empresa / ano

Perguntas frequentes

Preciso de certificar o meu software na AGT?+

Não. O software certificado é o Vero. O teu software envia os dados pela API e o Vero emite, assina e comunica à AGT.

As facturas saem em nome de quem?+

Sempre em nome da empresa do teu cliente: o NIF dela, as séries dela e a chave AGT dela. O teu nome não aparece no documento.

De onde vem a chave AGT da empresa?+

A AGT atribui-a a cada empresa, no Portal do Contribuinte, quando adere à Facturação Electrónica. Registas a chave privada da empresa no Vero, dentro do Box.

E se o cliente deixar de trabalhar comigo?+

A empresa retira o acesso (ou removes tu do Box). A partir daí deixa de contar no teu pagamento e as chaves de API que criaste para ela deixam de funcionar. A conta e as facturas continuam dela.

E se eu não pagar o Box?+

As empresas do Box deixam de poder emitir documentos novos até ao pagamento. Os documentos já emitidos continuam válidos. Avisamos-te 7 dias antes.

A empresa já usa o Vero. Pode entrar no meu Box?+

Sim. Juntas pelo NIF e ela recebe o pedido de autorização. Depois de autorizar, passa a ser paga pelo teu Box.

Põe os teus clientes a facturar certo esta semana.

Criar o meu Box Falar connosco

Os teus clientes facturam no teu software.O Vero certifica.