Facture a partir de qualquer sistema

O que pode fazer

• Emitir facturas, facturas-recibo, pró-formas e notas de crédito
• Obter o PDF de cada documento e enviá-lo por email
• Registar pagamentos e anular documentos
• Clientes criados automaticamente a partir do NIF
• Produtos, stock e movimentos de stock
• Orçamentos, fornecedores, relatórios de vendas e de IVA, SAF-T (AO)

Como funciona

• Cada empresa cria as suas chaves em Definições › Integrações, com as permissões que escolher
• Chaves de teste emitem documentos de formação, sem valor fiscal, para experimentar à vontade
• O cabeçalho Idempotency-Key evita documentos duplicados quando um pedido é repetido
• Erros com código estável e mensagem em português
• Até 120 pedidos por minuto por chave

Exemplo: emitir uma factura-recibo

curl https://api.prisma-erp.ao/v1/documents \
  -H "Authorization: Bearer prisma_live_..." \
  -H "Idempotency-Key: ENC-10045" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "FR",
    "paymentMethod": "MULTICAIXA",
    "client": { "nif": "5000123456", "name": "Loja Kianda, Lda" },
    "items": [ { "productCode": "VEST-001", "quantity": 2 } ]
  }'

Webhooks

• Aviso no seu sistema quando um documento é emitido, pago ou anulado
• Estado da facturação electrónica: aceite, validado, rejeitado ou invalidado pela AGT
• Cada aviso assinado (HMAC) para confirmar que vem do PRISMA ERP
• Repetições automáticas se o seu servidor não responder

Perguntas frequentes

A API tem custo adicional?

Não. A API está incluída em todos os planos do PRISMA ERP.

Posso testar sem emitir documentos reais?

Sim. Crie uma chave de teste: os documentos emitidos com ela são de formação, sem valor fiscal, e não são comunicados à AGT.

Onde está a documentação?

A documentação completa, com todos os endereços, campos e exemplos, está em api.prisma-erp.ao/docs.